مخطّط CameraClipPreview

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

sdm.devices.traits.CameraClipPreview

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

الحقول

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

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

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

الفعاليات

ClipPreview

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

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

يمكن استخدام هذا الحدث للأحداث التالية:

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

حدث ClipPreview

الحمولة

{
  "eventId" : "52e8e39c-1cb0-4e30-aeee-6bb8e56c4f6c",
  "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
مثال: "52e8e39c-1cb0-4e30-aeee-6bb8e56c4f6c"
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/...

الأخطاء

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