Schema tratto smart home

action.devices.traits.Cook: questa caratteristica appartiene ai dispositivi che possono cucinare gli alimenti in base alle diverse preimpostazioni alimentari e alle modalità di cottura supportate.

Alcuni esempi di questi tipi di dispositivi includono Multicooker, Pentola 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" è un preset di cibo per il dispositivo.

Questa caratteristica non gestisce il tempo di cottura o la temperatura di cottura. Per ulteriori informazioni, vedi Timer e TemperatureControl.

ATTRIBUTE di 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 fulfillment 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	Cibo preimpostato.
food_preset_name	Stringa	Obbligatorio. Nome interno del preset di cibo, 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, ...]	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 del nome dell'alimento per la preimpostazione in ogni lingua supportata.
[item, ...]	Oggetto	Nome del cibo.
synonym	Array	Obbligatorio. I sinonimi per il preset devono includere forme singolari e plurali, se applicabili.
[item, ...]	Stringa	Nome sinonimo preimpostato.
lang	Stringa	Obbligatorio. Codice lingua (ISO 639-1). Vedi le lingue supportate.

Esempi

Dispositivo con una sola modalità di cottura e nessuna temperatura preimpostata.

{
  "supportedCookingModes": [
    "BAKE"
  ]
}

Dispositivo con più modalità di cottura e preimpostazioni alimentari.

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

I dispositivi con questa caratteristica potrebbero segnalare i seguenti stati come parte dell'operazione QUERY. Per scoprire di più sulla gestione degli intent QUERY, consulta fulfillment degli intent.

Stati	Tipo	Descrizione
currentCookingMode	Stringa	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	Stringa	Descrive la cottura corrente del dispositivo 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 alimento associata al currentFoodUnit, se è stata specificata una quantità. Non deve essere segnalato se non è in corso la cottura o se non è associata alcuna quantità a questa temperatura preimpostata.
currentFoodUnit	Stringa	L'unità associata al currentFoodQuantity, dall'elenco dell'attributo supported_units.

Esempi

Il mio forno sta cucinando?

{
  "currentCookingMode": "BAKE"
}

Cosa sta cucinando nel mio cuociriso in questo momento?

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

COMANDI sul 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 fulfillment degli intent.

action.devices.commands.Cook

Inizia o interrompi la cottura.

Parametri

Parametri	Tipo	Descrizione
start	Booleano	Obbligatorio. Vero per iniziare a cucinare e falso per interrompere la modalità di cottura attuale.
cookingMode	Stringa	Modalità di cottura richiesta per il dispositivo dall'attributo supportedCookingModes.
foodPreset	Stringa	Il nome del piatto preimpostato richiesto 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 la cottura 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 nel cuociriso.

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

ERRORS dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.

• deviceDoorOpen - Lo sportello del dispositivo è aperto.
• deviceLidOpen: il coperchio del dispositivo è aperto.
• fractionalAmountNotSupported: l'utente ha richiesto una quantità frazionaria per questa preimpostazione, ma non è supportata da questo dispositivo.
• amountAboveLimit: l'utente ha richiesto una quantità superiore al valore massimo.
• unknownFoodPreset: l'utente ha richiesto una preimpostazione alimentare non supportata dal dispositivo.