Schema di Cook Trait per la smart home

action.devices.traits.Cook: questo tratto appartiene ai dispositivi in grado di cucinare cibo in base a varie preimpostazioni e modalità di cottura supportate.

Esempi di questi tipi di dispositivi sono Multicooker, Pressure cooker, Blender e Microwave. I comandi di cucina possono includere la quantità e il nome il cibo, ad esempio "Due tazze di riso integrale", dove "riso integrale" è una preimpostazione alimentare per il dispositivo.

Questa caratteristica non gestisce il tempo di cottura o la temperatura di cottura. Vedi Timer e TemperatureControl per ulteriori informazioni.

ATTRIBUTES dispositivo

I dispositivi con questo tratto potrebbero segnalare quanto segue nell'ambito dell'operazione SYNC. Per apprendere scopri 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 alcuni tipi di alimenti.
[item, ...]	Oggetto	Alimento preimpostato.
food_preset_name	String	Obbligatorio. Nome interno del preset alimento, che verrà utilizzato nei comandi e negli stati. Questo nome non può essere 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, ...]	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 di nomi di alimenti per la preimpostazione in tutte le lingue supportate.
[item, ...]	Oggetto	Nome alimento.
synonym	Array	Obbligatorio. I sinonimi per la preimpostazione devono includere sia le forme al singolare che al plurale, se applicabili.
[item, ...]	String	Nome sinonimo preimpostato.
lang	String	Obbligatorio. Codice lingua (ISO 639-1). Vedi le lingue supportate.

Esempi

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

{
  "supportedCookingModes": [
    "BAKE"
  ]
}

Dispositivo con diverse modalità di cottura e preset di cibo.

{
  "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 del dispositivo

Le entità con questo tratto possono segnalare quanto segue nell'ambito dell'operazione QUERY. Per ulteriori informazioni scopri di più sulla gestione degli intent QUERY; consulta Completamento dell'intent.

Stati	Tipo	Descrizione
currentCookingMode	String	Obbligatorio. Descrive l'attuale modalità di cottura impostata sul dispositivo dall'attributo supportedCookingModes. È possibile segnalare una sola modalità. Se al momento non è selezionata alcuna modalità, deve essere impostata su NONE.
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, deve essere impostato su NONE.
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 corso la cottura o se non ci sono quantità associate a questo cibo preimpostato.
currentFoodUnit	String	L'unità associata a 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 dispositivo

I dispositivi con questo tratto potrebbero rispondere ai seguenti nell'ambito dell'operazione EXECUTE. Per ulteriori informazioni scopri di più sulla gestione degli intent EXECUTE; consulta Completamento dell'intent.

action.devices.commands.Cook

Avviare o interrompere 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 del preset del cibo richiesto dall'utente, dall'attributo foodPresets.
quantity	Number	La quantità del cibo richiesto dall'utente.
unit	String	L'unità associata a quantity, dall'attributo supported_units.

Esempi

Inizia a cucinare nel forno.

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

Smetti di cucinare nel forno.

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

Inizia a cucinare 2 tazze di riso bianco nella mia pentola.

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

ERRORI dispositivo

Consulta l'elenco completo errori ed eccezioni.

• deviceDoorOpen: lo sportello del dispositivo è aperto.
• deviceLidOpen: il coperchio del dispositivo è aperto.
• fractionalAmountNotSupported - L'utente ha richiesto un importo frazionario cibo preimpostato, ma non è supportata da questo dispositivo.
• amountAboveLimit: l'utente ha richiesto una quantità superiore al limite massimo.
• unknownFoodPreset: l'utente ha richiesto una preimpostazione alimentare non supportata dal dispositivo.