Schéma des traits de cuisine des maisons connectées

action.devices.traits.Cook : cette caractéristique appartient aux appareils capables de cuire des aliments selon divers préréglages et modes de cuisson.

(par exemple, Multicooker, Pressure cooker, Blender et Microwave). Les commandes de cuisson peuvent inclure la quantité et le nom des aliments, par exemple "Deux tasses de riz brun", où "riz brun" est un préréglage d'aliment pour l'appareil.

Cette caractéristique ne gère ni le temps de cuisson, ni la température de cuisson. Pour en savoir plus, consultez Timer et TemperatureControl.

Attributs d'appareil

Les appareils dotés de cette caractéristique peuvent signaler les attributs suivants dans le cadre de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez la section Traitement des intents.

Attributs	Type	Description
supportedCookingModes	Array	Obligatoire. Modes de cuisine compatibles avec cet appareil.
[item, ...]	String	Mode cuisine. Valeurs acceptées : 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	Préréglages pour certains types d'aliments
[item, ...]	Objet	Aliments prédéfinis.
food_preset_name	String	Obligatoire. Nom interne du préréglage d'aliment, qui sera utilisé dans les commandes et les états. Ce nom peut être non convivial et est partagé dans toutes les langues.
supported_units	Array	Obligatoire. Contient toutes les unités acceptées par l'appareil pour un aliment spécifique.
[item, ...]	String	Unité prise en charge. Valeurs acceptées : 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	Obligatoire. Synonymes de nom d'aliment pour le préréglage dans chaque langue disponible.
[item, ...]	Objet	Nom de l'aliment.
synonym	Array	Obligatoire. Les synonymes du préréglage doivent inclure les formes au pluriel et au singulier, le cas échéant.
[item, ...]	String	Nom du synonyme prédéfini.
lang	String	Obligatoire. Code de langue (ISO 639-1). Consultez la liste des langues acceptées.

Exemples

Appareil avec un seul mode de cuisson et pas de préréglage.

{
  "supportedCookingModes": [
    "BAKE"
  ]
}

Appareil avec plusieurs modes de cuisson et préréglages d'aliments.

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

Device STATES

Les entités dotées de cette caractéristique peuvent signaler les états suivants dans le cadre de l'opération QUERY. Pour en savoir plus sur la gestion des intents QUERY, consultez la section Traitement des intents.

États	Type	Description
currentCookingMode	String	Obligatoire. Décrit le mode de cuisson actuel défini sur l'appareil, à partir de la liste de l'attribut supportedCookingModes. Un seul mode peut être signalé. Si aucun mode n'est actuellement sélectionné, cette option doit être définie sur "AUCUN".
currentFoodPreset	String	Décrit la cuisson actuelle des aliments sur l'appareil, à partir de la liste de l'attribut foodPresets. Un seul aliment peut être signalé. Si aucun aliment n'est actuellement sélectionné, ce paramètre doit être défini sur AUCUN.
currentFoodQuantity	Number	Définit la quantité actuelle de cuisson associée à l'élément currentFoodUnit, si une quantité a été spécifiée. Ne doit pas être signalé si rien n'est en train de cuire ou si aucune quantité n'est associée à ce préréglage.
currentFoodUnit	String	Unité associée à currentFoodQuantity, dans la liste de l'attribut supported_units.

Exemples

Mon four est-il en train de cuire ?

{
  "currentCookingMode": "BAKE"
}

Qu'est-ce qui est en train de cuisiner dans mon cuiseur de riz ?

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

COMMANDS d'appareil

Les appareils dotés de cette caractéristique peuvent répondre aux commandes suivantes dans le cadre de l'opération EXECUTE. Pour en savoir plus sur la gestion des intents EXECUTE, consultez la section Traitement des intents.

action.devices.commands.Cook

Démarrer ou arrêter la cuisson.

Paramètres

Paramètres	Type	Description
start	Booléen	Obligatoire. "True" pour démarrer la cuisson, "false" pour arrêter le mode cuisine en cours.
cookingMode	String	Mode cuisine demandé pour l'appareil, à partir de l'attribut supportedCookingModes.
foodPreset	String	Nom du préréglage d'aliment demandé par l'utilisateur, provenant de l'attribut foodPresets.
quantity	Number	Quantité de nourriture demandée par l'utilisateur.
unit	String	Unité associée à l'attribut quantity de supported_units.

Exemples

Lance la cuisson dans mon four.

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

Arrête la cuisson dans mon four.

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

Commencez à cuire 2 tasses de riz blanc dans mon cuiseur à riz.

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

ERREURS sur l'appareil

Consultez la liste complète des erreurs et exceptions.

• deviceDoorOpen : la porte de l'appareil est ouverte.
• deviceLidOpen : le capot de l'appareil est ouvert.
• fractionalAmountNotSupported : l'utilisateur a demandé une fraction partielle pour ce préréglage, mais elle n'est pas compatible avec cet appareil.
• amountAboveLimit : l'utilisateur a demandé une quantité supérieure à la valeur maximale.
• unknownFoodPreset : l'utilisateur a demandé un préréglage d'aliment qui n'est pas compatible avec l'appareil.