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 SCENA.
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 dei comandi, ad esempio impostando colori specifici per le luci, impostando la sequenza di varie funzionalità di sicurezza o qualsiasi altra combinazione di attività, questa configurazione può essere esposta tramite SYNC
come una scena denominata e l'assistente renderà disponibili queste scene agli utenti tramite una semplice grammatica di attivazione:
- Avvia la modalità Party.
- Attiva la scena di mezzanotte.
Come oggetti virtuali, le scene possono essere posizionate nelle stanze (se pertinenti) per una maggiore disambiguazione:
- Dai il via alla 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 di Scene, consentendo agli utenti di attivare scene su più partner. Ad esempio, se un utente ha una scena in "modalità festa" su due partner diversi, uno per la sicurezza e uno per le luci, l'opzione Attiva modalità gruppo attiva entrambi.
Le scene interagiranno bene con le azioni personali future per regole grammaticali personalizzate (ad esempio, Attiva modalità Party -> Che la festa abbia inizio!).
Le scene devono sempre avere nomi forniti dall'utente rispetto alla denominazione predefinita
"Scena BobCo". Ogni scena è un dispositivo virtuale a sé stante, con il proprio nome o i propri nomi.
I nomi forniti dall'utente potrebbero provenire da SYNC
.
ATTRIBUTI dispositivo
I dispositivi con questo tratto potrebbero segnalare i seguenti
attributi nell'ambito dell'operazione SYNC
. Per scoprire di più sulla gestione degli intent SYNC
, consulta Completamento dell'intent.
Attributi | Tipo | Descrizione |
---|---|---|
sceneReversible |
Valore booleano |
(valore predefinito: Indica che questa 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 }
Dispositivo STATES
Nessuna.
COMMANDS dispositivo
I dispositivi con questo tratto potrebbero rispondere ai seguenti
comandi nell'ambito dell'operazione EXECUTE
. Per scoprire 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 attivarla. |
Esempi
Attiva una scena in base al nome.
{ "command": "action.devices.commands.ActivateScene", "params": { "deactivate": false } }
Disattivare una scena in base al nome.
{ "command": "action.devices.commands.ActivateScene", "params": { "deactivate": true } }