مخطط 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" : "BTGIA7Gx9MDBhPsGvlPkCYt4Dw..."
  }
}

الردّ

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

حقول طلب GenerateImage

الحقل الوصف نوع البيانات
eventId معرّف الحدث الذي تريد طلب صورة كاميرا ذات صلة به string
Example: "BTGIA7Gx9MDBhPsGvlPkCYt4Dw..."

حقول الردّ على GenerateImage

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

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