مخطط CameraEventImage

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

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 الصحيحة التي يعرضها حدث الكاميرا.

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