Ti diamo il benvenuto nello Developer Center di Google Home, la nuova destinazione per scoprire come sviluppare azioni per la smart home.

Questa pagina è stata tradotta dall'API Cloud Translation.

Schema dell'attributo Smart Home Cook

action.devices.traits.Cook: questo attributo appartiene ai dispositivi che possono cucinare in base a vari programmi preimpostati per alimenti e modalità di cottura supportate.

Esempi di questi tipi di dispositivi sono Multicooker, Pressure cooker, Blender e Microwave. I comandi di cottura possono includere la quantità e il nome dell'alimento, ad esempio "Due tazze di riso integrale", dove "riso integrale" è un alimento preimpostato per il dispositivo.

Questo attributo non gestisce il tempo di cottura o la temperatura di cottura. Per ulteriori informazioni, consulta Timer e TemperatureControl.

ATTRIBUTI del dispositivo

I dispositivi con questa caratteristica possono segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per scoprire 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 determinati tipi di alimenti.
`[item, ...]`	Oggetto	Preimpostazione per i cibi.
`food_preset_name`	String	Obbligatorio. Nome interno del preset per i cibi, che verrà utilizzato nei comandi e negli stati. Questo nome può non essere user-friendly 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 dei nomi dei cibi per la preimpostazione in ogni lingua supportata.
`[item, ...]`	Oggetto	Nome dell'alimento.
`synonym`	Array	Obbligatorio. I sinonimi per il preset devono includere sia le forme singolari che quelle plurali, se applicabili.
`[item, ...]`	String	Nome del sinonimo preimpostato.
`lang`	String	Obbligatorio. Codice lingua (ISO 639-1). Consulta le lingue supportate.

Esempi

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

{
  "supportedCookingModes": [
    "BAKE"
  ]
}

Dispositivo con più modalità di cottura e programmi preimpostati per 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"
        }
      ]
    }
  ]
}

STATI del dispositivo

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

Stati	Tipo	Descrizione
`currentCookingMode`	String	Obbligatorio. Descrive la modalità di cottura corrente impostata sul dispositivo, dall'attributo `supportedCookingModes`. È possibile segnalare una sola modalità. Se al momento non è selezionata alcuna modalità, questo valore deve essere impostato su NESSUNO.
`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, questo valore deve essere impostato su NESSUNO.
`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 cottura nulla o se non è associata alcuna quantità a questa preimpostazione di cibo.
`currentFoodUnit`	String	L'unità associata al `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 del dispositivo

I dispositivi con questo tratto potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per scoprire di più sulla gestione degli intent EXECUTE, consulta Adempimento degli intent.

`action.devices.commands.Cook`

Avvia o interrompi 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 della preimpostazione del cibo richiesta dall'utente, dall'attributo `foodPresets`.
`quantity`	Number	La quantità di cibo richiesta dall'utente.
`unit`	String	L'unità associata a `quantity`, dall'attributo `supported_units`.

Esempi

Inizia a cuocere nel mio forno.

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

Smetti di cuocere nel mio forno.

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

Inizio a cuocere 2 tazze di riso bianco nella pentola per riso.

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

ERRORI del 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 questa preimpostazione per alimenti, ma non è supportata da questo dispositivo.
amountAboveLimit: l'utente ha richiesto una quantità superiore al massimo.
unknownFoodPreset - L'utente ha richiesto un programma predefinito per alimenti non supportato dal dispositivo.