مخطط CameraClipPreview

جرس Nest Doorbell (بطارية) جرس Nest Doorbell (سلكي) 

sdm.devices.traits.CameraClipPreview

تنتمي هذه السمة إلى أي جهاز يتيح تنزيل معاينة مقطع.

الحقول

لا تتوفّر حقول لهذه السمة.

الطلبات الصوتية

لا تتوفّر أوامر لهذه السمة.

الفعاليات

ClipPreview

يتوفّر مقطع فيديو لمعاينته.

معاينة المقطع هي ملف فيديو يتضمّن 10 لقطات بتنسيق mp4. يمكنك اختيار عرض ملف الفيديو بتنسيق mp4 أو تحويله إلى تنسيق آخر (مثل ملف GIF متحرك) لعرض تسلسل كامل من 10 صور. يجب مراعاة إمكانيات جهاز العميل عند اختيار طريقة لمعاينة المقطع.

يمكن استخدام هذا الحدث للأحداث التالية:

النوع العنصر الوصف
الحدث حدث الحركة في سمة CameraMotion رصدت الكاميرا حركة.
الحدث حدث شخص لسمة CameraPerson رصدت الكاميرا شخصًا.
الحدث حدث رنين الخاص بسمة جرس الباب تم الضغط على جرس الباب.
استخدِم eventSessionId لربط هذا الحدث و previewUrl ذي الصلة بحدث واحد أو أكثر من الأحداث المتوافقة.

حدث ClipPreview

الحمولة

{
  "eventId" : "0efc68d0-c23b-4060-a037-97ef6fd8c45b",
  "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
مثال: "0efc68d0-c23b-4060-a037-97ef6fd8c45b"
timestamp وقت وقوع الحدث. string
مثال: "2019-01-01T00:00:01Z"
resourceUpdate عنصر يوضّح معلومات عن تعديل المرجع object
userId معرّف فريد غير واضح يمثّل المستخدم string
مثال: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
resourceGroup كائن يشير إلى الموارد التي قد يكون لها تحديثات مشابهة لهذا الحدث. سيكون مورد الحدث نفسه (من الكائن resourceUpdate) متوفرًا دائمًا في هذا الكائن. object

اطّلِع على الأحداث للحصول على مزيد من المعلومات عن الأنواع المختلفة من الأحداث وطريقة عملها.

معاينة المقطع

لمعاينة المقطع، يمكنك إجراء طلب GET إلى previewUrl باستخدام معرّف OAuth في رأس HTTP Authorization:

معاينة

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

الأخطاء

اطّلِع على مرجع رموز أخطاء واجهة برمجة التطبيقات للحصول على القائمة الكاملة لرموز أخطاء واجهة برمجة التطبيقات.