สคีมาผู้ที่อยู่ในกล้อง

sdm.devices.traits.CameraPerson

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

ช่อง

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

คำสั่ง

ไม่มีคำสั่งที่ใช้ได้สำหรับลักษณะนี้

กิจกรรม

บุคคล

อัปเดตได้ 

กล้องตรวจพบบุคคล

กิจกรรมนี้รองรับการแจ้งเตือนที่อัปเดตได้ การแจ้งเตือนที่มีอยู่ของแอปซึ่งสร้างจากกิจกรรมนี้สามารถอัปเดตได้โดยใช้เนื้อหาของกิจกรรมที่ตามมาที่มี eventThreadId เดียวกัน

เหตุการณ์เกี่ยวกับบุคคล

เพย์โหลด

{
  "eventId" : "914a826c-8b1f-4ff9-8b53-a2b92a945cd2",
"timestamp" : "2019-01-01T00:00:01Z",
"resourceUpdate" : { "name" : "enterprises/project-id/devices/device-id", "events" : { "sdm.devices.events.CameraPerson.Person" : { "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "eventId" : "9Uk0BSbGbYySSeq4b4LOXni1fb...", } } } "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
"eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
"eventThreadState" : "STARTED",
"resourceGroup" : [ "enterprises/project-id/devices/device-id" ] }

ช่องเหตุการณ์ของบุคคล

ช่อง คำอธิบาย ประเภทข้อมูล
eventSessionId Nest Doorbell (แบบใช้แบตเตอรี่) Nest Doorbell (แบบใช้สาย) รหัสที่กำหนดให้กับเหตุการณ์ที่เกิดขึ้นซึ่งเป็นส่วนหนึ่งของเซสชันเดียวของ กิจกรรมที่เกี่ยวข้อง ใช้สำหรับการรวมเหตุการณ์ได้

ใช้เพื่อเชื่อมโยงเหตุการณ์นี้กับเหตุการณ์ ClipPreview ที่เกี่ยวข้องของลักษณะ CameraClipPreview

string
ตัวอย่าง: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
eventId Nest Cam (เดิม) Nest Hub Max Nest Doorbell (รุ่นเดิม) รหัสที่เชื่อมโยงกับเหตุการณ์

ใช้กับคําสั่ง GenerateImage เพื่อดาวน์โหลดรูปภาพจากกล้องที่เกี่ยวข้องกับเหตุการณ์นี้

string
เช่น "9Uk0BSbGbYySSeq4b4LOXni1fb..."

ช่องเพย์โหลดของเหตุการณ์

ช่อง คำอธิบาย ประเภทข้อมูล
eventId ตัวระบุที่ไม่ซ้ำกันสำหรับกิจกรรม string
เช่น "914a826c-8b1f-4ff9-8b53-a2b92a945cd2"
timestamp เวลาที่เกิดเหตุการณ์ string
เช่น "2019-01-01T00:00:01Z"
resourceUpdate ออบเจ็กต์ที่แสดงรายละเอียดการอัปเดตทรัพยากร object
userId ตัวระบุที่ปรับให้ยากต่อการอ่าน (Obfuscate) ที่ไม่ซ้ำกันซึ่งแสดงถึงผู้ใช้ string
เช่น "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
eventThreadId อัปเดตได้ ตัวระบุที่ไม่ซ้ำกันสำหรับชุดข้อความเหตุการณ์ string
เช่น "d67cd3f7-86a7-425e-8bb3-462f92ec9f59"
eventThreadState อัปเดตได้ สถานะของชุดข้อความเหตุการณ์ string
ค่า: "STARTED", "UPDATED", "ENDED"
resourceGroup ออบเจ็กต์ที่ระบุทรัพยากรที่อาจมีการอัปเดตที่คล้ายกันกับเหตุการณ์นี้ ทรัพยากรของเหตุการณ์ (จากออบเจ็กต์ resourceUpdate) จะแสดงอยู่ในออบเจ็กต์นี้เสมอ object

ดูกิจกรรมสำหรับข้อมูลเพิ่มเติมเกี่ยวกับ ประเภทเหตุการณ์และวิธีการทำงาน

ข้อผิดพลาด

ระบบอาจแสดงรหัสข้อผิดพลาดต่อไปนี้ซึ่งเกี่ยวข้องกับลักษณะนี้

ข้อความแสดงข้อผิดพลาด RPC การแก้ปัญหา
รูปภาพจากกล้องไม่พร้อมให้ดาวน์โหลดแล้ว DEADLINE_EXCEEDED รูปภาพกิจกรรมจะหมดอายุใน 30 วินาทีหลังจากที่เผยแพร่กิจกรรม โปรดดาวน์โหลดรูปภาพก่อนหมดอายุ
รหัสเหตุการณ์ไม่ได้อยู่ในกล้อง FAILED_PRECONDITION ใช้ eventID ที่ถูกต้องซึ่งแสดงผลจากเหตุการณ์จากกล้อง

ดูรายการรหัสข้อผิดพลาด API ทั้งหมดได้ในเอกสารอ้างอิงรหัสข้อผิดพลาดของ API