Эта страница переведена с помощью Cloud Translation API.

Схема черт умного домашнего повара

action.devices.traits.Cook — эта черта относится к устройствам, которые могут готовить еду в соответствии с различными предустановками еды и поддерживаемыми режимами приготовления.

Примеры этих типов устройств включают мультиварку , скороварку , блендер и микроволновую печь . Команды приготовления могут включать количество и название продукта, например «Две чашки коричневого риса», где «коричневый рис» — это предустановленная еда для устройства.

Эта черта не обрабатывает время приготовления или температуру приготовления. Дополнительные сведения см. в разделе Таймер и контроль температуры .

АТРИБУТЫ устройства

Устройства с этой чертой могут сообщать о следующих атрибутах как часть операции SYNC . Дополнительные сведения об обработке намерений SYNC см. в разделе Выполнение намерений .

Атрибуты	Тип	Описание
`supportedCookingModes`	Множество	Необходимый. Режимы приготовления, поддерживаемые этим устройством.
`[ item, ... ]`	Нить	Режим приготовления. Поддерживаемые значения: `UNKNOWN_COOKING_MODE` `BAKE` `BEAT` `BLEND` `BOIL` `BREW` `BROIL` `CONVECTION_BAKE` `COOK` `DEFROST` `DEHYDRATE` `FERMENT` `FRY` `GRILL` `KNEAD` `MICROWAVE` `MIX` `PRESSURE_COOK` `PUREE` `ROAST` `SAUTE` `SLOW_COOK` `SOUS_VIDE` `STEAM` `STEW` `STIR` `WARM` `WHIP`
`foodPresets`	Множество	Предустановки для определенных видов еды.
`[ item, ... ]`	Объект	Предустановка еды.
`food_preset_name`	Нить	Необходимый. Внутреннее имя пресета еды, которое будет использоваться в командах и состояниях. Это имя может быть неудобным для пользователя и используется на всех языках.
`supported_units`	Множество	Необходимый. Содержит все единицы измерения, поддерживаемые устройством для определенного продукта.
`[ item, ... ]`	Нить	Поддерживаемый блок. Поддерживаемые значения: `UNKNOWN_UNITS` `NO_UNITS` `CENTIMETERS` `CUPS` `DECILITERS` `FEET` `FLUID_OUNCES` `GALLONS` `GRAMS` `INCHES` `KILOGRAMS` `LITERS` `METERS` `MILLIGRAMS` `MILLILITERS` `MILLIMETERS` `OUNCES` `PINCH` `PINTS` `PORTION` `POUNDS` `QUARTS` `TABLESPOONS` `TEASPOONS`
`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`	Нить	Необходимый. Описывает текущий режим приготовления, установленный на устройстве, из списка `supportedCookingModes` атрибутов CookingModes. Только один режим может быть сообщен. Если в настоящий момент не выбран ни один режим, следует установить значение NONE.
`currentFoodPreset`	Нить	Описывает текущее приготовление пищи на устройстве из списка атрибута `foodPresets` . Можно указать только один продукт. Если в настоящее время еда не выбрана, следует установить значение NONE.
`currentFoodQuantity`	Число	Определяет текущее количество приготовленной пищи, связанное с `currentFoodUnit` , если количество было указано. Не следует сообщать, если в данный момент ничего не готовится или если с этой предустановкой продуктов не связано количество.
`currentFoodUnit`	Нить	Единица, связанная с `currentFoodQuantity` , из списка атрибута `supported_units` .

Примеры

Моя духовка готовит?

{
  "currentCookingMode": "BAKE"
}

Что сейчас готовится в моей рисоварке?

{
  "currentCookingMode": "COOK",
  "currentFoodPreset": "brown_rice",
  "currentFoodQuantity": 2,
  "currentFoodUnit": "CUPS"
}

КОМАНДЫ устройства

Устройства с этой чертой могут отвечать на следующие команды как часть операции EXECUTE . Дополнительные сведения об обработке намерений EXECUTE см. в разделе Выполнение намерений .

`action.devices.commands.Cook`

Начать или остановить приготовление.

Параметры

Параметры	Тип	Описание
`start`	логический	Необходимый. True, чтобы начать приготовление, false, чтобы остановить текущий режим приготовления.
`cookingMode`	Нить	Запрошенный режим приготовления для устройства из атрибута `supportedCookingModes` .
`foodPreset`	Нить	Имя предустановки еды, запрошенное пользователем, из атрибута `foodPresets` .
`quantity`	Число	Количество еды, запрошенное пользователем.
`unit`	Нить	Единица, связанная с `quantity` , из атрибута `supported_units` .

Примеры

Начинайте печь в моей духовке.

{
  "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 — пользователь запросил предустановку еды, не поддерживаемую устройством.

Схема черт умного домашнего повара

АТРИБУТЫ устройства

Атрибуты	Тип	Описание
`supportedCookingModes`	Множество	Необходимый. Режимы приготовления, поддерживаемые этим устройством.
`[ item, ... ]`	Нить	Режим приготовления. Поддерживаемые значения: `UNKNOWN_COOKING_MODE` `BAKE` `BEAT` `BLEND` `BOIL` `BREW` `BROIL` `CONVECTION_BAKE` `COOK` `DEFROST` `DEHYDRATE` `FERMENT` `FRY` `GRILL` `KNEAD` `MICROWAVE` `MIX` `PRESSURE_COOK` `PUREE` `ROAST` `SAUTE` `SLOW_COOK` `SOUS_VIDE` `STEAM` `STEW` `STIR` `WARM` `WHIP`
`foodPresets`	Множество	Предустановки для определенных видов еды.
`[ item, ... ]`	Объект	Предустановка еды.
`food_preset_name`	Нить	Необходимый. Внутреннее имя пресета еды, которое будет использоваться в командах и состояниях. Это имя может быть неудобным для пользователя и используется на всех языках.
`supported_units`	Множество	Необходимый. Содержит все единицы измерения, поддерживаемые устройством для определенного продукта.
`[ item, ... ]`	Нить	Поддерживаемый блок. Поддерживаемые значения: `UNKNOWN_UNITS` `NO_UNITS` `CENTIMETERS` `CUPS` `DECILITERS` `FEET` `FLUID_OUNCES` `GALLONS` `GRAMS` `INCHES` `KILOGRAMS` `LITERS` `METERS` `MILLIGRAMS` `MILLILITERS` `MILLIMETERS` `OUNCES` `PINCH` `PINTS` `PORTION` `POUNDS` `QUARTS` `TABLESPOONS` `TEASPOONS`
`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"
        }
      ]
    }
  ]
}

СОСТОЯНИЯ устройства

состояния	Тип	Описание
`currentCookingMode`	Нить	Необходимый. Описывает текущий режим приготовления, установленный на устройстве, из списка `supportedCookingModes` атрибутов CookingModes. Только один режим может быть сообщен. Если в настоящий момент не выбран ни один режим, следует установить значение NONE.
`currentFoodPreset`	Нить	Описывает текущее приготовление пищи на устройстве из списка атрибута `foodPresets` . Можно указать только один продукт. Если в настоящее время еда не выбрана, следует установить значение NONE.
`currentFoodQuantity`	Число	Определяет текущее количество приготовленной пищи, связанное с `currentFoodUnit` , если количество было указано. Не следует сообщать, если в данный момент ничего не готовится или если с этой предустановкой продуктов не связано количество.
`currentFoodUnit`	Нить	Единица, связанная с `currentFoodQuantity` , из списка атрибута `supported_units` .

Примеры

Моя духовка готовит?

{
  "currentCookingMode": "BAKE"
}

Что сейчас готовится в моей рисоварке?

{
  "currentCookingMode": "COOK",
  "currentFoodPreset": "brown_rice",
  "currentFoodQuantity": 2,
  "currentFoodUnit": "CUPS"
}

КОМАНДЫ устройства

`action.devices.commands.Cook`

Начать или остановить приготовление.

Параметры

Параметры	Тип	Описание
`start`	логический	Необходимый. True, чтобы начать приготовление, false, чтобы остановить текущий режим приготовления.
`cookingMode`	Нить	Запрошенный режим приготовления для устройства из атрибута `supportedCookingModes` .
`foodPreset`	Нить	Имя предустановки еды, запрошенное пользователем, из атрибута `foodPresets` .
`quantity`	Число	Количество еды, запрошенное пользователем.
`unit`	Нить	Единица, связанная с `quantity` , из атрибута `supported_units` .

Примеры

Начинайте печь в моей духовке.

{
  "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 — пользователь запросил предустановку еды, не поддерживаемую устройством.