สคีมา CameraEventImage

Nest Cam (เดิม) Nest Hub Max Nest Doorbell (เดิม) 

sdm.devices.traits.CameraEventImage

ลักษณะนี้เป็นของอุปกรณ์ที่รองรับการสร้างรูปภาพจากเหตุการณ์

ช่อง

ไม่มีฟิลด์สำหรับลักษณะนี้

คำสั่ง

GenerateImage

ระบุ URL ที่จะใช้ดาวน์โหลดรูปภาพจากกล้อง

คำสั่งนี้รองรับเหตุการณ์ต่อไปนี้

ประเภท องค์ประกอบ คำอธิบาย
กิจกรรม เหตุการณ์การเคลื่อนไหวของลักษณะ CameraMotion กล้องตรวจพบการเคลื่อนไหว
กิจกรรม เหตุการณ์ Person ของลักษณะ CameraPerson กล้องตรวจพบบุคคล
กิจกรรม เหตุการณ์เสียงของฟีเจอร์ CameraSound กล้องตรวจพบเสียง
กิจกรรม เหตุการณ์เคมีของลักษณะ DoorbellChime มีการกดกริ่งประตู
ใช้ eventId จากเหตุการณ์ที่รองรับในคำขอคำสั่งเพื่อรับ URL การดาวน์โหลดรูปภาพจากกล้องที่เกี่ยวข้องกับเหตุการณ์นั้น

คำขอและการตอบกลับ GenerateImage

ส่งคำขอ

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraEventImage.GenerateImage",
  "params" : {
    "eventId" : "YLrBUJOqmXJa-j9GmgW8wMbSmM..."
  }
}

คำตอบ

{
  "results" : {
    "url" : "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...",
    "token" : "g.0.eventToken"
  }
}

ช่องคำขอ GenerateImage

ช่อง คำอธิบาย ประเภทข้อมูล
eventId รหัสของเหตุการณ์ที่จะขอรูปภาพกล้องที่เกี่ยวข้อง string
เช่น "YLrBUJOqmXJa-j9GmgW8wMbSmM..."

ช่องคำตอบของ GenerateImage

ช่อง คำอธิบาย ประเภทข้อมูล
url URL ที่จะใช้ดาวน์โหลดรูปภาพจากกล้อง string
เช่น "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1..."
token โทเค็นที่จะใช้ในส่วนหัวการให้สิทธิ์ HTTP เมื่อดาวน์โหลดอิมเมจ string
เช่น "g.0.eventToken"

ดาวน์โหลดรูปภาพจากกล้อง

โทรออกไปยัง 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 ทั้งหมด