راهنمای پتوی خانه هوشمند
action.devices.types.BLANKET
- تعامل با پتوهای هوشمند ممکن است شامل روشن و خاموش کردن آنها، تنظیم دمای آنها و/یا تنظیم حالت ها و کلیدهای مختلف باشد.
این نوع نشان میدهد که دستگاه نماد Blanket و برخی از مترادفها و نامهای مستعار مرتبط را دریافت میکند.
قابلیت های دستگاه
برای جزئیات پیادهسازی، مانند ویژگیها و حالتهایی که سرویس شما باید از آنها پشتیبانی کند، و نحوه ایجاد پاسخهای EXECUTE و QUERY، به اسناد ویژگی مربوطه مراجعه کنید.
صفات توصیه شده
این ویژگیها در صورت وجود برای دستگاه شما توصیه میشوند. با این حال، شما آزاد هستید که تمام ویژگیهای موجود را با هم ترکیب کنید تا به بهترین نحو با عملکرد محصول موجود خود مطابقت داشته باشد.
الزامات کیفیت
- تأخیر: باید کمتر یا مساوی 2500 میلیثانیه باشد.
- قابلیت اطمینان: باید بیشتر یا مساوی 97 درصد باشد.
نمونه دستگاه: پتو
این بخش شامل بارهای هدف نمونه است که بر اساس نوع دستگاه و ویژگیهای بالا، یک «Blanket» مشترک را نشان میدهد. اگر ویژگیهایی را در پیادهسازی خود اضافه یا حذف میکنید، پاسخهای خود را متناسب با آن تغییر دهید تا آن تغییرات را منعکس کند.
نمونه پاسخ SYNC
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.BLANKET", "traits": [ "action.devices.traits.OnOff", "action.devices.traits.Modes", "action.devices.traits.Toggles" ], "name": { "name": "Blanket" }, "willReportState": true, "attributes": { "availableModes": [ { "name": "temp_mode", "name_values": [ { "name_synonym": [ "Temperature", "Temp" ], "lang": "en" } ], "settings": [ { "setting_name": "hot_temp", "setting_values": [ { "setting_synonym": [ "Hot" ], "lang": "en" } ] }, { "setting_name": "warm_temp", "setting_values": [ { "setting_synonym": [ "Warm" ], "lang": "en" } ] } ] } ], "availableToggles": [ { "name": "auto_off", "name_values": [ { "name_synonym": [ "Auto off" ], "lang": "en" } ] } ] }, "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, "on": true, "currentModeSettings": { "temp_mode": "warm_temp" }, "currentToggleSettings": { "auto_off": true } } } } }
نمونه دستورات EXECUTE
روشن خاموش
برای جزئیات بیشتر در مورد پارامترهای فرمان، به مرجع action.devices.traits.OnOff
مراجعه کنید.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OnOff", "params": { "on": true } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "on": true } } ] } }
SetModes
برای جزئیات بیشتر در مورد پارامترهای فرمان، به مرجع action.devices.traits.Modes
مراجعه کنید.
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.SetModes", "params": { "updateModeSettings": { "temp_mode": "hot_temp" } } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "currentModeSettings": { "temp_mode": "hot_temp" } } } ] } }
SetToggles
برای جزئیات بیشتر در مورد پارامترهای فرمان، به مرجع action.devices.traits.Toggles
مراجعه کنید.
{ "requestId": "6894439706274654520", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "auto_off": false } } } ] } ] } } ] }
{ "requestId": "6894439706274654520", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "currentToggleSettings": { "auto_off": false } } } ] } }