Schema dei tratti di scena per la smart home

action.devices.traits.Scene: questo tratto viene utilizzato per implementare i dispositivi virtuali insieme al tipo di dispositivo SCENE.

Per ulteriori informazioni, consulta la Guida ai tipi di scena.

Ad esempio, se un dispositivo consente agli utenti di configurare il raggruppamento con un tocco comandi che consentono di impostare colori specifici per le luci o di creare sequenze di comandi caratteristiche o qualsiasi altra combinazione di attività, questa configurazione da esporre tramite SYNC come una scena con nome e l'assistente le di scene disponibili agli utenti tramite una semplice grammatica di attivazione:

  • Avvia la modalità Party.
  • Attiva la scena notturna.

Come oggetti virtuali, le scene possono essere posizionate nelle stanze (se pertinente) per disambiguazione:

  • Inizia la festa in cucina.
  • Attiva la modalità Luce notturna nelle camere da letto.

Una differenza tra le scene e i target fisici è che l'assistente applicare automaticamente effetti plurali ai comandi di scena, consentendo agli utenti di attivare con più partner. Ad esempio, se un utente ha una "modalità party" scena su due partner diversi, uno per la sicurezza e uno per le luci, Attiva modalità party attiveranno entrambe.

Le scene interagiranno bene con le prossime azioni personali per personalizzare la grammatica (ad esempio, Attiva modalità Party -> Diamo inizio alla festa!).

Le scene devono avere sempre i nomi forniti dall'utente rispetto a "Scene di BobCo" predefinita di denominazione. Ogni scena è il suo dispositivo virtuale, con i propri nomi. I nomi forniti dagli utenti potrebbero provenire da SYNC.

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
sceneReversible Valore booleano

(Valore predefinito: false)

Indica che questa scena può essere annullata. Questo attributo è rilevante solo per le scene che modificano lo stato e ricordano lo stato precedente. Il dispositivo supporta il comando ActivateScene con il parametro deactivate impostato su true.

Esempi

Dispositivo che supporta una scena reversibile.

{
  "sceneReversible": true
}

STATES del dispositivo

Nessuno.

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.ActivateScene

Attiva o disattiva una scena.

Parametri

Parametri Tipo Descrizione
deactivate Valore booleano

Obbligatorio.

True per annullare una scena se è reversibile, false per attivare una scena.

Esempi

Attivare una scena per nome.

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": false
  }
}

Disattivare una scena per nome.

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": true
  }
}

ERRORI dispositivo

Consulta l'elenco completo errori ed eccezioni.