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 modalità Smart Home

action.devices.traits.Modes: questa caratteristica è valida per tutte le modalità e le impostazioni specifiche della modalità disponibili per un dispositivo.

Questo attributo appartiene a qualsiasi dispositivo con un numero arbitrario di modalità "n-way" in cui le modalità e le impostazioni di ogni modalità sono arbitrarie e univoche per ogni dispositivo o tipo di dispositivo. Ogni modalità ha più impostazioni possibili, ma è possibile selezionarne solo una alla volta. L'asciugatrice non può essere in modalità "delicata", "normale" e "ad alta intensità" contemporaneamente. Un'impostazione che può essere semplicemente attivata o disattivata appartiene alla sezione Attiva/disattiva.

Ad esempio, una lavatrice può avere impostazioni per la dimensione e la temperatura di carico. Entrambe sarebbero modalità perché sono indipendenti l'una dall'altra, ma ognuna può essere in un solo stato alla volta. L'utente può impostare una modalità come la temperatura in modo esplicito con un comando come Imposta la temperatura della lavatrice su freddo.

Alcune modalità sono "ordinate" e possono anche essere regolate con aumento/riduzione, aumento/riduzione della frase. Ad esempio, le dimensioni del carico (piccolo, medio, grande) e la temperatura sono ordinate in modo chiaro (tieni presente che la temperatura non è un termostato reale con target numerico, come su altri dispositivi), ma il tipo di carico (delicati, normali, lana e così via) potrebbe non esserlo.

Questa caratteristica copre una o più modalità individuali che gli utenti possono impostare. In generale, queste modalità dovrebbero essere utilizzate per la funzionalità che è scollegata dal comportamento di un altro dispositivo. Per quanto riguarda il comportamento collegato, ad esempio l'accensione o lo spegnimento del dispositivo, devi utilizzare caratteristiche più specifiche (ad es. la proprietà thermostatMode nella sezione TemperatureSetting).

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
availableModes Array

Obbligatorio.

Elenco delle modalità disponibili.

[item, ...] Oggetto

Modalità disponibile.

name Stringa

Obbligatorio.

Nome interno della modalità, che verrà utilizzato nei comandi e negli stati. Questa funzionalità non è facile da usare e verrà condivisa in tutte le lingue.

name_values Array

Obbligatorio.

Sinonimi della modalità in tutte le lingue supportate.

[item, ...] Oggetto

Sinonimi della modalità in una determinata lingua.

name_synonym Array

Obbligatorio.

Sinonimi della modalità. La prima stringa dell'elenco viene utilizzata come nome canonico del livello in quella lingua.

[item, ...] Stringa

Nome sinonimo.

lang Stringa

Obbligatorio.

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

settings Array

Obbligatorio.

Impostazioni supportate per questa modalità.

[item, ...] Oggetto

Impostazione supportata.

Richiede almeno due elementi.

setting_name Stringa

Obbligatorio.

Nome interno dell'impostazione della modalità, che verrà utilizzato nei comandi e negli stati. Questa funzionalità non è facile da usare e verrà condivisa in tutte le lingue.

setting_values Array

Obbligatorio.

Sinonimi dell'impostazione in tutte le lingue supportate.

[item, ...] Oggetto

Sinonimi dell'impostazione in una determinata lingua.

setting_synonym Array

Obbligatorio.

Sinonimi dell'impostazione. La prima stringa dell'elenco viene utilizzata come nome canonico del livello in quella lingua.

[item, ...] Stringa

Nome sinonimo.

lang Stringa

Obbligatorio.

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

ordered Booleano

(Valore predefinito: false)

Se è impostato su true, verrà applicata una grammatica aggiuntiva per la logica di aumento/diminuzione, nell'ordine (aumento) della matrice di impostazioni.

commandOnlyModes Booleano

(Valore predefinito: false)

Indica se il dispositivo supporta la comunicazione unidirezionale (vero) o bidirezionale (falso). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a uno stato del report per questa caratteristica.

queryOnlyModes Booleano

(Valore predefinito: false)

Obbligatorio se il dispositivo supporta l'esecuzione di sole query. Questo attributo indica se è possibile eseguire query su un dispositivo solo per avere informazioni sullo stato e non è possibile controllarlo.

Esempi

Dispositivo con più modalità e impostazioni.

{
  "availableModes": [
    {
      "name": "load_mode",
      "name_values": [
        {
          "name_synonym": [
            "Load",
            "Size",
            "Load size"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "small_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Small",
                "Half"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "medium_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Medium",
                "Normal"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "large_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Large",
                "Full"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": true
    },
    {
      "name": "temp_mode",
      "name_values": [
        {
          "name_synonym": [
            "Temperature",
            "Temp"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "hot_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Hot",
                "White"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "warm_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Warm",
                "Color"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "cold_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Cold",
                "Delicate"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ]
}

Dispositivo con modalità di solo comando.

{
  "availableModes": [
    {
      "name": "light_mode",
      "name_values": [
        {
          "name_synonym": [
            "Light",
            "Lighting"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "day_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Day",
                "Bright"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "night_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Night",
                "Dark"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "reading_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Reading",
                "Ambiant"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ],
  "commandOnlyModes": true,
  "queryOnlyModes": false
}

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
currentModeSettings Oggetto

Obbligatorio.

Coppia chiave-valore con la modalità name del dispositivo come chiave e setting_name corrente come valore.

<string> Stringa

Attuale: setting_name.

Esempi

In quale modalità si trova il dispositivo?

{
  "currentModeSettings": {
    "load_mode": "small_load",
    "temp_mode": "cold_temp"
  }
}

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.SetModes

Aggiorna le impostazioni della modalità.

Parametri

Parametri Tipo Descrizione
updateModeSettings Oggetto

Obbligatorio.

Coppia chiave/valore con la modalità name del dispositivo come chiave e la nuova setting_name come valore.

<string> Stringa

Nuovo setting_name.

Esempi

Imposta il carico di grandi dimensioni.

{
  "command": "action.devices.commands.SetModes",
  "params": {
    "updateModeSettings": {
      "load_mode": "large_load"
    }
  }
}

Esempi di frasi

de-DE

  • Stelle den Staubsauger auf Ruhemodus

en-US

  • set the vacuum to energy saver mode

es-ES

  • pon la lavadora en modo frío

fr-FR

  • mets l'aspirateur en silencieux

hi-IN

  • वैक्यूम पर कार्पेट मोड लगाएं

it-IT

  • imposta l'aspirapolvere su silenzioso

ja-JP

  • 掃除機 静音 モードに設定して

ko-KR

  • 세탁기 세탁량 많음 으로 설정해

pt-BR

  • acionar a função autolimpeza do aspirador
  • ligar o modo de aquecimento

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.