مخطط CameraEventImage

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

sdm.devices.traits.CameraEventImage

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

الحقول

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

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

GenerateImage

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

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

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

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

طلب

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

الردّ

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

حقول طلب GenerateImage

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

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

الحقل الوصف نوع البيانات
url عنوان URL الذي يمكن تنزيل صورة الكاميرا منه string
مثال: "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1..."
token الرمز المميز الذي سيتم استخدامه في عنوان HTTP Authorization عند تنزيل الصورة. string
مثال: "g.0.eventToken"

تنزيل صورة من الكاميرا

أرسِل طلب GET إلى url من ردّ GenerateImage أو ، باستخدام token في عنوان HTTP Authorization مع مصادقة Basic، لتنزيل صورة الكاميرا:

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 الصحيح الذي تم إرجاعه من خلال حدث الكاميرا.

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