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: 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	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: 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	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 supportedCookingModes. È possibile segnalare solo una modalità. Se al momento non è selezionata alcuna modalità, deve essere impostata su NONE.
currentFoodPreset	Stringa	Descrive la cucina attuale del dispositivo nell'elenco dell'attributo foodPresets. È possibile segnalare un solo alimento. Se al momento non è selezionato alcun alimento, è necessario impostare NONE.
currentFoodQuantity	Number	Definisce la quantità di cibo per la cottura dei piatti associata all'currentFoodUnit, se è stata specificata una quantità. Non deve essere segnalato se non è in corso la cottura o se non è presente alcuna quantità associata a questa impostazione predefinita per gli alimenti.
currentFoodUnit	Stringa	L'unità associata al currentFoodQuantity, dall'elenco dell'attributo supported_units.

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 supportedCookingModes.
foodPreset	Stringa	Il nome della preimpostazione alimentare richiesta dall'utente, dall'attributo foodPresets.
quantity	Number	La quantità del cibo richiesta dall'utente.
unit	Stringa	L'unità associata all'attributo quantity da supported_units.

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.