Esquema de características da casa inteligente

action.devices.traits.Cook: essa característica pertence a dispositivos que podem cozinhar alimentos de acordo com várias predefinições de alimentos e os modos de cozimento compatíveis.

Os exemplos desses tipos de dispositivo incluem Multicooker, Cozinhador de pressão, Liquidificador e Micro-ondas. Esses comandos podem incluir a quantidade e o nome da comida, como "duas xícaras de arroz integral", em que "arroz integral" é uma predefinição para o dispositivo.

Essa característica não processa o tempo nem a temperatura de cozimento. Consulte Timer e TemperatureControl para mais informações.

ATRIBUTOS DO DISPOSITIVO

Dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC. Para saber mais sobre como processar intents SYNC, consulte fulfillment de intent.

Atributos	Tipo	Descrição
supportedCookingModes	Array	Obrigatório. Modos de cozimento compatíveis com este dispositivo.
[item, ...]	String	Modo de cozimento. Os valores suportados são: 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	Array	Predefinições para certos tipos de alimentos.
[item, ...]	Object	Predefinição de alimentos.
food_preset_name	String	Obrigatório. Nome interno da predefinição de alimentos, que será usado em comandos e estados. Esse nome não é fácil de usar e é compartilhado em todos os idiomas.
supported_units	Array	Obrigatório. Contém todas as unidades compatíveis com o dispositivo de um alimento específico.
[item, ...]	String	Unidade com suporte. Os valores suportados são: 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	Array	Obrigatório. São sinônimos de nomes de alimentos para a predefinição em cada idioma com suporte.
[item, ...]	Object	Nome do alimento.
synonym	Array	Obrigatório. Sinônimos para a predefinição, devem incluir formas no singular e no plural, se aplicável.
[item, ...]	String	Nome de sinônimos predefinido.
lang	String	Obrigatório. Código do idioma (ISO 639-1). Consulte os idiomas compatíveis.

Exemplos

Dispositivo com apenas um modo de cozinha e sem predefinição.

{
  "supportedCookingModes": [
    "BAKE"
  ]
}

Um dispositivo com vários modos de cozimento e predefinições de alimentos.

{
  "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"
        }
      ]
    }
  ]
}

STATES do dispositivo

Entidades com essa característica podem relatar os estados a seguir como parte da operação QUERY. Para saber mais sobre como processar intents QUERY, consulte fulfillment de intent.

Estados	Tipo	Descrição
currentCookingMode	String	Obrigatório. Descreve o modo de cozimento atual definido no dispositivo, na lista do atributo supportedCookingModes. Apenas um modo pode ser informado. Se nenhum modo estiver selecionado, ele vai ser definido como NENHUM.
currentFoodPreset	String	Descreve a culinária atual do dispositivo na lista do atributo foodPresets. Apenas um alimento pode ser informado. Se nenhum alimento for selecionado, este valor deverá ser definido como NENHUM.
currentFoodQuantity	Número	Define a quantidade atual de culinária associada ao currentFoodUnit, se uma quantidade tiver sido especificada. Não deve ser informado se não houver nada cozinhando ou se não houver quantidade associada a esta predefinição para alimentos.
currentFoodUnit	String	A unidade associada ao currentFoodQuantity, na lista do atributo supported_units.

Exemplos

Meu forno está cozinhando?

{
  "currentCookingMode": "BAKE"
}

O que está cozinhando no meu panela de arroz agora?

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

Comandos do dispositivo

Dispositivos com essa característica podem responder aos seguintes comandos como parte da operação EXECUTE. Para saber mais sobre como processar intents EXECUTE, consulte fulfillment de intent.

action.devices.commands.Cook

Inicie ou pare de cozinhar.

Parâmetros

Parâmetros	Tipo	Descrição
start	Booleano	Obrigatório. Verdadeiro para começar a cozinhar ou para interromper o modo de cozimento atual.
cookingMode	String	Modo de cozimento solicitado para o dispositivo, do atributo supportedCookingModes.
foodPreset	String	O nome da predefinição de alimentos solicitada pelo usuário, do atributo foodPresets.
quantity	Número	A quantidade de alimento solicitada pelo usuário.
unit	String	A unidade associada à quantity do atributo supported_units.

Exemplos

Começar a cozinhar no forno.

{
  "command": "action.devices.commands.Cook",
  "params": {
    "start": true,
    "cookingMode": "BAKE"
  }
}

Pare de assar no meu forno.

{
  "command": "action.devices.commands.Cook",
  "params": {
    "start": false,
    "cookingMode": "BAKE"
  }
}

Comece a cozinhar duas xícaras de arroz branco no meu panela de arroz.

{
  "command": "action.devices.commands.Cook",
  "params": {
    "start": true,
    "cookingMode": "COOK",
    "foodPreset": "white_rice",
    "quantity": 2,
    "unit": "CUPS"
  }
}

Dispositivo ERRORS

Veja a lista completa de erros e exceções.

• deviceDoorOpen: a porta do dispositivo está aberta.
• deviceLidOpen: a tampa do dispositivo está aberta.
• fractionalAmountNotSupported: o usuário solicitou uma quantidade fracionária para esta predefinição de alimentos, mas não é compatível com este dispositivo.
• amountAboveLimit: o usuário solicitou uma quantidade acima do máximo.
• unknownFoodPreset: o usuário solicitou uma predefinição para alimentos não compatível com o dispositivo.