مخطط CameraEventImage

كاميرا Nest Cam (إصدار قديم) Nest Hub Max جرس Nest Doorbell (إصدار قديم) 

sdm.devices.traits.CameraEventImage

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

الحقول

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

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

GenerateImage

تعرض هذه السمة عنوان URL لتنزيل صورة من الكاميرا.

يتوافق هذا الأمر مع الأحداث التالية:

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

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

طلب

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

الردّ

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

حقول طلب GenerateImage

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

حقول استجابة 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.

راجِع السمة CameraImage للحصول على معلومات حول خصائص الصورة.

الأخطاء

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

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

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