مخطط CameraEventImage
كاميرا Nest Cam (القديمة)
sdm.devices.traits.CameraEventImage
تنتمي هذه السمة إلى أي جهاز يتيح إنشاء الصور من الأحداث.
الحقول
لا تتوفّر أي حقول لهذه السمة.
الطلبات الصوتية
GenerateImage
يوفّر هذا الخيار عنوان URL لتنزيل صورة الكاميرا منه.
يدعم هذا الأمر الأحداث التالية:
النوع | عنصر | الوصف |
---|---|---|
حدث | حدث الحركة لسمة CameraMotion | رصدت الكاميرا حركة. |
حدث | حدث شخص لسمة CameraPerson | رصدت الكاميرا شخصًا. |
حدث | حدث الصوت لسمة CameraSound | رصدت الكاميرا الصوت. |
حدث | حدث Chime من سمة DoorbellChime | تم الضغط على جرس الباب. |
eventId
من حدث متوافق في طلب الأمر لتلقّي عنوان URL لتنزيل صورة الكاميرا المتعلّقة بهذا الحدث.
طلب إنشاء صورة وردّها
الطلب
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.CameraEventImage.GenerateImage
",
"params" : {
"eventId" : "8NYaH5PZ6kftObq1UK3k6qfOcC..."
}
}
الإجابة
{ "results" : { "url" : "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...", "token" : "g.0.eventToken" } }
حقول طلب CREATEImage
الحقل | الوصف | نوع البيانات |
---|---|---|
eventId |
رقم تعريف الحدث لطلب صورة كاميرا ذات صلة به. | string مثال: "8NYaH5PZ6kftObq1UK3k6qfOcC..." |
حقول الردّ CREATEImage
الحقل | الوصف | نوع البيانات |
---|---|---|
url |
عنوان URL لتنزيل صورة الكاميرا منه. | string مثال: "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1..." |
token |
رمز مميّز لاستخدامه في عنوان تفويض HTTP عند تنزيل الصورة | string مثال: "g.0.eventToken" |
تنزيل صورة كاميرا
عليك إجراء طلب استرداد بيانات باستخدام GET إلى url
من خلال استجابة الأمر
GenerateImage
، باستخدام
token
في عنوان تفويض HTTP مع التفويض الأساسي، من أجل تنزيل
صورة الكاميرا:
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
.
اطّلِع على السمة CameraImage للحصول على معلومات عن خصائص الصور.
الأخطاء
قد يتم عرض رموز الخطأ التالية في ما يتعلق بهذه السمة:
رسالة الخطأ | متوسط عائد النقرة | تحديد المشاكل وحلّها |
---|---|---|
لم تعُد صورة الكاميرا متاحة للتنزيل. | DEADLINE_EXCEEDED |
تنتهي صلاحية صور الحدث بعد 30 ثانية من نشره. احرص على تنزيل الصورة قبل انتهاء الصلاحية. |
رقم تعريف الحدث لا ينتمي إلى الكاميرا. | FAILED_PRECONDITION |
استخدِم القيمة eventID الصحيحة التي يعرضها حدث الكاميرا. |
راجِع مرجع رموز خطأ واجهة برمجة التطبيقات للاطّلاع على القائمة الكاملة لرموز أخطاء واجهة برمجة التطبيقات.