مخطط 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" : "0010793b-a7d4-4842-a1ba-5c5faed866ef",
  "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
مثال: "0010793b-a7d4-4842-a1ba-5c5faed866ef"
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/...

الأخطاء

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