مخطط CameraEventImage

Nest Cam (القديمة) Nest Hub Max Nest Doorbell (الإصدار القديم) 

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" : "4ydmwYgVf-F6f3bPO1dVBVnfKV..."
  }
}

الرد

{
  "results" : {
    "url" : "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...",
    "token" : "g.0.eventToken"
  }
}

حقول طلب إنشاء صورة

الحقل الوصف نوع البيانات
eventId رقم تعريف الحدث المطلوب طلب صورة كاميرا ذات صلة له string
مثال: "4ydmwYgVf-F6f3bPO1dVBVnfKV..."

إنشاء حقول الاستجابة للصور

الحقل الوصف نوع البيانات
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

يمكنك الاطّلاع على CameraImage سمة للمعلومات حول الصورة المواقع.

الأخطاء

يمكن عرض رموز الخطأ التالية فيما يتعلق بهذه السمة:

رسالة الخطأ متوسط عائد النقرة تحديد المشاكل وحلّها
لم تعُد صورة الكاميرا متاحة للتنزيل. DEADLINE_EXCEEDED تنتهي صلاحية صور الحدث بعد 30 ثانية من نشر الحدث. احرص على تنزيل الصورة قبل انتهاء الصلاحية.
رقم تعريف الحدث لا يعود للكاميرا. FAILED_PRECONDITION استخدِم القيمة eventID الصحيحة التي يعرضها حدث الكاميرا.

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