Skema CameraClipPreview

Nest Doorbell (baterai) Nest Doorbell (berkabel) 

sdm.devices.traits.CameraClipPreview

Sifat ini dimiliki oleh perangkat apa pun yang mendukung download pratinjau klip.

Kolom

Tidak ada kolom yang tersedia untuk karakteristik ini.

Perintah

Tidak ada perintah yang tersedia untuk karakteristik 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 mentranskodenya 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
Acara Peristiwa Gerakan dari sifat CameraMotion Gerakan telah terdeteksi oleh kamera.
Acara Peristiwa Orang dari karakteristik CameraPerson Seseorang telah terdeteksi oleh kamera.
Acara Peristiwa Bel dari atribut 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" : "b57d00e5-ea8e-4c8d-a130-99b8f2525384",
  "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 peristiwa. string
Contoh: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
previewUrl URL tempat pratinjau klip video akan ditampilkan. Codec video default-nya adalah H264. string
Contoh: "https://previewUrl/..."

Kolom payload peristiwa

Kolom Deskripsi Jenis Data
eventId ID unik untuk peristiwa. string
Contoh: "b57d00e5-ea8e-4c8d-a130-99b8f2525384"
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 update serupa dengan peristiwa ini. Resource peristiwa itu sendiri (dari objek resourceUpdate) akan selalu ada dalam objek ini. object

Lihat Peristiwa untuk mengetahui 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

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