مخطط معاينة مقطع الكاميرا
جرس 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/...
الأخطاء
راجِع مرجع رموز خطأ واجهة برمجة التطبيقات للاطّلاع على القائمة الكاملة لرموز أخطاء واجهة برمجة التطبيقات.