مخطّط CameraEventImage
Nest Cam (الإصدار القديم)
sdm.devices.traits.CameraEventImage
تنتمي هذه السمة إلى أي جهاز يتيح إنشاء صور من الأحداث.
الحقول
لا تتوفّر حقول لهذه السمة.
الطلبات الصوتية
GenerateImage
يوفر هذا الإعداد عنوان URL لتنزيل صورة الكاميرا منه.
يتيح هذا الأمر تنفيذ الأحداث التالية:
النوع | العنصر | الوصف |
---|---|---|
الحدث | حدث الحركة لسمة CameraMotion | رصدت الكاميرا حركة. |
الحدث | حدث الشخص لسمة CameraPerson | رصدت الكاميرا شخصًا. |
الحدث | حدث الصوت لسمة CameraSound | رصدت الكاميرا صوتًا. |
الحدث | حدث الرنين لسمة DoorbellChime | تم الضغط على جرس الباب. |
eventId
من حدث متوافق في طلب الأمر لتلقّي عنوان URL لتنزيل صورة الكاميرا المرتبطة بهذا الحدث.
إنشاء طلب صورة وردّ عليها
الطلب
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.CameraEventImage.GenerateImage
",
"params" : {
"eventId" : "plh0enulqA1vcalHIQdNX3AQoI..."
}
}
الرد
{ "results" : { "url" : "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...", "token" : "g.0.eventToken" } }
حقول طلب GenerateImage
الحقل | الوصف | نوع البيانات |
---|---|---|
eventId |
رقم تعريف الحدث المطلوب طلب صورة مرتبطة به من الكاميرا | string مثال: "plh0enulqA1vcalHIQdNX3AQoI..." |
حقول استجابة GenerateImage
الحقل | الوصف | نوع البيانات |
---|---|---|
url |
عنوان URL لتنزيل صورة الكاميرا منه | string مثال: "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1..." |
token |
رمز مميز لاستخدامه في عنوان تفويض HTTP عند تنزيل الصورة. | string مثال: "g.0.eventToken" |
تنزيل صورة كاميرا
يمكنك إجراء طلب GET إلى url
من ردّ على الأمر
GenerateImage
، باستخدام token
في عنوان HTTP Authorization مع التفويض الأساسي، لتنزيل
صورة الكاميرا:
curl -H "Authorization: Basic g.0.eventToken" \
https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...
استخدِم مَعلمات طلب البحث width
أو height
لتخصيص درجة دقة
الصورة التي يتم تنزيلها. يجب تحديد معلمة واحدة فقط من هذه المعلمات. ويتم تغيير حجم المَعلمة الأخرى
تلقائيًا وفقًا لنسبة عرض إلى ارتفاع الكاميرا.
على سبيل المثال، إذا كانت نسبة العرض إلى الارتفاع للكاميرا هي 4:3، يجب تنزيل صورة الكاميرا بدرجة دقة. مقاس 480 × 360، حدّد العرض أو الارتفاع:
العرض
curl -H "Authorization: Basic g.0.eventToken" \
https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?width=480
الطول
curl -H "Authorization: Basic g.0.eventToken" \
https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?height=360
تنطبق قيود أخرى على عنوان URL للتنزيل:
- إذا تم توفير كلتا المَعلمتَين في عنوان URL، يتم استخدام
width
ويتم تجاهلheight
. - في حال عدم توفير أيّ من المَعلمتَين في عنوان URL، يتم اختيار القيمة التلقائية 480 لسمة
width
.
يمكنك الاطّلاع على صورة الكاميرا لمعلومات الصورة المواقع.
الأخطاء
يمكن عرض رموز الخطأ التالية فيما يتعلق بهذه السمة:
رسالة الخطأ | متوسط عائد النقرة | تحديد المشاكل وحلّها |
---|---|---|
لم تعُد صورة الكاميرا متاحة للتنزيل. | DEADLINE_EXCEEDED |
تنتهي صلاحية صور الحدث بعد 30 ثانية من نشر الحدث. يُرجى تنزيل الصورة قبل انتهاء صلاحيتها. |
رقم تعريف الحدث لا يعود للكاميرا. | FAILED_PRECONDITION |
استخدِم القيمة eventID الصحيحة التي يعرضها حدث الكاميرا. |
يمكنك الاطّلاع على مرجع رمز خطأ واجهة برمجة التطبيقات للحصول على القائمة الكاملة لرموز أخطاء واجهة برمجة التطبيقات.