Skema CameraEventImage
Nest Cam (lama)
sdm.devices.traits.CameraEventImage
Ciri ini dimiliki oleh perangkat apa pun yang mendukung pembuatan gambar dari peristiwa.
Kolom
Tidak ada kolom yang tersedia untuk karakteristik ini.
Perintah
GenerateImage
Memberikan URL untuk mendownload gambar kamera.
Perintah ini mendukung 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 Suara dari karakteristik CameraSound | Suara telah terdeteksi oleh kamera. |
Acara | Peristiwa Bel dari atribut DoorbellChime | Bel pintu telah ditekan. |
eventId
dari peristiwa yang didukung dalam permintaan perintah untuk menerima URL download gambar kamera yang terkait dengan peristiwa tersebut.
Permintaan dan respons GenerateImage
Permintaan
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.CameraEventImage.GenerateImage
",
"params" : {
"eventId" : "G3bcBgWL_M1vso939z5WqrcOE5..."
}
}
Respons
{ "results" : { "url" : "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...", "token" : "g.0.eventToken" } }
Kolom permintaan GenerateImage
Kolom | Deskripsi | Jenis Data |
---|---|---|
eventId |
ID peristiwa yang akan meminta gambar kamera terkait. | string Contoh: "G3bcBgWL_M1vso939z5WqrcOE5..." |
Kolom respons GenerateImage
Kolom | Deskripsi | Jenis Data |
---|---|---|
url |
URL tempat gambar kamera didownload. | string Contoh: "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1..." |
token |
Token yang akan digunakan di header Otorisasi HTTP saat mendownload gambar. | string Contoh: "g.0.eventToken" |
Mendownload gambar kamera
Lakukan panggilan GET ke url
dari
respons perintah GenerateImage
, menggunakan
token
di header Otorisasi HTTP dengan otorisasi Dasar, untuk mendownload
gambar kamera:
curl -H "Authorization: Basic g.0.eventToken" \
https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...
Gunakan parameter kueri width
atau height
untuk menyesuaikan resolusi gambar yang didownload. Hanya salah satu parameter ini yang perlu ditentukan. Parameter lainnya diskalakan
secara otomatis sesuai dengan rasio aspek kamera.
Misalnya, jika rasio aspek kamera adalah 4:3, untuk mendownload gambar kamera dengan resolusi 480x360, tentukan lebar atau tingginya:
Lebar
curl -H "Authorization: Basic g.0.eventToken" \
https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?width=480
Tinggi
curl -H "Authorization: Basic g.0.eventToken" \
https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?height=360
Batasan lain untuk URL download berlaku:
- Jika kedua parameter diberikan di URL,
width
akan digunakan danheight
akan diabaikan. - Jika tidak ada parameter yang diberikan di URL, nilai default 480 akan dipilih untuk
width
.
Lihat sifat CameraImage untuk mengetahui informasi tentang properti gambar.
Error
Kode error berikut dapat ditampilkan sehubungan dengan karakteristik ini:
Pesan Error | PPK | Pemecahan masalah |
---|---|---|
Gambar kamera tidak lagi tersedia untuk didownload. | DEADLINE_EXCEEDED |
Masa berlaku gambar acara berakhir 30 detik setelah acara dipublikasikan. Pastikan untuk mendownload gambar sebelum masa berlakunya habis. |
ID peristiwa bukan milik kamera. | FAILED_PRECONDITION |
Gunakan eventID yang benar yang ditampilkan oleh peristiwa kamera. |
Lihat Referensi Kode Error API untuk mengetahui daftar lengkap kode error API.