مخطط معاينة مقطع الكاميرا

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

sdm.devices.traits.CameraClipPreview

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

الحقول

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

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

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

فعاليات

ClipPreview

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

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

هذا الحدث متاح للأحداث التالية:

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

حدث ClipPreview

المحتوى

{
  "eventId" : "54e55063-25e6-44a5-9aa7-704405bb1c91",
  "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
مثال: "54e55063-25e6-44a5-9aa7-704405bb1c91"
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/...

الأخطاء

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