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: 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	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: 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	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 supportedCookingModes. È possibile segnalare una sola modalità. Se al momento non è selezionata alcuna modalità, deve essere impostata su NONE.
currentFoodPreset	String	Descrive la cottura corrente nel dispositivo, dall'elenco dell'attributo foodPresets. È possibile segnalare un solo alimento. Se al momento non è selezionato alcun alimento, deve essere impostato su NONE.
currentFoodQuantity	Number	Definisce la quantità corrente di cottura degli alimenti associata a currentFoodUnit, se è stata specificata una quantità. Non deve essere indicato se non ci sono piatti in corso o se non è presente alcuna quantità associata a questa preimpostazione per alimenti.
currentFoodUnit	String	L'unità associata a currentFoodQuantity, dall'elenco dell'attributo supported_units.

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

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.