Schema delle caratteristiche di cucina per la smart home
action.devices.traits.Cook
- Questa caratteristica appartiene ai dispositivi in grado di cuocere gli alimenti in base a varie preimpostazioni e modalità di cottura supportate.
Esempi di questi tipi di dispositivi includono Multicooker, Pressure cooker, Blender e Microwave. I comandi di cucina possono includere la quantità e il nome del alimento, ad esempio "Due tazze di riso integrale", dove "riso integrale" è un alimento preimpostato per il dispositivo.
Questa caratteristica non gestisce il tempo di cottura o la temperatura di cottura. Per ulteriori informazioni, visita le pagine Timer e TemperatureControl.
ATTRIBUTES del dispositivo
I dispositivi con questo trait potrebbero segnalare i seguenti attributi nell'ambito dell'operazione SYNC
. Per scoprire di più sulla gestione degli intent SYNC
, consulta fulfillment dell'intent.
Attributi | Tipo | Descrizione |
---|---|---|
supportedCookingModes |
Matrice |
Obbligatorio. Modalità di cucina supportate da questo dispositivo. |
[item, ...] |
String |
Modalità di cottura. Valori supportati:
|
foodPresets |
Matrice |
Preimpostazioni per alcuni tipi di alimenti. |
[item, ...] |
Oggetto |
Preimpostazione alimenti. |
food_preset_name |
String |
Obbligatorio. Nome interno della preimpostazione per alimenti, che verrà utilizzato nei comandi e negli stati. Questo nome non può essere intuitivo e viene condiviso in tutte le lingue. |
supported_units |
Matrice |
Obbligatorio. Contiene tutte le unità supportate dal dispositivo per un alimento specifico. |
[item, ...] |
String |
Unità supportata. Valori supportati:
|
food_synonyms |
Matrice |
Obbligatorio. Sinonimi del nome dell'alimento per la preimpostazione in ogni lingua supportata. |
[item, ...] |
Oggetto |
Nome alimento. |
synonym |
Matrice |
Obbligatorio. Sinonimi della preimpostazione, che devono includere sia il singolare che il plurale, se applicabile. |
[item, ...] |
String |
Nome sinonimo preimpostato. |
lang |
String |
Obbligatorio. Codice lingua (ISO 639-1). Consulta le lingue supportate. |
Esempi
Dispositivo con una sola modalità di cottura e nessuna preimpostazione.
{ "supportedCookingModes": [ "BAKE" ] }
Dispositivo con più modalità di cottura e preimpostazioni per gli alimenti.
{ "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" } ] } ] }
Dispositivo STATES
Le entità con questo trait possono segnalare i seguenti
stati nell'ambito dell'operazione QUERY
. Per scoprire di più sulla gestione degli intent QUERY
, consulta fulfillment dell'intent.
Stati | Tipo | Descrizione |
---|---|---|
currentCookingMode |
String |
Obbligatorio. Descrive la modalità di cottura corrente impostata sul dispositivo, dall'elenco dell'attributo |
currentFoodPreset |
String |
Descrive la cottura corrente nel dispositivo, dall'elenco dell'attributo |
currentFoodQuantity |
Number |
Definisce la quantità corrente di cottura degli alimenti associata a |
currentFoodUnit |
String |
L'unità associata a |
Esempi
Il mio forno cucina?
{ "currentCookingMode": "BAKE" }
Cosa c'è in cucina nel mio cuociriso in questo momento?
{ "currentCookingMode": "COOK", "currentFoodPreset": "brown_rice", "currentFoodQuantity": 2, "currentFoodUnit": "CUPS" }
COMMANDS dispositivo
I dispositivi con questa caratteristica potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE
. Per scoprire di più sulla gestione degli intent EXECUTE
, consulta fulfillment dell'intent.
action.devices.commands.Cook
Avviare o interrompere la cottura.
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
start |
Booleano |
Obbligatorio. Vero per avviare la cottura, falso per interrompere la modalità di cottura in corso. |
cookingMode |
String |
Modalità di cottura richiesta per il dispositivo, dall'attributo |
foodPreset |
String |
Il nome della preimpostazione alimentare richiesta dall'utente, dall'attributo |
quantity |
Number |
La quantità di cibo richiesta dall'utente. |
unit |
String |
L'unità associata all'attributo |
Esempi
Iniziare a cuocere nel forno.
{ "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "BAKE" } }
Smetti di cuocere in forno.
{ "command": "action.devices.commands.Cook", "params": { "start": false, "cookingMode": "BAKE" } }
Inizia a cucinare 2 tazze di riso bianco nella pentola per il riso.
{ "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "COOK", "foodPreset": "white_rice", "quantity": 2, "unit": "CUPS" } }
ERRORS dispositivo
Consulta l'elenco completo di errori ed eccezioni.deviceDoorOpen
: lo sportello del dispositivo è aperto.deviceLidOpen
: il coperchio del dispositivo è aperto.fractionalAmountNotSupported
: l'utente ha richiesto una frazione frazionaria per questo cibo prestabilito, ma l'importo non è supportato da questo dispositivo.amountAboveLimit
: l'utente ha richiesto una quantità superiore al limite massimo.unknownFoodPreset
: l'utente ha richiesto una preimpostazione per alimenti non supportata dal dispositivo.