Руководство по варочной панели «Умный дом»
action.devices.types.COOKTOP — Взаимодействие с варочными панелями может включать их включение и выключение, запуск и остановку, установку таймера, настройку режимов приготовления и предварительных настроек блюд, а также настройку различных настроек режима, не связанного с приготовлением пищи.
Этот тип указывает на то, что на устройстве отображается значок варочной панели и некоторые связанные с ним синонимы и псевдонимы.
Возможности устройства
Обратитесь к соответствующей документации по типажу для получения подробной информации о реализации, такой как атрибуты и состояния, которые ваша служба должна поддерживать, а также о том, как создавать ответы EXECUTE и QUERY.
Требуемые черты
Эти характеристики и команды обязательны, если они применимы к вашему устройству. Если ваше устройство не поддерживает эти функции, введите код ошибки functionNotSupported в ответе QUERY или EXECUTE. Дополнительную информацию см. в разделе «Ошибки и исключения» .
Рекомендуемые черты
Эти характеристики рекомендуются, если они применимы к вашему устройству. Однако вы можете комбинировать все доступные характеристики, чтобы наилучшим образом соответствовать существующей функциональности вашего продукта.
Требования к качеству
- Задержка: должна быть меньше или равна 800 мс .
- Надежность: должна быть больше или равна 97% .
Пример устройства: Простая варочная панель.
В этом разделе приведены примеры полезных данных намерений, представляющих общую «варочную панель» на основе типа устройства и характеристик, указанных выше. Если вы добавляете или удаляете черты в своей реализации, измените свои ответы соответствующим образом, чтобы отразить эти изменения.
Пример ответа SYNC
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.COOKTOP", "traits": [ "action.devices.traits.Cook", "action.devices.traits.StartStop", "action.devices.traits.Timer", "action.devices.traits.OnOff" ], "name": { "name": "Simple cooktop" }, "willReportState": true, "attributes": { "supportedCookingModes": [ "COOK", "BOIL", "SAUTE" ], "foodPresets": [ { "food_preset_name": "chicken_key", "supported_units": [ "POUNDS", "OUNCES" ], "food_synonyms": [ { "synonym": [ "Chicken", "Chicken breast", "Chicken thigh" ], "lang": "en" } ] }, { "food_preset_name": "bacon_key", "supported_units": [ "POUNDS", "OUNCES" ], "food_synonyms": [ { "synonym": [ "Bacon", "Bacon strips" ], "lang": "en" } ] } ], "maxTimerLimitSec": 1200, "pausable": true }, "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, "isRunning": true, "isPaused": false, "timerRemainingSec": 120, "currentCookingMode": "COOK", "currentFoodPreset": "chicken_key" } } } }
Примеры команд EXECUTE
Готовить
Дополнительные сведения о параметрах команды см. в справочнике action.devices.traits.Cook .
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "BOIL" } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "currentCookingMode": "BOIL", "currentFoodPreset": "NONE" } } ] } }
СтартСтоп
Дополнительные сведения о параметрах команды см. в справочнике action.devices.traits.StartStop .
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.StartStop", "params": { "start": true } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "isRunning": true, "isPaused": false } } ] } }
ТаймерСтарт
Дополнительные сведения о параметрах команды см. в справочнике action.devices.traits.Timer .
{ "requestId": "6894439706274654522", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.TimerStart", "params": { "timerTimeSec": 300 } } ] } ] } } ] }
{ "requestId": "6894439706274654522", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "timerRemainingSec": 300 } } ] } }
Настройка таймера
Дополнительные сведения о параметрах команды см. в справочнике action.devices.traits.Timer .
{ "requestId": "6894439706274654524", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.TimerAdjust", "params": { "timerTimeSec": -10 } } ] } ] } } ] }
{ "requestId": "6894439706274654524", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "timerRemainingSec": 110 } } ] } }
ТаймерПауза
Дополнительные сведения о параметрах команды см. в справочнике action.devices.traits.Timer .
{ "requestId": "6894439706274654526", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.TimerPause" } ] } ] } } ] }
{ "requestId": "6894439706274654526", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "timerRemainingSec": 120, "timerPaused": true } } ] } }
ТаймерВозобновить
Дополнительные сведения о параметрах команды см. в справочнике action.devices.traits.Timer .
{ "requestId": "6894439706274654528", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.TimerResume" } ] } ] } } ] }
{ "requestId": "6894439706274654528", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "timerRemainingSec": 120, "timerPaused": false } } ] } }
ТаймерОтмена
Дополнительные сведения о параметрах команды см. в справочнике action.devices.traits.Timer .
{ "requestId": "6894439706274654530", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.TimerCancel" } ] } ] } } ] }
{ "requestId": "6894439706274654530", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "timerRemainingSec": -1 } } ] } }
Вкл.Выкл.
Дополнительные сведения о параметрах команды см. в справочнике action.devices.traits.OnOff .
{ "requestId": "6894439706274654532", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OnOff", "params": { "on": true } } ] } ] } } ] }
{ "requestId": "6894439706274654532", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "on": true } } ] } }