طرحواره 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" : "G3bcBgWL_M1vso939z5WqrcOE5..."
}
}
پاسخ
{ "results" : { "url" : "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...", "token" : "g.0.eventToken" } }
ایجاد فیلدهای درخواست تصویر
میدان | توضیحات | نوع داده |
---|---|---|
eventId | شناسه رویداد برای درخواست تصویر دوربین مرتبط. | string مثال: "G3bcBgWL_M1vso939z5WqrcOE5..." |
ایجاد زمینه های پاسخ تصویر
میدان | توضیحات | نوع داده |
---|---|---|
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 مراجعه کنید.