Skema CameraClipPreview

Nest Doorbell (baterai) Nest Doorbell (berkabel)

sdm.devices.traits.CameraClipPreview

Trait ini digunakan untuk perangkat apa pun yang mendukung download pratinjau klip.

Kolom

Tidak ada kolom yang tersedia untuk trait ini.

Perintah

Tidak ada perintah yang tersedia untuk trait ini.

Acara

ClipPreview

Klip video tersedia untuk pratinjau.

Pratinjau klip adalah file video 10 frame dalam format mp4. Anda dapat memilih untuk menampilkan file video mp4, atau melakukan transkode ke format lain (misalnya, gif animasi) untuk menampilkan urutan 10 frame lengkap. Kemampuan klien perangkat harus dipertimbangkan saat memilih metode pratinjau klip.

Peristiwa ini didukung untuk peristiwa berikut:

Jenis	Elemen	Deskripsi
Acara	Acara gerakan dari trait CameraMotion	Gerakan telah terdeteksi oleh kamera.
Acara	Acara orang dari trait CameraPerson	Seseorang telah terdeteksi oleh kamera.
Acara	Acara bel dari trait DoorbellChime	Bel pintu telah ditekan.

Gunakan eventSessionId untuk mengaitkan peristiwa ini dan previewUrl terkait dengan satu atau beberapa peristiwa yang didukung.

Acara ClipPreview

Payload

{
  "eventId" : "563ee5bb-dddc-484a-86ed-66edce06c089",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraClipPreview.ClipPreview" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "previewUrl" : "https://previewUrl/..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Kolom acara ClipPreview

Kolom	Deskripsi	Jenis Data
`eventSessionId`	ID yang diberikan ke peristiwa yang terjadi sebagai bagian dari satu sesi peristiwa terkait. Dapat digunakan untuk menggabungkan peristiwa.	`string` Contoh: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
`previewUrl`	URL tempat untuk melihat pratinjau klip video. Codec video default adalah H264.	`string` Contoh: "https://`previewUrl`/..."

Kolom payload acara

Kolom	Deskripsi	Jenis Data
`eventId`	ID unik peristiwa.	`string` Contoh: "563ee5bb-dddc-484a-86ed-66edce06c089"
`timestamp`	Waktu peristiwa terjadi.	`string` Contoh: "2019-01-01T00:00:01Z"
`resourceUpdate`	Objek yang menjelaskan informasi tentang perubahan resource.	`object`
`userId`	ID unik yang di-obfuscate yang mewakili pengguna.	`string` Contoh: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
`resourceGroup`	Objek yang menunjukkan resource yang mungkin memiliki perubahan serupa dengan peristiwa ini. Resource peristiwa itu sendiri (dari objek `resourceUpdate`) akan selalu ada dalam objek ini.	`object`

Lihat Acara untuk mengetahui informasi selengkapnya tentang berbagai jenis acara dan cara kerjanya.

Melihat pratinjau klip

Untuk melihat pratinjau klip, lakukan panggilan GET ke previewUrl menggunakan token akses OAuth di header Otorisasi HTTP:

Pratinjau

curl -H 'Authorization: Bearer access-token' \
  https://previewUrl/...

Error

Lihat API Error Code Reference untuk mengetahui daftar lengkap kode error API.