สคีมา CameraClipPreview

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

sdm.devices.traits.CameraClipPreview

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

ช่อง

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

คำสั่ง

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

เหตุการณ์

ClipPreview

คลิปวิดีโอพร้อมให้แสดงตัวอย่างแล้ว

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

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

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

เหตุการณ์ ClipPreview

เพย์โหลด

{
  "eventId" : "450d6756-e37b-434c-8b9e-202fdd5b0fc1",
  "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
Example: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
previewUrl URL ที่ใช้แสดงตัวอย่างคลิปวิดีโอ ตัวแปลงรหัสวิดีโอเริ่มต้นคือ H264 string
Example: "https://previewUrl/..."

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

ฟิลด์ คำอธิบาย ประเภทข้อมูล
eventId ตัวระบุที่ไม่ซ้ำกันสำหรับเหตุการณ์ string
Example: "450d6756-e37b-434c-8b9e-202fdd5b0fc1"
timestamp เวลาที่เกิดเหตุการณ์ string
Example: "2019-01-01T00:00:01Z"
resourceUpdate ออบเจ็กต์ที่แสดงรายละเอียดข้อมูลเกี่ยวกับการอัปเดตทรัพยากร object
userId ตัวระบุที่ไม่ซ้ำกันและปรับให้ยากต่อการอ่าน (Obfuscate) ซึ่งแสดงถึงผู้ใช้ string
Example: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
resourceGroup ออบเจ็กต์ที่ระบุทรัพยากรที่อาจมีการอัปเดตที่คล้ายกับเหตุการณ์นี้ ทรัพยากรของเหตุการณ์เอง (จากออบเจ็กต์ resourceUpdate) จะอยู่ในออบเจ็กต์นี้เสมอ object

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

แสดงตัวอย่างคลิป

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

Preview

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

ข้อผิดพลาด

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