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 SCENE.

Per ulteriori informazioni, consulta la guida ai tipi di scene.

Ad esempio, se un dispositivo consente agli utenti di configurare con un solo tocco dei comandi (impostazione delle luci su colori specifici o sequenziamento 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 le renderà disponibili agli utenti tramite una semplice grammatica di attivazione:

  • Avvia la modalità Party.
  • Attiva la scena notturna.

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 è il suo dispositivo virtuale, con i propri nomi. I nomi forniti dagli utenti 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: 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
}

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

ERRORI dispositivo

Consulta l'elenco completo di errori ed eccezioni.