Руководство по приготовлению су-вид в умном доме
action.devices.types.SOUSVIDE - Взаимодействие с технологией су-вид может включать запуск и остановку, установку таймера, настройку режимов приготовления или предустановок блюд, а также настройку других различных параметров.
Этот тип указывает, что устройство получает значок Sous Vide и некоторые связанные с ним синонимы и псевдонимы.
Возможности устройства
Подробную информацию о реализации, например, об атрибутах и состояниях, которые должна поддерживать ваша служба, а также о том, как создавать ответы EXECUTE и QUERY, см. в соответствующей документации по характеристикам.
Требуемые черты
Эти характеристики и команды обязательны, если применимы к вашему устройству. Если ваше устройство не поддерживает эти характеристики, введите код ошибки functionNotSupported в ответе QUERY или EXECUTE. Подробнее см. в разделе «Ошибки и исключения» .
Рекомендуемые черты
Эти характеристики рекомендуются, если они применимы к вашему устройству. Однако вы можете комбинировать все доступные характеристики, чтобы наилучшим образом соответствовать функционалу вашего устройства.
Пример устройства: Простой су-вид
В этом разделе приведены примеры полезных нагрузок Intent, представляющих собой стандартную функцию «Sous Vide» на основе типа устройства и перечисленных выше характеристик. Если вы добавляете или удаляете характеристики в своей реализации, измените свои ответы соответствующим образом, чтобы отразить эти изменения.
Пример ответа SYNC
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.SOUSVIDE", "traits": [ "action.devices.traits.Cook", "action.devices.traits.StartStop", "action.devices.traits.Timer", "action.devices.traits.OnOff" ], "name": { "name": "Simple sous vide" }, "willReportState": true, "attributes": { "supportedCookingModes": [ "SOUS_VIDE" ], "foodPresets": [ { "food_preset_name": "chicken_key", "supported_units": [ "POUNDS", "OUNCES" ], "food_synonyms": [ { "synonym": [ "Chicken", "Whole chicken" ], "lang": "en" } ] }, { "food_preset_name": "salmon_key", "supported_units": [ "POUNDS", "OUNCES" ], "food_synonyms": [ { "synonym": [ "Salmon", "King salmon" ], "lang": "en" } ] } ], "maxTimerLimitSec": 30, "pausable": true }, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
Пример ответа на ЗАПРОС
{ "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": 15, "currentCookingMode": "SOUS_VIDE", "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": false, "cookingMode": "SOUS_VIDE" } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "currentCookingMode": "NONE", "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 } } ] } }
TimerStart
Дополнительные сведения о параметрах команды см. в справочнике action.devices.traits.Timer .
{ "requestId": "6894439706274654522", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.TimerStart", "params": { "timerTimeSec": 15 } } ] } ] } } ] }
{ "requestId": "6894439706274654522", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "timerRemainingSec": 15 } } ] } }
Настройка таймера
Дополнительные сведения о параметрах команды см. в справочнике 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": 5 } } ] } }
ТаймерПауза
Дополнительные сведения о параметрах команды см. в справочнике 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": 15, "timerPaused": true } } ] } }
TimerResume
Дополнительные сведения о параметрах команды см. в справочнике 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": 15, "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 } } ] } }