Schema tratto scena smart home
action.devices.traits.Scene
: questa caratteristica viene utilizzata per implementare i dispositivi virtuali insieme al tipo di dispositivo Snapshot.
Per ulteriori informazioni, consulta la guida ai tipi di scena.
Ad esempio, se un dispositivo consente agli utenti di configurare un raggruppamento di comandi one-touch: impostare le luci su colori specifici, o sequenziare varie funzionalità di sicurezza o qualsiasi altra combinazione di attività, questa configurazione può essere esposta tramite SYNC
come scena denominata e l'assistente metterà a disposizione degli utenti queste scene tramite una semplice grammatica di attivazione:
- Avvia la modalità party.
- Attiva scena a mezzanotte.
Come oggetti virtuali, le scene possono essere posizionate nelle stanze (se pertinenti) per la 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 applicherà automaticamente effetti plurali ai comandi della scena, consentendo agli utenti di attivare le scene su più partner. Ad esempio, se un utente ha una scena "modalità gruppo" su due partner diversi, uno per la sicurezza e uno per le luci, l'attivazione della modalità gruppo attiva entrambi.
Le scene interagiranno in modo adeguato con le azioni personali imminenti per la grammatica personalizzata (ad esempio, Attiva modalità party -> Iniziamo la festa!).
Le scene devono sempre avere i nomi forniti dagli utenti rispetto alla denominazione predefinita "BobCo Scene". Ogni scena è dedicata a un dispositivo virtuale con nomi propri.
I nomi forniti dall'utente possono provenire da SYNC
.
ATTRIBUTE del dispositivo
I dispositivi con questa caratteristica potrebbero segnalare i seguenti
attributi come parte dell'operazione SYNC
. Per scoprire di più sulla gestione degli intent SYNC
, consulta Soddisfazione degli intent.
Attributi | Tipo | Descrizione |
---|---|---|
sceneReversible |
Booleano |
(Valore predefinito: Indica che la scena può essere annullata. Questo attributo è pertinente solo per le scene che modificano lo stato e ricordano lo stato precedente. Il dispositivo supporta il comando |
Esempi
Dispositivo che supporta una scena reversibile.
{ "sceneReversible": true }
STATEs dispositivo
Nessuna.
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 Soddisfazione degli intent.
action.devices.commands.ActivateScene
Attivare o disattivare una scena.
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
deactivate |
Booleano |
Obbligatorio. Vero per annullare una scena se è reversibile, falso per attivarla. |
Esempi
Attiva 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 } }