Skema CameraClipPreview

Nest Doorbell (baterai) Nest Doorbell (berkabel) 

sdm.devices.traits.CameraClipPreview

Sifat 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 berisi 10 frame dalam format mp4. Anda dapat memilih untuk menampilkan file video mp4, atau melakukan transcoding ke format lain (misalnya, gif animasi) untuk menampilkan 10 rangkaian frame yang lengkap. Kemampuan klien perangkat harus dipertimbangkan saat memilih metode pratinjau klip.

Peristiwa ini didukung untuk peristiwa berikut:

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

Peristiwa ClipPreview

Payload

{
  "eventId" : "1049fe69-8e1d-4381-ad42-c7f32a90d1af",
  "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 yang terkait. Dapat digunakan untuk menggabungkan peristiwa. 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: "1049fe69-8e1d-4381-ad42-c7f32a90d1af"
timestamp Waktu terjadinya peristiwa. string
Contoh: "2019-01-01T00:00:01Z"
resourceUpdate Objek yang memerinci 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-jenis peristiwa dan cara kerjanya.

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 Referensi Kode Error API untuk daftar lengkap kode error API.