สคีมา CameraClipPreview

Nest Doorbell (แบบใช้แบตเตอรี่) Nest Doorbell (แบบใช้สาย) 

sdm.devices.traits.CameraClipPreview

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

ช่อง

ไม่มีช่องสำหรับลักษณะนี้

คำสั่ง

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

กิจกรรม

ClipPreview

วิดีโอคลิปมีตัวอย่างให้ดู

ตัวอย่างคลิปคือไฟล์วิดีโอ 10 เฟรมในรูปแบบ MP4 คุณสามารถเลือกแสดงไฟล์วิดีโอ mp4 หรือแปลงไฟล์เป็นรูปแบบอื่น (เช่น GIF แบบเคลื่อนไหว) เพื่อแสดงลำดับภาพ 10 เฟรมที่สมบูรณ์ คุณควรพิจารณาความสามารถของไคลเอ็นต์อุปกรณ์เมื่อเลือกวิธีการแสดงตัวอย่างคลิป

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

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

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

เหตุการณ์ ClipPreview

เพย์โหลด

{
  "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"
  ]
}

ช่องเหตุการณ์ ClipPreview

ช่อง	คำอธิบาย	ประเภทข้อมูล
eventSessionId	รหัสที่ระบุให้กับเหตุการณ์ที่เกิดขึ้นเป็นส่วนหนึ่งของเซสชันเดียวของเหตุการณ์ที่เกี่ยวข้อง อาจใช้สำหรับการรวมเหตุการณ์	string ตัวอย่าง: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
previewUrl	URL สำหรับดูตัวอย่างวิดีโอคลิป ตัวแปลงรหัสวิดีโอเริ่มต้นคือ H264	string เช่น "https://previewUrl/..."

ฟิลด์เพย์โหลดเหตุการณ์

ช่อง	คำอธิบาย	ประเภทข้อมูล
eventId	ตัวระบุที่ไม่ซ้ำกันของเหตุการณ์	string ตัวอย่าง: "b57d00e5-ea8e-4c8d-a130-99b8f2525384"
timestamp	เวลาที่เกิดเหตุการณ์	string เช่น "2019-01-01T00:00:01Z"
resourceUpdate	ออบเจ็กต์ที่แสดงรายละเอียดข้อมูลเกี่ยวกับการอัปเดตทรัพยากร	object
userId	ตัวระบุที่ไม่ซ้ำซึ่งมีการสร้างความสับสนซึ่งแสดงถึงผู้ใช้	string ตัวอย่าง: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
resourceGroup	ออบเจ็กต์ที่ระบุแหล่งข้อมูลที่อาจมีข้อมูลอัปเดตที่คล้ายกับเหตุการณ์นี้ ทรัพยากรของเหตุการณ์ (จากออบเจ็กต์ resourceUpdate) จะอยู่ในออบเจ็กต์นี้เสมอ	object

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

ฟังตัวอย่างคลิป

หากต้องการดูตัวอย่างคลิป ให้เรียก GET ไปยัง previewUrl โดยใช้โทเค็นการเข้าถึง OAuth ในส่วนหัวการให้สิทธิ์ HTTP ดังนี้

Preview

curl -H 'Authorization: Bearer access-token' \
  https://previewUrl/...

ข้อผิดพลาด

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