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 på frysen

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.