La smart home attiva/disattiva lo schema dei tratti

action.devices.traits.Toggles: questo trait appartiene a tutti i dispositivi le cui impostazioni possono esistere soltanto in uno di due stati.

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

Questa trait riguarda uno o più comandi di attivazione/disattivazione individuali che gli utenti possono impostare. In generale, questi pulsanti di attivazione/disattivazione devono essere utilizzati per la funzionalità che è scollegata da un altro comportamento del dispositivo. Il comportamento collegato, ad esempio l'accensione o lo spegnimento del dispositivo, dovrebbe usare tratti più specifici (ad esempio, thermostatMode nel trait TemperatureSetting).

ATTRIBUTES del dispositivo

I dispositivi con questo trait potrebbero segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta fulfillment dell'intent.

Attributi	Tipo	Descrizione
availableToggles	Matrice	Obbligatorio. Elenco dei pulsanti di attivazione/disattivazione disponibili.
[item, ...]	Oggetto	Pulsante di attivazione/disattivazione Disponibile.
name	String	Obbligatorio. Nome interno dell'opzione di attivazione/disattivazione, che verrà utilizzato nei comandi e negli stati. Non è facile da usare e verrà condiviso in tutte le lingue.
name_values	Matrice	Obbligatorio. Sinonimi del pulsante di attivazione/disattivazione nelle lingue supportate.
[item, ...]	Oggetto	Sinonimi del pulsante di attivazione/disattivazione in una determinata lingua.
name_synonym	Matrice	Obbligatorio. Sinonimi del pulsante di attivazione/disattivazione. La prima stringa di questo elenco viene utilizzata come nome canonico del livello in quella lingua.
[item, ...]	String	Nome del sinonimo.
lang	String	Obbligatorio. Codice lingua (ISO 639-1). Consulta le lingue supportate.
commandOnlyToggles	Booleano	(Valore predefinito: false) Indica se il dispositivo supporta l'uso di una comunicazione unidirezionale (true) o bidirezionale (false). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a uno stato del report per questo trait.
queryOnlyToggles	Booleano	(Valore predefinito: false) Obbligatorio se il dispositivo supporta l'esecuzione solo di query. Questo attributo indica se è possibile eseguire query sul dispositivo solo per informazioni sullo stato e se non è possibile controllarlo.

Esempi

Dispositivo con attivazione/disattivazione multipla.

{
  "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 comando.

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

Dispositivo con opzioni di attivazione/disattivazione solo per query.

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

Dispositivo STATES

Le entità con questo trait possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per scoprire di più sulla gestione degli intent QUERY, consulta fulfillment 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>	Booleano	Stato di attivazione/disattivazione attuale.

Esempi

La sterilizzazione è attiva?

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

COMMANDS dispositivo

I dispositivi con questa caratteristica potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per scoprire di più sulla gestione degli intent EXECUTE, consulta fulfillment 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>	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
    }
  }
}

Espressioni di esempio

Questo è un esempio delle espressioni supportate da questo trait del dispositivo. Assicurati di controllare anche le altre lingue supportate.

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

ERRORS dispositivo

Consulta l'elenco completo di errori ed eccezioni.