Schema dell'attributo Smart Home Cook

action.devices.traits.Cook: questo attributo appartiene ai dispositivi che possono cucinare in base a vari programmi preimpostati per alimenti e modalità di cottura supportate.

Esempi di questi tipi di dispositivi sono Multicooker, Pressure cooker, Blender e Microwave. I comandi di cottura possono includere la quantità e il nome dell'alimento, ad esempio "Due tazze di riso integrale", dove "riso integrale" è un alimento preimpostato per il dispositivo.

Questo attributo non gestisce il tempo di cottura o la temperatura di cottura. Per ulteriori informazioni, consulta Timer e TemperatureControl.

ATTRIBUTI del dispositivo

I dispositivi con questa caratteristica possono segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta Completamento dell'intent.

Attributi	Tipo	Descrizione
supportedCookingModes	Array	Obbligatorio. Modalità di cottura supportate da questo dispositivo.
[item, ...]	String	Modalità Cucina. 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 alimenti.
[item, ...]	Oggetto	Preimpostazione per i cibi.
food_preset_name	String	Obbligatorio. Nome interno del preset per i cibi, che verrà utilizzato nei comandi e negli stati. Questo nome può non essere user-friendly ed è condiviso in tutte le lingue.
supported_units	Array	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	Array	Obbligatorio. Sinonimi dei nomi dei cibi per la preimpostazione in ogni lingua supportata.
[item, ...]	Oggetto	Nome dell'alimento.
synonym	Array	Obbligatorio. I sinonimi per il preset devono includere sia le forme singolari che quelle plurali, se applicabili.
[item, ...]	String	Nome del sinonimo preimpostato.
lang	String	Obbligatorio. Codice lingua (ISO 639-1). Consulta le lingue supportate.

Esempi

Dispositivo con una sola modalità di cottura e nessun preset.

{
  "supportedCookingModes": [
    "BAKE"
  ]
}

Dispositivo con più modalità di cottura e programmi preimpostati per 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"
        }
      ]
    }
  ]
}

STATI del dispositivo

Le entità con questo attributo possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per scoprire di più sulla gestione degli intent QUERY, consulta Adempimento degli intent.

Stati	Tipo	Descrizione
currentCookingMode	String	Obbligatorio. Descrive la modalità di cottura corrente impostata sul dispositivo, dall'attributo supportedCookingModes. È possibile segnalare una sola modalità. Se al momento non è selezionata alcuna modalità, questo valore deve essere impostato su NESSUNO.
currentFoodPreset	String	Il food_preset_name del cibo attualmente in cottura nel dispositivo, dall'attributo foodPresets. È possibile segnalare un solo alimento. Se al momento non è selezionato alcun alimento, questo valore deve essere impostato su NESSUNO.
currentFoodQuantity	Number	Definisce la quantità attuale di cottura dei cibi associata all'elemento currentFoodUnit, se è stata specificata una quantità. Non deve essere segnalato se al momento non è in cottura nulla o se non è associata alcuna quantità a questa preimpostazione di cibo.
currentFoodUnit	String	L'unità associata al currentFoodQuantity dall'elenco di supported_units del preset.

Esempi

Il mio forno è in fase di cottura?

{
  "currentCookingMode": "BAKE"
}

Cosa sto cucinando nella mia pentola per riso in questo momento?

{
  "currentCookingMode": "COOK",
  "currentFoodPreset": "brown_rice",
  "currentFoodQuantity": 2,
  "currentFoodUnit": "CUPS"
}

COMANDI del dispositivo

I dispositivi con questo tratto potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per scoprire di più sulla gestione degli intent EXECUTE, consulta Adempimento degli intent.

action.devices.commands.Cook

Avvia o interrompi la cottura.

Parametri

Parametri	Tipo	Descrizione
start	Valore booleano	Obbligatorio. Vero per avviare la cottura, false per interrompere la modalità di cottura corrente.
cookingMode	String	Modalità di cottura richiesta per il dispositivo dall'attributo supportedCookingModes.
foodPreset	String	Il nome della preimpostazione del cibo richiesta dall'utente, dall'attributo foodPresets.
quantity	Number	La quantità di cibo richiesta dall'utente.
unit	String	L'unità associata a quantity, dall'attributo supported_units.

Esempi

Inizia a cuocere nel mio forno.

{
  "command": "action.devices.commands.Cook",
  "params": {
    "start": true,
    "cookingMode": "BAKE"
  }
}

Smetti di cuocere nel mio forno.

{
  "command": "action.devices.commands.Cook",
  "params": {
    "start": false,
    "cookingMode": "BAKE"
  }
}

Inizio a cuocere 2 tazze di riso bianco nella pentola per riso.

{
  "command": "action.devices.commands.Cook",
  "params": {
    "start": true,
    "cookingMode": "COOK",
    "foodPreset": "white_rice",
    "quantity": 2,
    "unit": "CUPS"
  }
}

ERRORI del 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 questa preimpostazione per alimenti, ma non è supportata da questo dispositivo.
• amountAboveLimit: l'utente ha richiesto una quantità superiore al massimo.
• unknownFoodPreset - L'utente ha richiesto un programma predefinito per alimenti non supportato dal dispositivo.