مخطط CameraClipPreview

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

sdm.devices.traits.CameraClipPreview

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

الحقول

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

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

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

الفعاليات

ClipPreview

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

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

يتوافق هذا الحدث مع الأحداث التالية:

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

حدث ClipPreview

الحمولة

{
  "eventId" : "1377ffd1-460e-4abe-83b2-21315c0b7a86",
  "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
مثال: "1377ffd1-460e-4abe-83b2-21315c0b7a86"
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/...

الأخطاء

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