Skema CameraClipPreview

Nest Doorbell (baterai) Nest Doorbell (berkabel) 

sdm.devices.traits.CameraClipPreview

Trait ini milik perangkat apa pun yang mendukung download pratinjau klip.

Kolom

Tidak ada kolom yang tersedia untuk karakteristik 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 transcoding ke format lain (misalnya, gif animasi) untuk menampilkan urutan 10 frame yang lengkap. Kemampuan klien perangkat harus dipertimbangkan saat memilih metode pratinjau klip.

Peristiwa ini didukung untuk peristiwa berikut:

Jenis Elemen Deskripsi
Event Peristiwa Motion dari karakteristik CameraMotion Gerakan telah terdeteksi oleh kamera.
Event Peristiwa Person dari karakteristik CameraPerson Seseorang telah terdeteksi oleh kamera.
Event Peristiwa Chime pada karakteristik DoorbellChime Bel pintu telah ditekan.
Gunakan eventSessionId untuk mengaitkan peristiwa ini dan previewUrl terkait dengan satu atau beberapa peristiwa yang didukung.

Peristiwa ClipPreview

Payload

{
  "eventId" : "54e55063-25e6-44a5-9aa7-704405bb1c91",
  "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 peristiwa ClipPreview

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

Kolom payload peristiwa

Kolom Deskripsi Jenis Data
eventId ID unik untuk peristiwa. string
Contoh: "54e55063-25e6-44a5-9aa7-704405bb1c91"
timestamp Waktu saat peristiwa terjadi. string
Contoh: "2019-01-01T00:00:01Z"
resourceUpdate Objek yang menjelaskan informasi tentang update resource. object
userId ID unik yang di-obfuscate yang mewakili pengguna. string
Contoh: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
resourceGroup Objek yang menunjukkan resource yang mungkin memiliki pembaruan serupa dengan peristiwa ini. Resource peristiwa itu sendiri (dari objek resourceUpdate) akan selalu ada dalam objek ini. object

Lihat Peristiwa untuk informasi selengkapnya tentang berbagai jenis peristiwa 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

Baca Referensi Kode Error API untuk mengetahui daftar lengkap kode error API.