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.