Добро пожаловать в Центр разработчиков Google Home, новое место, где можно научиться разрабатывать действия для умного дома. Примечание. Вы продолжите создавать действия в консоли действий.
Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

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

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

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