مخطّط CameraClipPreview

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

sdm.devices.traits.CameraClipPreview

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

الحقول

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

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

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

الفعاليات

ClipPreview

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

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

يتوفّر هذا الحدث للأحداث التالية:

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

حدث ClipPreview

الحمولة

{
  "eventId" : "58abaf2e-fa2e-4fa6-8911-3ae521aeac28",
  "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
مثال: "58abaf2e-fa2e-4fa6-8911-3ae521aeac28"
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/...

الأخطاء

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