Ti diamo il benvenuto nel Centro sviluppatori Google Home, la nuova destinazione per imparare a sviluppare azioni per la smart home. Nota:continuerai a creare azioni nella Console Actions.
Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

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.