Schema trattino di cucine smart
action.devices.traits.Cook
: questa caratteristica appartiene ai dispositivi che possono cucinare cibo in base a una serie di preimpostazioni di cibo e alle modalità di cottura supportate.
Esempi di questi tipi di dispositivi includono Multicooker, Cucina a pressione, Frullatore e Microonde. I comandi di cottura possono includere la quantità e il nome del cibo, ad esempio "Due tazze di riso integrale", dove il riso integrale è una preimpostazione predefinita per il dispositivo.
Questa caratteristica non gestisce il tempo di cottura o la temperatura di cottura. Per ulteriori informazioni, consulta la pagina Timer e TemperatureControl.
ATTRIBUTE del dispositivo
I dispositivi con questa caratteristica potrebbero segnalare i seguenti
attributi come parte dell'operazione SYNC
. Per scoprire di più sulla gestione degli intent SYNC
, consulta Soddisfazione degli intent.
Attributi | Tipo | Descrizione |
---|---|---|
supportedCookingModes |
Array |
Obbligatorio. Modalità di cottura supportate da questo dispositivo. |
[item, ...] |
Stringa |
Modalità di cottura. Valori supportati:
|
foodPresets |
Array |
Preimpostazioni per determinati tipi di cibo. |
[item, ...] |
Oggetto |
Preset alimenti. |
food_preset_name |
Stringa |
Obbligatorio. Nome interno del valore predefinito, che verrà utilizzato nei comandi e negli stati. Questo nome non è facile da usare ed è condiviso in tutte le lingue. |
supported_units |
Array |
Obbligatorio. Contiene tutte le unità supportate dal dispositivo per un alimento specifico. |
[item, ...] |
Stringa |
Unità supportata. Valori supportati:
|
food_synonyms |
Array |
Obbligatorio. Sinonimi dei nomi di cibo per la preimpostazione in ogni lingua supportata. |
[item, ...] |
Oggetto |
Nome alimento. |
synonym |
Array |
Obbligatorio. I sinonimi di preimpostazione devono includere forme al singolare e al plurale, se applicabili. |
[item, ...] |
Stringa |
Nome sinonimo preimpostato. |
lang |
Stringa |
Obbligatorio. Codice lingua (ISO 639-1). Scopri le lingue supportate. |
Esempi
Dispositivo con una sola modalità di cottura e nessuna temperatura preimpostata.
{ "supportedCookingModes": [ "BAKE" ] }
Dispositivo con diverse modalità di cottura e alimenti preimpostati.
{ "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 dispositivo
Le entità con questa caratteristica possono segnalare i seguenti stati nell'ambito dell'operazione QUERY
. Per scoprire di più sulla gestione degli intent QUERY
, consulta Soddisfazione degli intent.
Stati | Tipo | Descrizione |
---|---|---|
currentCookingMode |
Stringa |
Obbligatorio. Descrive la modalità di cottura attuale impostata sul dispositivo dall'attributo |
currentFoodPreset |
Stringa |
Descrive la cucina attuale del dispositivo nell'elenco dell'attributo |
currentFoodQuantity |
Number |
Definisce la quantità di cibo per la cottura dei piatti associata all' |
currentFoodUnit |
Stringa |
L'unità associata al |
Esempi
La cottura del forno è in corso?
{ "currentCookingMode": "BAKE" }
Cos'è al momento in cucina?
{ "currentCookingMode": "COOK", "currentFoodPreset": "brown_rice", "currentFoodQuantity": 2, "currentFoodUnit": "CUPS" }
comandi del dispositivo
I dispositivi con questa caratteristica possono rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE
. Per scoprire di più sulla gestione degli intent EXECUTE
, consulta Soddisfazione degli intent.
action.devices.commands.Cook
Inizia o interrompi la cottura.
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
start |
Booleano |
Obbligatorio. Vero per iniziare a cucinare, falso per interrompere la modalità di cottura attuale. |
cookingMode |
Stringa |
Hai richiesto la modalità di cottura del dispositivo dall'attributo |
foodPreset |
Stringa |
Il nome della preimpostazione alimentare richiesta dall'utente, dall'attributo |
quantity |
Number |
La quantità del cibo richiesta dall'utente. |
unit |
Stringa |
L'unità associata all'attributo |
Esempi
Inizia a cuocere in 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 due tazze di riso bianco nel mio cuociriso.
{ "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "COOK", "foodPreset": "white_rice", "quantity": 2, "unit": "CUPS" } }
ERRORI del dispositivo
Consulta l'elenco completo degli errori e delle eccezioni.deviceDoorOpen
: la porta del dispositivo è aperta.deviceLidOpen
: il coperchio del dispositivo è aperto.fractionalAmountNotSupported
: l'utente ha richiesto una quantità frazionaria di questo cibo predefinito, ma non è supportato da questo dispositivo.amountAboveLimit
: l'utente ha richiesto una quantità superiore al limite massimo.unknownFoodPreset
: l'utente ha richiesto un valore predefinito per il cibo non supportato dal dispositivo.