Schema degli attributi degli switch per la smart home

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

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

Questo tratto riguarda uno o più singoli pulsanti di attivazione/disattivazione che gli utenti possono impostare. In genere, questi pulsanti di attivazione/disattivazione devono essere utilizzati per funzionalità scollegate dal comportamento di altri dispositivi. Il comportamento collegato, ad esempio l'accensione o lo spegnimento del dispositivo, deve utilizzare tratti più specifici (ad esempio thermostatMode nel tratto TemperatureSetting).

ATTRIBUTI del dispositivo

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

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 pulsanti di attivazione/disattivazione solo per i 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
}

STATI del dispositivo

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

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 Adempimento 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
    }
  }
}

Frasi di esempio

ERRORI del dispositivo