Schema del tratto di attivazione/disattivazione della smart home

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 uno stato attivo/non attivo o on/off, una casella di controllo in HTML o qualsiasi altro tipo di elemento specificamente attivato/disattivato. Se l'impostazione ha più di due stati o uno stato in cui non è selezionata nessuna delle opzioni binarie, è meglio rappresentarla come un tratto Modes, che equivale a quadranti multi-stato, pulsanti di opzione (fisici o HTML) o stati binari che non sono esplicitamente on/off (ad esempio "AM/FM" o "caldo/freddo").

Questa caratteristica copre uno o più pulsanti di attivazione/disattivazione individuali che gli utenti possono impostare. In generale, questi pulsanti di attivazione/disattivazione devono essere utilizzati per funzionalità non collegate ad altri comportamenti del dispositivo. Il comportamento collegato, ad esempio l'accensione o lo spegnimento del dispositivo stesso, deve utilizzare caratteristiche più specifiche (ad esempio, thermostatMode nella caratteristica TemperatureSetting).

ATTRIBUTI dispositivo

I dispositivi con questa caratteristica potrebbero segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per saperne di più sulla gestione degli intent SYNC, consulta Completamento degli intent.

Esempi

Dispositivo con più interruttori.

{
  "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 pulsanti di attivazione/disattivazione solo per i comandi.

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

Dispositivo con attivazione/disattivazione delle query.

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

STATI del dispositivo

Le entità con questo tratto possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per saperne di più sulla gestione degli intent QUERY, consulta Completamento degli intent.

Esempi

La sterilizzazione è attiva?

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

COMANDI del dispositivo

I dispositivi con questo tratto potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per saperne di più sulla gestione degli intent EXECUTE, consulta Completamento degli intent.

action.devices.commands.SetToggles

Imposta un determinato stato di attivazione/disattivazione.

Parametri

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 espressioni

ERRORI del dispositivo