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 de tradition pour la maison connectée

action.devices.traits.Cook : cette caractéristique appartient aux appareils qui peuvent cuisiner des aliments selon différents préréglages et modes de cuisson pris en charge.

Exemples de types d'appareils : Multicooker, Pressure cooker, Blender et Microwave. Les commandes de cuisson peuvent inclure la quantité et le nom du plat, par exemple "Deux tasses de riz brun", où "riz brun" est un aliment prédéfini pour l'appareil.

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

ATTRIBUTS de l'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 cuisson 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	Préréglage alimentaire
`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 convivial et est partagé dans toutes les langues.
`supported_units`	Array	Obligatoire. Inclut toutes les unités compatibles avec 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 des noms d'aliments pour le préréglage dans chaque langue compatible.
`[item, ...]`	Objet	Nom de l'aliment.
`synonym`	Array	Obligatoire. Les synonymes du préréglage doivent inclure les formes au singulier et au pluriel, 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 aucun préréglage.

{
  "supportedCookingModes": [
    "BAKE"
  ]
}

Appareil avec plusieurs modes de cuisson et préréglages pour les 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"
        }
      ]
    }
  ]
}

ÉTATS DE L'APPAREIL

Les entités avec 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 l'attribut `supportedCookingModes`. Vous ne pouvez signaler qu'un seul mode. Si aucun mode n'est actuellement sélectionné, cet indicateur doit être défini sur AUCUN.
`currentFoodPreset`	String	`food_preset_name` du plat actuellement en cours de cuisson dans l'appareil, à partir de l'attribut `foodPresets`. Un seul aliment peut être signalé. Si aucun aliment n’est actuellement sélectionné, cet indicateur doit être défini sur AUCUN.
`currentFoodQuantity`	Number	Définit la quantité actuelle de nourriture 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 cours de cuisson ou si aucune quantité n'est associée à ce préréglage.
`currentFoodUnit`	String	Unité associée à `currentFoodQuantity`, à partir de la liste de `supported_units` du préréglage.

Exemples

Mon four est-il en train de cuire ?

{
  "currentCookingMode": "BAKE"
}

Que cuit-il dans mon cuiseur à riz en ce moment ?

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

COMMANDS d'appareils

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`	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 à l'attribut `quantity`, provenant de l'attribut `supported_units`.

Exemples

Commence à cuire dans mon four.

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

Arrêtez de cuire dans mon four.

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

Lance la cuisson de 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 de 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 quantité fractionnaire pour ce préréglage alimentaire, mais cet appareil n'est pas compatible avec cette valeur.
amountAboveLimit : l'utilisateur a demandé une quantité supérieure à la quantité maximale.
unknownFoodPreset : l'utilisateur a demandé un préréglage non compatible avec l'appareil.