طرحواره 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" : "Ah97W4rOjQSyarHNmyxQTZk_Q8..."
  }
}

پاسخ 

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

ایجاد فیلدهای درخواست تصویر

میدان توضیحات نوع داده
eventId شناسه رویداد برای درخواست تصویر دوربین مرتبط. string
مثال: "Ah97W4rOjQSyarHNmyxQTZk_Q8..."

ایجاد زمینه های پاسخ تصویر

میدان توضیحات نوع داده
url URL برای دانلود تصویر دوربین از. string
مثال: "https:// domain /sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1..."
token رمزی برای استفاده در هدر مجوز HTTP هنگام بارگیری تصویر. string
مثال: "g.0.eventToken"

دانلود تصویر دوربین

یک تماس GET با url a 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 ویژگی برای اطلاعات در مورد ویژگی های تصویر.

خطاها

کد(های) خطای زیر ممکن است در رابطه با این ویژگی برگردانده شوند:

پیغام خطا RPC عیب یابی
تصویر دوربین دیگر برای دانلود در دسترس نیست. DEADLINE_EXCEEDED تصاویر رویداد 30 ثانیه پس از انتشار رویداد منقضی می شوند. حتما قبل از انقضا تصویر را دانلود کنید.
شناسه رویداد به دوربین تعلق ندارد. FAILED_PRECONDITION از eventID صحیحی که توسط رویداد دوربین برگردانده شده است استفاده کنید.

برای لیست کامل کدهای خطای API به مرجع کد خطای API مراجعه کنید.