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