Schema degli attributi della scena per la smart home
action.devices.traits.Scene
: questo trait viene utilizzato per implementare dispositivi virtuali insieme al tipo di dispositivo SCENE.
Per ulteriori informazioni, consulta la guida ai tipi di scene.
Ad esempio, se un dispositivo consente agli utenti di configurare il raggruppamento con un solo tocco dei comandi, impostando le luci su colori specifici, sequenziando varie funzionalità di sicurezza o qualsiasi altra combinazione di attività, questa configurazione può essere esposta tramite SYNC
come scena denominata e l'assistente renderà queste scene disponibili agli utenti tramite una semplice grammatica di attivazione:
- Avvia la modalità Discoteca.
- Attiva la scena di mezzanotte.
In quanto oggetti virtuali, le scene possono essere posizionate nelle stanze (se pertinenti) per la sambiguizzazione:
- Inizia la festa in cucina.
- Attiva la modalità luminosità notturna nelle camere da letto.
Una differenza tra le scene e i target fisici è che l'assistente applicherà automaticamente gli effetti plurali ai comandi delle scene, consentendo agli utenti di attivare le scene su più partner. Ad esempio, se un utente ha una scena "Modalità festa" su due partner diversi, uno per la sicurezza e uno per le luci, l'opzione Attiva modalità festa attiverà entrambe.
Le scene interagiranno bene con le imminenti azioni personali per la grammatica personalizzata (ad esempio, Attiva la modalità Festo🎉 -> Iniziamo la festa!).
Le scene devono sempre avere nomi forniti dall'utente anziché il nome predefinito "Scena BobCo". Ogni scena è un dispositivo virtuale autonomo con i propri nomi.
I nomi forniti dall'utente potrebbero provenire da SYNC
.
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.
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 }
STATI del dispositivo
Nessuno.
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.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
Attiva una scena per nome.
{ "command": "action.devices.commands.ActivateScene", "params": { "deactivate": false } }
Disattiva una scena in base al nome.
{ "command": "action.devices.commands.ActivateScene", "params": { "deactivate": true } }