راهنمای دوربین خانه هوشمند
action.devices.types.CAMERA
- دوربین ها پیچیده هستند و ویژگی ها بین فروشندگان به طور قابل توجهی متفاوت است. با گذشت زمان، دوربینها ویژگیها و ویژگیهای زیادی را به دست میآورند که قابلیتهای خاصی را توصیف میکنند، که بسیاری از آنها ممکن است به روشهای خاصی با جریان ویدئو/صوت تعامل داشته باشند، مانند ارسال یک جریان به دستگاه دیگری، شناسایی آنچه در جریان است، پخش مجدد فیدها و غیره.
این نوع نشان میدهد که دستگاه نماد دوربین و برخی از مترادفها و نامهای مستعار مرتبط را دریافت میکند.
قابلیت های دستگاه
برای جزئیات پیادهسازی، مانند ویژگیها و حالتهایی که سرویس شما باید از آنها پشتیبانی کند، و نحوه ساخت پاسخهای EXECUTE و QUERY، به مستندات ویژگی مربوطه مراجعه کنید.
صفات مورد نیاز
این صفات و دستورات، در صورت وجود برای دستگاه شما، مورد نیاز هستند.
الزامات کیفیت
- تأخیر: باید کمتر یا مساوی 2000 میلیثانیه باشد.
- قابلیت اطمینان: باید بیشتر یا مساوی 97 درصد باشد.
دستگاه مثال: دوربین ساده
این بخش شامل بارهای هدف نمونه است که یک «دوربین» رایج را بر اساس نوع دستگاه و ویژگیهای بالا نشان میدهد. اگر ویژگیهایی را در پیادهسازی خود اضافه یا حذف میکنید، پاسخهای خود را متناسب با آن تغییر دهید تا آن تغییرات را منعکس کند.
نمونه پاسخ SYNC
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.CAMERA", "traits": [ "action.devices.traits.CameraStream" ], "name": { "name": "Simple camera" }, "willReportState": true, "attributes": { "cameraStreamSupportedProtocols": [ "hls", "progressive_mp4" ], "cameraStreamNeedAuthToken": true, "cameraStreamNeedDrmEncryption": false }, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
نمونه پاسخ QUERY
{ "requestId": "6894439706274654514", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123" } ] } } ] }
{ "requestId": "6894439706274654514", "payload": { "devices": { "123": { "status": "SUCCESS", "online": true } } } }
نمونه دستورات EXECUTE
GetCameraStream
برای جزئیات بیشتر در مورد پارامترهای فرمان، به مرجع action.devices.traits.CameraStream
مراجعه کنید.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.GetCameraStream", "params": { "StreamToChromecast": true, "SupportedStreamProtocols": [ "progressive_mp4" ] } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "cameraStreamAccessUrl": "https://fluffysheep.com/baaaaa.mp4", "cameraStreamReceiverAppId": "1g2f89213hg", "cameraStreamAuthToken": "12657342190192783", "cameraStreamProtocol": "progressive_mp4" } } ] } }
خطاهای دستگاه
لیست کامل خطاها و استثناها را ببینید.-
resourceUnavailable
دسترس - هر گونه خرابی مربوط به ایجاد URL جریان.