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.

Smart Home attiva/disattiva lo schema tratto

action.devices.traits.Toggles: questa caratteristica appartiene a qualsiasi dispositivo con impostazioni che possono esistere solo in uno dei due stati.

Queste impostazioni possono rappresentare un pulsante fisico con stato on/off oppure attivo/inattivo, una casella di controllo in HTML o qualsiasi altro tipo di elemento specificamente attivato/disattivato. Se l'impostazione ha più di due stati o ha uno stato in cui non è selezionata nessuna delle opzioni binarie, l'impostazione viene meglio rappresentata come una caratteristica di Modalità, che equivale a quadranti multi-stato, pulsanti di opzione (fisici o HTML) o stati binari non esplicitamente attivi/disattivati (ad esempio, "AM/FM" o "caldo/freddo").

Questo attributo copre uno o più pulsanti di attivazione/disattivazione individuali che gli utenti possono impostare. In generale, queste opzioni devono essere utilizzate per la funzionalità che non è collegata ad altri comportamenti dei dispositivi. I comportamenti collegati, ad esempio l'accensione o lo spegnimento del dispositivo stesso, devono usare caratteristiche più specifiche (ad es. 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
availableToggles Array

Obbligatorio.

Elenco di opzioni di attivazione/disattivazione disponibili.

[item, ...] Oggetto

Pulsante di attivazione/disattivazione disponibile.

name Stringa

Obbligatorio.

Nome interno dell'opzione, 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 dell'opzione in ciascuna lingua supportata.

[item, ...] Oggetto

Sinonimi dell'opzione in una data lingua.

name_synonym Array

Obbligatorio.

Sinonimi dell'opzione di attivazione/disattivazione. 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.

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

queryOnlyToggles 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ù pulsanti di attivazione/disattivazione.

{
  "availableToggles": [
    {
      "name": "sterilization_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Clean",
            "Bio clean"
          ],
          "lang": "en"
        }
      ]
    },
    {
      "name": "energysaving_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Energy saving",
            "Eco"
          ],
          "lang": "en"
        }
      ]
    }
  ]
}

Dispositivo con opzioni di attivazione/disattivazione solo per i comandi.

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Filtered",
            "Filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "commandOnlyToggles": true
}

Dispositivo con opzioni di attivazione/disattivazione solo per le query.

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Filtered",
            "Filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "queryOnlyToggles": true
}

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

Obbligatorio.

Coppia chiave/valore con l'opzione di attivazione/disattivazione name del dispositivo come chiave e stato attuale come valore.

<string> Booleano

Stato di attivazione/disattivazione attuale.

Esempi

La sterilizzazione è attiva?

{
  "currentToggleSettings": {
    "sterilization_toggle": true,
    "energysaving_toggle": false
  }
}

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

Imposta un determinato stato di attivazione/disattivazione.

Parametri

Parametri Tipo Descrizione
updateToggleSettings Oggetto

Obbligatorio.

Coppia chiave/valore con l'opzione di attivazione/disattivazione name del dispositivo come chiave e nuovo stato come valore.

<string> Booleano

Nuovo stato di attivazione/disattivazione

Esempi

Attiva il risparmio energetico.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "energysaving_toggle": true
    }
  }
}

Disattiva il filtro.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "filter_toggle": false
    }
  }
}

Esempi di frasi

de-DE

  • Bitte schalte Power Cool am Kühlschrank aus
  • stelle den Kühlschrank auf Power Cool

en-US

  • activate power freeze for the freezer
  • cancel power cool for the kitchen fridge

es-ES

  • pon el enfriamiento rápido en la nevera
  • quita el enfriamiento rápido

fr-FR

  • mets le mode power cool sur le réfrigérateur
  • Éteins le mode power freeze du réfrigérateur .

hi-IN

  • रेफ़्रिजरेटर का पावर कूल मोड बंद कर दो
  • रेफ़्रिजरेटर में पावर कूल मोड चालू करो

it-IT

  • disattiva il power freeze del freezer
  • imposta la funzione power freeze del surgelatore

ja-JP

  • 冷蔵庫 急速冷凍 つけて
  • 冷蔵庫 急速冷凍 を切ってくれる

ko-KR

  • 냉장고 급속 냉장 해제해
  • 냉장고 모드 급속 냉장 으로 바꿔

nl-NL

  • Zet de power cool uit op de koelkast
  • zet de koelkast op superkoelen

pt-BR

  • Ativa a função power freeze no congelador .
  • Desativa o bloqueio infantil do forno .
  • desligar o power cool da geladeira
  • iniciar o modo power freeze do freezer

sv-SE

  • Stäng av power cool i kylskåpet
  • sätt på power freeze frysen

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.