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

ERRORI del dispositivo

Consulta l'elenco completo di errori ed eccezioni.