Ti diamo il benvenuto nel Centro sviluppatori Google Home, la nuova destinazione per imparare a sviluppare azioni per la smart home. Nota:continuerai a creare azioni nella Console Actions.
Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Schema tratto scena smart home

action.devices.traits.Scene: questa caratteristica viene utilizzata per implementare i dispositivi virtuali insieme al tipo di dispositivo Snapshot.

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

Ad esempio, se un dispositivo consente agli utenti di configurare un raggruppamento di comandi one-touch: impostare le luci su colori specifici, o sequenziare varie funzionalità di sicurezza o qualsiasi altra combinazione di attività, questa configurazione può essere esposta tramite SYNC come scena denominata e l'assistente metterà a disposizione degli utenti queste scene tramite una semplice grammatica di attivazione:

  • Avvia la modalità party.
  • Attiva scena a mezzanotte.

Come oggetti virtuali, le scene possono essere posizionate nelle stanze (se pertinenti) per la disambiguazione:

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

Le scene interagiranno in modo adeguato con le azioni personali imminenti per la grammatica personalizzata (ad esempio, Attiva modalità party -> Iniziamo la festa!).

Le scene devono sempre avere i nomi forniti dagli utenti rispetto alla denominazione predefinita "BobCo Scene". Ogni scena è dedicata a un dispositivo virtuale con nomi propri. I nomi forniti dall'utente possono provenire da SYNC.

ATTRIBUTE del dispositivo

I dispositivi con questa caratteristica potrebbero segnalare i seguenti attributi come parte dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta Soddisfazione degli intent.

Attributi Tipo Descrizione
sceneReversible Booleano

(Valore predefinito: false)

Indica che la 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 su true.

Esempi

Dispositivo che supporta una scena reversibile.

{
  "sceneReversible": true
}

STATEs dispositivo

Nessuna.

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 Soddisfazione degli intent.

action.devices.commands.ActivateScene

Attivare o disattivare una scena.

Parametri

Parametri Tipo Descrizione
deactivate Booleano

Obbligatorio.

Vero per annullare una scena se è reversibile, falso per attivarla.

Esempi

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

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.