Schema dei tratti di scena per la smart home

action.devices.traits.Scene: questa caratteristica viene utilizzata 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 dei comandi con un solo tocco, impostando colori specifici o 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à queste scene disponibili 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 pertinente) per disambiguazione:

  • 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 di scena, consentendo agli utenti di attivare le scene su più partner. Ad esempio, se un utente ha una scena in "modalità gruppo" su due partner diversi, uno per la sicurezza e uno per le luci, l'opzione Attiva modalità gruppo attiverà entrambi.

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

Le scene devono avere sempre i nomi forniti dall'utente rispetto alla denominazione predefinita "Scena BobCo". Ogni scena è un dispositivo virtuale a sé, con il proprio nome o i propri nomi. I nomi forniti dagli utenti potrebbero provenire da SYNC.

ATTRIBUTES del dispositivo

I dispositivi con questo trait potrebbero segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta fulfillment dell'intent.

Attributi Tipo Descrizione
sceneReversible Booleano

(Valore predefinito: false)

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 ActivateScene con il parametro deactivate impostato su true.

Esempi

Dispositivo che supporta una scena reversibile.

{
  "sceneReversible": true
}

Dispositivo STATES

Nessuna.

COMMANDS dispositivo

I dispositivi con questa caratteristica potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per scoprire di più sulla gestione degli intent EXECUTE, consulta fulfillment dell'intent.

action.devices.commands.ActivateScene

Attivare o disattivare una scena.

Parametri

Parametri Tipo Descrizione
deactivate Booleano

Obbligatorio.

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

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
  }
}

ERRORS dispositivo

Consulta l'elenco completo di errori ed eccezioni.