مخطط 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" : "2141b288-905b-45a1-bf2f-56cf51c2c864",
  "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
مثال: "2141b288-905b-45a1-bf2f-56cf51c2c864"
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/...

الأخطاء

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