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 trattino di cucine smart

action.devices.traits.Cook: questa caratteristica appartiene ai dispositivi che possono cucinare cibo in base a una serie di preimpostazioni di cibo e alle modalità di cottura supportate.

Esempi di questi tipi di dispositivi includono Multicooker, Cucina 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 è una preimpostazione predefinita per il dispositivo.

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

ATTRIBUTE del 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 Soddisfazione 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

Preset alimenti.

food_preset_name Stringa

Obbligatorio.

Nome interno del valore predefinito, che verrà utilizzato nei comandi e negli stati. Questo nome non è 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 dei nomi di cibo per la preimpostazione in ogni lingua supportata.

[item, ...] Oggetto

Nome alimento.

synonym Array

Obbligatorio.

I sinonimi di preimpostazione devono includere forme al singolare e al plurale, se applicabili.

[item, ...] Stringa

Nome sinonimo preimpostato.

lang Stringa

Obbligatorio.

Codice lingua (ISO 639-1). Scopri le lingue supportate.

Esempi

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

{
  "supportedCookingModes": [
    "BAKE"
  ]
}

Dispositivo con diverse modalità di cottura e alimenti preimpostati.

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

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

Stati Tipo Descrizione
currentCookingMode Stringa

Obbligatorio.

Descrive la modalità di cottura attuale impostata sul dispositivo dall'attributo supportedCookingModes. È possibile segnalare solo una modalità. Se al momento non è selezionata alcuna modalità, deve essere impostata su NONE.

currentFoodPreset Stringa

Descrive la cucina attuale del dispositivo nell'elenco dell'attributo foodPresets. È possibile segnalare un solo alimento. Se al momento non è selezionato alcun alimento, è necessario impostare NONE.

currentFoodQuantity Number

Definisce la quantità di cibo per la cottura dei piatti associata all'currentFoodUnit, se è stata specificata una quantità. Non deve essere segnalato se non è in corso la cottura o se non è presente alcuna quantità associata a questa impostazione predefinita per gli alimenti.

currentFoodUnit Stringa

L'unità associata al currentFoodQuantity, dall'elenco dell'attributo supported_units.

Esempi

La cottura del forno è in corso?

{
  "currentCookingMode": "BAKE"
}

Cos'è al momento in cucina?

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

comandi del 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 Soddisfazione degli intent.

action.devices.commands.Cook

Inizia o interrompi la cottura.

Parametri

Parametri Tipo Descrizione
start Booleano

Obbligatorio.

Vero per iniziare a cucinare, falso per interrompere la modalità di cottura attuale.

cookingMode Stringa

Hai richiesto la modalità di cottura del dispositivo dall'attributo supportedCookingModes.

foodPreset Stringa

Il nome della preimpostazione alimentare richiesta 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 a cuocere in 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 due tazze di riso bianco nel mio cuociriso.

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

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.
  • deviceDoorOpen: la porta del dispositivo è aperta.
  • deviceLidOpen: il coperchio del dispositivo è aperto.
  • fractionalAmountNotSupported: l'utente ha richiesto una quantità frazionaria di questo cibo predefinito, ma non è supportato da questo dispositivo.
  • amountAboveLimit: l'utente ha richiesto una quantità superiore al limite massimo.
  • unknownFoodPreset: l'utente ha richiesto un valore predefinito per il cibo non supportato dal dispositivo.