مخطّط CameraClipPreview

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

sdm.devices.traits.CameraClipPreview

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

الحقول

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

الأوامر

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

الأحداث

ClipPreview

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

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

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

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

حدث ClipPreview

الحمولة

{
  "eventId" : "89dceec3-a040-4d9f-9308-67222ad34cb2",
  "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
مثال: "89dceec3-a040-4d9f-9308-67222ad34cb2"
timestamp وقت وقوع الحدث string
مثال: "‎2019-01-01T00:00:01Z"
resourceUpdate عنصر يقدّم تفاصيل حول آخر التعديلات من المورد. object
userId معرّف فريد ومشوَّش يمثّل المستخدِم. string
مثال: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
resourceGroup عنصر يشير إلى الموارد التي قد تتضمّن تعديلات مشابهة لهذا الحدث. سيكون مورد الحدث نفسه (من العنصر resourceUpdate) متاحًا دائمًا في هذا العنصر. object

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

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

لمعاينة المقطع، أرسِل طلب GET إلى previewUrl باستخدام رمز الدخول المميز لبروتوكول OAuth في عنوان تفويض HTTP:

نسخة حصرية

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

الأخطاء

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