สคีมา CameraEventImage
Nest Cam (เดิม)
sdm.devices.traits.CameraEventImage
ลักษณะนี้เป็นของอุปกรณ์ที่รองรับการสร้างรูปภาพจากเหตุการณ์
ช่อง
ไม่มีฟิลด์สำหรับลักษณะนี้
คำสั่ง
GenerateImage
ระบุ URL ที่จะใช้ดาวน์โหลดรูปภาพจากกล้อง
คำสั่งนี้รองรับเหตุการณ์ต่อไปนี้
ประเภท | องค์ประกอบ | คำอธิบาย |
---|---|---|
กิจกรรม | เหตุการณ์การเคลื่อนไหวของลักษณะ CameraMotion | กล้องตรวจพบการเคลื่อนไหว |
กิจกรรม | เหตุการณ์บุคคลของลักษณะ CameraPerson | กล้องตรวจพบบุคคล |
กิจกรรม | เหตุการณ์เสียงของลักษณะ CameraSound | กล้องตรวจพบเสียง |
กิจกรรม | เหตุการณ์เคมีของลักษณะ DoorbellChime | มีการกดกริ่งประตู |
eventId
จากเหตุการณ์ที่รองรับในคําขอคําสั่งเพื่อรับ URL การดาวน์โหลดสําหรับรูปภาพจากกล้องที่เกี่ยวข้องกับเหตุการณ์นั้น
คำขอและการตอบกลับ GenerateImage
ส่งคำขอ
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.CameraEventImage.GenerateImage
",
"params" : {
"eventId" : "4ydmwYgVf-F6f3bPO1dVBVnfKV..."
}
}
คำตอบ
{ "results" : { "url" : "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...", "token" : "g.0.eventToken" } }
ช่องคำขอ GenerateImage
ช่อง | คำอธิบาย | ประเภทข้อมูล |
---|---|---|
eventId |
รหัสของเหตุการณ์ที่จะขอรูปภาพกล้องที่เกี่ยวข้อง | string เช่น "4ydmwYgVf-F6f3bPO1dVBVnfKV..." |
ช่องคำตอบของ GenerateImage
ช่อง | คำอธิบาย | ประเภทข้อมูล |
---|---|---|
url |
URL ที่จะใช้ดาวน์โหลดรูปภาพจากกล้อง | string เช่น "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1..." |
token |
โทเค็นที่จะใช้ในส่วนหัวการให้สิทธิ์ HTTP เมื่อดาวน์โหลดอิมเมจ | string เช่น "g.0.eventToken" |
ดาวน์โหลดรูปภาพจากกล้อง
เรียกใช้ GET กับ url
จากคําตอบของคําสั่ง GenerateImage
โดยใช้ token
ในส่วนหัวการให้สิทธิ์ HTTP ที่มีการให้สิทธิ์พื้นฐาน เพื่อดาวน์โหลดรูปภาพจากกล้อง
curl -H "Authorization: Basic g.0.eventToken" \
https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...
ใช้พารามิเตอร์การค้นหา width
หรือ height
เพื่อปรับแต่งความละเอียดของ
รูปภาพที่ดาวน์โหลด ต้องระบุพารามิเตอร์เหล่านี้เพียงรายการเดียว พารามิเตอร์อื่นที่มีการปรับขนาด
โดยอัตโนมัติตามสัดส่วนภาพของกล้อง
เช่น หากสัดส่วนภาพของกล้องคือ 4:3 หากต้องการดาวน์โหลดรูปภาพจากกล้องที่มีความละเอียด 480 x 360 ระบุความกว้างหรือความสูงอย่างใดอย่างหนึ่งต่อไปนี้
ความกว้าง
curl -H "Authorization: Basic g.0.eventToken" \
https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?width=480
ส่วนสูง
curl -H "Authorization: Basic g.0.eventToken" \
https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?height=360
มีข้อจำกัดอื่นๆ ใน URL ดาวน์โหลดดังนี้
- หากมีการระบุพารามิเตอร์ทั้งคู่ใน URL ระบบจะใช้
width
และheight
ถูกละเว้น - หากไม่มีพารามิเตอร์ใดใน URL ระบบจะใช้ค่าเริ่มต้นเป็น 480
width
โปรดดู รูปภาพจากกล้อง สำหรับข้อมูลรูปภาพ พร็อพเพอร์ตี้
ข้อผิดพลาด
ระบบอาจแสดงรหัสข้อผิดพลาดต่อไปนี้ซึ่งเกี่ยวข้องกับลักษณะนี้
ข้อความแสดงข้อผิดพลาด | RPC | การแก้ปัญหา |
---|---|---|
รูปภาพจากกล้องไม่พร้อมให้ดาวน์โหลดแล้ว | DEADLINE_EXCEEDED |
รูปภาพกิจกรรมจะหมดอายุใน 30 วินาทีหลังจากเผยแพร่ โปรดดาวน์โหลดรูปภาพก่อนหมดอายุ |
รหัสเหตุการณ์ไม่ได้เป็นของกล้อง | FAILED_PRECONDITION |
ใช้ eventID ที่ถูกต้องซึ่งแสดงผลจากเหตุการณ์จากกล้อง |
ดูข้อมูลอ้างอิงรหัสข้อผิดพลาด API สำหรับ รายการรหัสข้อผิดพลาด API ทั้งหมด