Schema del tratto OnOff per la smart home

action.devices.traits.OnOff: la funzionalità di accensione e spegnimento di base per qualsiasi dispositivo con accensione e spegnimento binari, inclusi prese e interruttori, nonché molti dispositivi futuri.

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 che supporta i comandi on/off e gli stati di generazione di report.

{
  "commandOnlyOnOff": false,
  "queryOnlyOnOff": false
}

Dispositivo che supporta solo i comandi di accensione/spegnimento.

{
  "commandOnlyOnOff": true,
  "queryOnlyOnOff": false
}

Dispositivo (in genere un sensore) che supporta solo la generazione di report sullo stato on/off.

{
  "queryOnlyOnOff": true,
  "commandOnlyOnOff": false
}

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

Il dispositivo è acceso?

{
  "on": true
}

Il dispositivo è spento?

{
  "on": 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.OnOff

Accendi o spegni il dispositivo.

Parametri

Esempi

Accendi il dispositivo.

{
  "command": "action.devices.commands.OnOff",
  "params": {
    "on": true
  }
}

Spegni il dispositivo.

{
  "command": "action.devices.commands.OnOff",
  "params": {
    "on": false
  }
}

Frasi di esempio

ERRORI del dispositivo