Bienvenue dans le centre Google Home pour les développeurs, la nouvelle destination pour apprendre à développer des actions pour la maison connectée. Remarque:Vous continuerez de créer des actions dans la console Actions.

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.

Voici quelques exemples de ces types d'appareils : Multicooker, Pressure cooker, Blender et Microwave. Les commandes de cuisson peuvent inclure la quantité et le nom les aliments, par exemple "Deux tasses de riz brun", où "riz brun" est un préréglage pour l’appareil.

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

ATTRIBUTS D'appareils

Les appareils présentant cette caractéristique peuvent signaler les éléments suivants : dans le cadre de l'opération SYNC. Pour apprendre Pour en savoir plus sur la gestion des intents SYNC, consultez Traitement des intents.

Attributs	Type	Description
`supportedCookingModes`	Array	Obligatoire. Modes de cuisson pris en charge par 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 de l'aliment.
`food_preset_name`	String	Obligatoire. Nom interne du préréglage, qui sera utilisé dans les commandes et les états. Ce nom peut ne pas être convivial et il est utilisé 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 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 de 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 des 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"
        }
      ]
    }
  ]
}

STATES de l'appareil

Les entités présentant cette caractéristique peuvent signaler les éléments suivants : dans le cadre de l'opération QUERY. Pour apprendre Pour en savoir plus sur la gestion des intents QUERY, consultez 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`. Un seul mode peut être signalé. Si aucun mode n'est actuellement sélectionné, cet indicateur doit être défini sur AUCUN.
`currentFoodPreset`	String	`food_preset_name` de l'aliment en cours de cuisson dans l'appareil, provenant 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é de plats actuellement cuits associés à l'élément `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 au `currentFoodQuantity`, dans la liste `supported_units` du préréglage.

Exemples

Est-ce que mon four cuisine ?

{
  "currentCookingMode": "BAKE"
}

Qu'est-ce qu'il y a dans mon cuiseur à riz en ce moment ?

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

COMMANDS d'appareils

Les appareils présentant cette caractéristique peuvent répondre aux éléments suivants : dans le cadre de l'opération EXECUTE. Pour apprendre Pour en savoir plus sur la gestion des intents EXECUTE, consultez Traitement des intents.

`action.devices.commands.Cook`

Démarrez ou arrêtez 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 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`, provenant de l'attribut `supported_units`.

Exemples

Lance la cuisson du four.

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

Arrête de faire cuire au 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 d'appareil

Voir la liste complète les erreurs et les exceptions.

deviceDoorOpen : la porte de l'appareil est ouverte.
deviceLidOpen : le capot de l'appareil est ouvert.
fractionalAmountNotSupported : l'utilisateur a demandé un montant fractionnaire pour cet article. le préréglage n'est pas pris en charge par cet appareil.
amountAboveLimit : l'utilisateur a demandé une quantité supérieure au maximum.
unknownFoodPreset : l'utilisateur a demandé un préréglage non compatible avec l'appareil.