Bienvenue dans le Developer Center de Google Home, la nouvelle destination pour apprendre à développer des actions pour la maison connectée.

Cette page a été traduite par l'API Cloud Translation.

Schéma du trait de cuisson pour la maison connectée

action.devices.traits.Cook : ce trait appartient aux appareils qui peuvent cuire des aliments selon différents préréglages et modes de cuisson compatibles.

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

Ce trait ne gère pas le temps ni la température de cuisson. Pour en savoir plus, consultez Timer et TemperatureControl.

ATTRIBUTS de l'appareil

Les appareils dotés de ce trait peuvent signaler les attributs suivants dans le cadre de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez Fulfillment d'intent.

Attributs	Type	Description
`supportedCookingModes`	Array	Obligatoire. Modes de cuisson pris en charge par cet appareil.
`[item, ...]`	String	Mode de cuisson. 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	Préréglage "Nourriture".
`food_preset_name`	String	Obligatoire. Nom interne du préréglage alimentaire, qui sera utilisé dans les commandes et les états. Ce nom peut ne pas être facile à retenir pour les utilisateurs et est partagé dans toutes les langues.
`supported_units`	Array	Obligatoire. Contient toutes les unités prises en charge par l'appareil pour un aliment spécifique.
`[item, ...]`	String	Unité acceptée. 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 du nom de l'aliment pour le préréglage dans chaque langue acceptée.
`[item, ...]`	Objet	Nom de l'aliment. Au moins un élément avec une valeur `lang` de `en` est requis pour fournir une langue de secours.
`synonym`	Array	Obligatoire. Synonymes du préréglage, y compris les formes au singulier et au pluriel, le cas échéant.
`[item, ...]`	String	Nom du synonyme prédéfini. Au moins un élément avec une valeur `lang` de `en` est requis pour fournir une langue de secours.
`lang`	String	Obligatoire. Code de langue (ISO 639-1). Consultez la liste des langues disponibles.

Exemples

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

{
  "supportedCookingModes": [
    "BAKE"
  ]
}

Appareil avec plusieurs modes de cuisson et préréglages alimentaires.

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

ÉTATS des appareils

Les entités dotées de ce trait peuvent signaler les états suivants dans le cadre de l'opération QUERY. Pour en savoir plus sur la gestion des intents QUERY, consultez Fulfillment d'intent.

États	Type	Description
`currentCookingMode`	String	Obligatoire. Décrit le mode de cuisson actuellement défini sur l'appareil, à partir de l'attribut `supportedCookingModes`. Un seul mode peut être signalé. Si aucun mode n'est actuellement sélectionné, cette valeur doit être définie sur "NONE".
`currentFoodPreset`	String	`food_preset_name` de l'aliment en cours de cuisson dans l'appareil, à partir de l'attribut `foodPresets`. Vous ne pouvez signaler qu'un seul aliment. Si aucun aliment n'est actuellement sélectionné, cette valeur doit être définie sur "NONE" (AUCUN).
`currentFoodQuantity`	Number	Définit la quantité d'aliments en cours de cuisson associée à `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 d'aliment.
`currentFoodUnit`	String	Unité associée à `currentFoodQuantity`, à partir de la liste des `supported_units` du préréglage.

Exemples

Mon four est-il en train de cuire ?

{
  "currentCookingMode": "BAKE"
}

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

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

COMMANDES de l'appareil

Les appareils dotés de ce trait 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 Fulfillment d'intent.

`action.devices.commands.Cook`

Démarrer ou arrêter la cuisson.

Paramètres

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

Exemples

Lance la cuisson dans mon four.

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

Arrête de cuire dans mon four.

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

Commence à cuire deux 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 liées à l'appareil

Consultez la liste complète des erreurs et exceptions.

deviceDoorOpen : la porte de l'appareil est ouverte.
deviceLidOpen : le couvercle de l'appareil est ouvert.
fractionalAmountNotSupported : l'utilisateur a demandé une quantité fractionnée pour ce préréglage alimentaire, mais cela n'est pas pris en charge par cet appareil.
amountAboveLimit : l'utilisateur a demandé une quantité supérieure à la quantité maximale.
unknownFoodPreset : l'utilisateur a demandé un préréglage alimentaire non compatible avec l'appareil.