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 :
|
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 :
|
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 |
currentFoodPreset |
String |
Décrit la cuisson actuelle des aliments sur l'appareil, à partir de la liste de l'attribut |
currentFoodQuantity |
Number |
Définit la quantité actuelle de cuisson associée à l'élément |
currentFoodUnit |
String |
Unité associée à |
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 |
foodPreset |
String |
Nom du préréglage d'aliment demandé par l'utilisateur, provenant de l'attribut |
quantity |
Number |
Quantité de nourriture demandée par l'utilisateur. |
unit |
String |
Unité associée à l'attribut |
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.