Schema dei tratti di attivazione/disattivazione della smart home

action.devices.traits.Toggles: questo tratto appartiene a tutti i dispositivi con impostazioni che possono esistere solo in uno dei due stati.

Queste impostazioni possono rappresentare un pulsante fisico con attivazione/disattivazione o attivo/non attivo una casella di controllo in HTML o qualsiasi altro tipo di attivazione/disattivazione specificatamente . Se l'impostazione ha più di due stati o uno stato in cui nessuna delle due opzioni binarie è selezionata, è meglio rappresentata Modes, che equivale a quadranti multistato, pulsanti di opzione (fisici o HTML) o stati binari che non sono on/off (ad esempio, "AM/FM" o "caldo/freddo").

Questa trait copre uno o più pulsanti di attivazione/disattivazione individuali che gli utenti possono impostare. Nella in generale, queste opzioni di attivazione/disattivazione dovrebbero essere utilizzate per le funzionalità scollegate da un altro comportamento del dispositivo. Comportamento collegato, ad esempio la rotazione dello stesso dispositivo attivare o disattivare, devono usare tratti più specifici (ad esempio, thermostatMode nel trait TemperatureSetting).

ATTRIBUTES dispositivo

I dispositivi con questo tratto potrebbero segnalare quanto segue nell'ambito dell'operazione SYNC. Per ulteriori informazioni scopri di più sulla gestione degli intent SYNC; consulta Completamento dell'intent.

Attributi	Tipo	Descrizione
availableToggles	Array	Obbligatorio. Elenco delle opzioni di attivazione/disattivazione disponibili.
[item, ...]	Oggetto	Pulsante di attivazione/disattivazione Disponibile.
name	String	Obbligatorio. Nome interno del pulsante di attivazione/disattivazione, che verrà utilizzato nei comandi e negli stati. Questi dati non sono facili da usare e verranno condivisi in tutte le lingue.
name_values	Array	Obbligatorio. Sinonimi del pulsante di attivazione/disattivazione in tutte le lingue supportate.
[item, ...]	Oggetto	Sinonimi del pulsante di attivazione/disattivazione in una determinata lingua.
name_synonym	Array	Obbligatorio. Sinonimi del pulsante di attivazione/disattivazione. La prima stringa di questo elenco viene utilizzata come nome canonico del livello nella lingua in questione.
[item, ...]	String	Nome sinonimo.
lang	String	Obbligatorio. Codice lingua (ISO 639-1). Vedi le lingue supportate.
commandOnlyToggles	Valore booleano	(Valore predefinito: false) Indica se il dispositivo supporta la comunicazione unidirezionale (vero) o bidirezionale (false). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a Segnalare lo stato per questo tratto.
queryOnlyToggles	Valore booleano	(Valore predefinito: false) Obbligatorio se il dispositivo supporta l'esecuzione solo di query. Questo attributo indica se sul dispositivo è possibile eseguire query solo per informazioni sullo stato e se non può essere controllato.

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 dei comandi.

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

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

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

STATES del dispositivo

Le entità con questo tratto possono segnalare quanto segue nell'ambito dell'operazione QUERY. Per ulteriori informazioni scopri di più sulla gestione degli intent QUERY; consulta Completamento dell'intent.

Stati	Tipo	Descrizione
currentToggleSettings	Oggetto	Obbligatorio. Coppia chiave-valore con il pulsante di attivazione/disattivazione name del dispositivo come chiave e lo stato attuale come valore.
<string>	Valore booleano	Stato attuale dell'opzione di attivazione/disattivazione.

Esempi

La sterilizzazione è attiva?

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

COMANDI dispositivo

I dispositivi con questo tratto potrebbero rispondere ai seguenti nell'ambito dell'operazione EXECUTE. Per ulteriori informazioni scopri di più sulla gestione degli intent EXECUTE; consulta Completamento dell'intent.

action.devices.commands.SetToggles

Imposta un determinato stato di attivazione/disattivazione.

Parametri

Parametri	Tipo	Descrizione
updateToggleSettings	Oggetto	Obbligatorio. Coppia chiave/valore con il pulsante di attivazione/disattivazione name del dispositivo come chiave e il nuovo stato come valore.
<string>	Valore 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 enunciato

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 dispositivo

Consulta l'elenco completo errori ed eccezioni.