مخطّط CameraEventImage

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

sdm.devices.traits.CameraEventImage

تنتمي هذه السمة إلى أي جهاز يتيح إنشاء صور من الأحداث.

الحقول

لا تتوفّر حقول لهذه السمة.

الطلبات الصوتية

GenerateImage

يوفّر عنوان URL لتنزيل صورة من الكاميرا.

يتيح هذا الأمر الأحداث التالية:

النوع العنصر الوصف
الحدث حدث الحركة لسمة CameraMotion رصدت الكاميرا حركة.
الحدث حدث شخص لسمة CameraPerson رصدت الكاميرا شخصًا.
الحدث حدث الصوت لسمة CameraSound رصدت الكاميرا صوتًا.
الحدث حدث الرنين لسمة DoorbellChime تم الضغط على جرس الباب.
استخدِم العنصر eventId من حدث متوافق في طلب الأمر لتلقّي عنوان URL للتنزيل لصورة الكاميرا ذات الصلة بهذا الحدث.

طلب GenerateImage والاستجابة له

الطلب

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraEventImage.GenerateImage",
  "params" : {
    "eventId" : "degN_s-SRagH7CJ_2vXSCpWc45..."
  }
}

الردّ

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

حقول طلب GenerateImage

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

حقول استجابة GenerateImage

الحقل الوصف نوع البيانات
url عنوان URL الذي يمكن تنزيل صورة الكاميرا منه string
مثال: "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1..."
token الرمز المميّز لاستخدامه في عنوان HTTP Authorization عند تنزيل الصورة. 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 x ‏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 الصحيح الذي يعرضه حدث الكاميرا.

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