مخطط CameraClipPreview

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

sdm.devices.traits.CameraClipPreview

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

الحقول

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

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

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

فعاليات

ClipPreview

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

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

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

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

حدث ClipPreview

المحتوى

{
  "eventId" : "2202e4f3-bfaa-4714-a70b-d2d12271b883",
  "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
مثال: "2202e4f3-bfaa-4714-a70b-d2d12271b883"
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/...

الأخطاء

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