Схема черт умного домашнего повара
action.devices.traits.Cook
— эта черта относится к устройствам, которые могут готовить еду в соответствии с различными предустановками еды и поддерживаемыми режимами приготовления.
Примеры этих типов устройств включают мультиварку , скороварку , блендер и микроволновую печь . Команды приготовления могут включать количество и название продукта, например «Две чашки коричневого риса», где «коричневый рис» — это предустановленная еда для устройства.
Эта черта не обрабатывает время приготовления или температуру приготовления. Дополнительные сведения см. в разделе Таймер и контроль температуры .
АТРИБУТЫ устройства
Устройства с этой чертой могут сообщать о следующих атрибутах как часть операции SYNC
. Дополнительные сведения об обработке намерений SYNC
см. в разделе Выполнение намерений .
Атрибуты | Тип | Описание |
---|---|---|
supportedCookingModes | Множество | Необходимый. Режимы приготовления, поддерживаемые этим устройством. |
[ item, ... ] | Нить | Режим приготовления. Поддерживаемые значения:
|
foodPresets | Множество | Предустановки для определенных видов еды. |
[ item, ... ] | Объект | Предустановка еды. |
food_preset_name | Нить | Необходимый. Внутреннее имя пресета еды, которое будет использоваться в командах и состояниях. Это имя может быть неудобным для пользователя и используется на всех языках. |
supported_units | Множество | Необходимый. Содержит все единицы измерения, поддерживаемые устройством для определенного продукта. |
[ item, ... ] | Нить | Поддерживаемый блок. Поддерживаемые значения:
|
food_synonyms | Множество | Необходимый. Синонимы названий блюд для пресетов на каждом поддерживаемом языке. |
[ item, ... ] | Объект | Название еды. |
synonym | Множество | Необходимый. Синонимы для предустановки должны включать формы как единственного, так и множественного числа, если это применимо. |
[ item, ... ] | Нить | Имя предустановленного синонима. |
lang | Нить | Необходимый. Код языка (ISO 639-1). См. поддерживаемые языки . |
Примеры
Устройство только с одним режимом приготовления и без предварительной настройки.
{ "supportedCookingModes": [ "BAKE" ] }
Устройство с несколькими режимами приготовления и предустановками блюд.
{ "supportedCookingModes": [ "COOK", "WARM" ], "foodPresets": [ { "food_preset_name": "white_rice", "supported_units": [ "CUPS" ], "food_synonyms": [ { "synonym": [ "White Rice", "Rice" ], "lang": "en" } ] }, { "food_preset_name": "brown_rice", "supported_units": [ "CUPS" ], "food_synonyms": [ { "synonym": [ "Brown Rice" ], "lang": "en" } ] } ] }
СОСТОЯНИЯ устройства
Устройства с этой чертой могут сообщать о следующих состояниях как часть операции QUERY
. Дополнительные сведения об обработке намерений QUERY
см. в разделе Выполнение намерений .
состояния | Тип | Описание |
---|---|---|
currentCookingMode | Нить | Необходимый. Описывает текущий режим приготовления, установленный на устройстве, из списка |
currentFoodPreset | Нить | Описывает текущее приготовление пищи на устройстве из списка атрибута |
currentFoodQuantity | Число | Определяет текущее количество приготовленной пищи, связанное с |
currentFoodUnit | Нить | Единица, связанная с |
Примеры
Моя духовка готовит?
{ "currentCookingMode": "BAKE" }
Что сейчас готовится в моей рисоварке?
{ "currentCookingMode": "COOK", "currentFoodPreset": "brown_rice", "currentFoodQuantity": 2, "currentFoodUnit": "CUPS" }
КОМАНДЫ устройства
Устройства с этой чертой могут отвечать на следующие команды как часть операции EXECUTE
. Дополнительные сведения об обработке намерений EXECUTE
см. в разделе Выполнение намерений .
action.devices.commands.Cook
Начать или остановить приготовление.
Параметры
Параметры | Тип | Описание |
---|---|---|
start | логический | Необходимый. True, чтобы начать приготовление, false, чтобы остановить текущий режим приготовления. |
cookingMode | Нить | Запрошенный режим приготовления для устройства из атрибута |
foodPreset | Нить | Имя предустановки еды, запрошенное пользователем, из атрибута |
quantity | Число | Количество еды, запрошенное пользователем. |
unit | Нить | Единица, связанная с |
Примеры
Начинайте печь в моей духовке.
{ "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "BAKE" } }
Хватит печь в моей духовке.
{ "command": "action.devices.commands.Cook", "params": { "start": false, "cookingMode": "BAKE" } }
Начните готовить 2 чашки белого риса в рисоварке.
{ "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "COOK", "foodPreset": "white_rice", "quantity": 2, "unit": "CUPS" } }
ОШИБКИ устройства
См. полный список ошибок и исключений .-
deviceDoorOpen
— Дверца устройства открыта. -
deviceLidOpen
- Крышка устройства открыта. -
fractionalAmountNotSupported
— пользователь запросил дробное количество для этого набора продуктов питания, но оно не поддерживается этим устройством. -
amountAboveLimit
— пользователь запросил количество, превышающее максимальное. -
unknownFoodPreset
— пользователь запросил предустановку еды, не поддерживаемую устройством.
Схема черт умного домашнего повара
action.devices.traits.Cook
— эта черта относится к устройствам, которые могут готовить еду в соответствии с различными предустановками еды и поддерживаемыми режимами приготовления.
Примеры этих типов устройств включают мультиварку , скороварку , блендер и микроволновую печь . Команды приготовления могут включать количество и название продукта, например «Две чашки коричневого риса», где «коричневый рис» — это предустановленная еда для устройства.
Эта черта не обрабатывает время приготовления или температуру приготовления. Дополнительные сведения см. в разделе Таймер и контроль температуры .
АТРИБУТЫ устройства
Устройства с этой чертой могут сообщать о следующих атрибутах как часть операции SYNC
. Дополнительные сведения об обработке намерений SYNC
см. в разделе Выполнение намерений .
Атрибуты | Тип | Описание |
---|---|---|
supportedCookingModes | Множество | Необходимый. Режимы приготовления, поддерживаемые этим устройством. |
[ item, ... ] | Нить | Режим приготовления. Поддерживаемые значения:
|
foodPresets | Множество | Предустановки для определенных видов еды. |
[ item, ... ] | Объект | Предустановка еды. |
food_preset_name | Нить | Необходимый. Внутреннее имя пресета еды, которое будет использоваться в командах и состояниях. Это имя может быть неудобным для пользователя и используется на всех языках. |
supported_units | Множество | Необходимый. Содержит все единицы измерения, поддерживаемые устройством для определенного продукта. |
[ item, ... ] | Нить | Поддерживаемый блок. Поддерживаемые значения:
|
food_synonyms | Множество | Необходимый. Синонимы названий блюд для пресетов на каждом поддерживаемом языке. |
[ item, ... ] | Объект | Название еды. |
synonym | Множество | Необходимый. Синонимы для предустановки должны включать формы как единственного, так и множественного числа, если это применимо. |
[ item, ... ] | Нить | Имя предустановленного синонима. |
lang | Нить | Необходимый. Код языка (ISO 639-1). См. поддерживаемые языки . |
Примеры
Устройство только с одним режимом приготовления и без предварительной настройки.
{ "supportedCookingModes": [ "BAKE" ] }
Устройство с несколькими режимами приготовления и предустановками блюд.
{ "supportedCookingModes": [ "COOK", "WARM" ], "foodPresets": [ { "food_preset_name": "white_rice", "supported_units": [ "CUPS" ], "food_synonyms": [ { "synonym": [ "White Rice", "Rice" ], "lang": "en" } ] }, { "food_preset_name": "brown_rice", "supported_units": [ "CUPS" ], "food_synonyms": [ { "synonym": [ "Brown Rice" ], "lang": "en" } ] } ] }
СОСТОЯНИЯ устройства
Устройства с этой чертой могут сообщать о следующих состояниях как часть операции QUERY
. Дополнительные сведения об обработке намерений QUERY
см. в разделе Выполнение намерений .
состояния | Тип | Описание |
---|---|---|
currentCookingMode | Нить | Необходимый. Описывает текущий режим приготовления, установленный на устройстве, из списка |
currentFoodPreset | Нить | Описывает текущее приготовление пищи на устройстве из списка атрибута |
currentFoodQuantity | Число | Определяет текущее количество приготовленной пищи, связанное с |
currentFoodUnit | Нить | Единица, связанная с |
Примеры
Моя духовка готовит?
{ "currentCookingMode": "BAKE" }
Что сейчас готовится в моей рисоварке?
{ "currentCookingMode": "COOK", "currentFoodPreset": "brown_rice", "currentFoodQuantity": 2, "currentFoodUnit": "CUPS" }
КОМАНДЫ устройства
Устройства с этой чертой могут отвечать на следующие команды как часть операции EXECUTE
. Дополнительные сведения об обработке намерений EXECUTE
см. в разделе Выполнение намерений .
action.devices.commands.Cook
Начать или остановить приготовление.
Параметры
Параметры | Тип | Описание |
---|---|---|
start | логический | Необходимый. True, чтобы начать приготовление, false, чтобы остановить текущий режим приготовления. |
cookingMode | Нить | Запрошенный режим приготовления для устройства из атрибута |
foodPreset | Нить | Имя предустановки еды, запрошенное пользователем, из атрибута |
quantity | Число | Количество еды, запрошенное пользователем. |
unit | Нить | Единица, связанная с |
Примеры
Начинайте печь в моей духовке.
{ "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "BAKE" } }
Хватит печь в моей духовке.
{ "command": "action.devices.commands.Cook", "params": { "start": false, "cookingMode": "BAKE" } }
Начните готовить 2 чашки белого риса в рисоварке.
{ "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "COOK", "foodPreset": "white_rice", "quantity": 2, "unit": "CUPS" } }
ОШИБКИ устройства
См. полный список ошибок и исключений .-
deviceDoorOpen
— Дверца устройства открыта. -
deviceLidOpen
- Крышка устройства открыта. -
fractionalAmountNotSupported
— пользователь запросил дробное количество для этого набора продуктов питания, но оно не поддерживается этим устройством. -
amountAboveLimit
— пользователь запросил количество, превышающее максимальное. -
unknownFoodPreset
— пользователь запросил предустановку еды, не поддерживаемую устройством.