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 trattino multimediale Smart Home

action.devices.traits.MediaState: questa caratteristica viene utilizzata per i dispositivi in grado di segnalare gli stati multimediali.

La caratteristica MediaState viene utilizzata dall'assistente per i seguenti scopi:

  • Per sapere cosa è in riproduzione su ogni dispositivo, se la riproduzione è stata avviata o meno dall'assistente. Queste informazioni aiutano l'assistente a comprendere meglio gli intent dell'utente. Ad esempio, l'utente dirà "Metti in pausa il Tonight Show" quando l'intent effettivo è "Metti in pausa il dispositivo in riproduzione del programma della serata".
  • Per la portabilità tra diversi lettori multimediali: se l'assistente sa quali contenuti sono in riproduzione e qual è la loro posizione, può trasferirli su un altro dispositivo mentre l'utente si sposta da una stanza all'altra oppure salvare la riproduzione per un secondo momento su un dispositivo arbitrario.

Puoi specificare il livello e l'aspetto degli stati dei media che la tua soluzione fornisce configurando gli attributi in questa caratteristica. Questa caratteristica viene solitamente utilizzata insieme alle caratteristiche di TransportControl

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
supportActivityState Booleano

(Valore predefinito: false)

Indica se il dispositivo può segnalare lo stato dell'attività.

supportPlaybackState Booleano

(Valore predefinito: false)

Indica se il dispositivo può segnalare lo stato di riproduzione attuale.

Esempi

Dispositivo multimediale che segnala sia l'attività che lo stato di riproduzione della risposta SYNC

{
  "supportActivityState": true,
  "supportPlaybackState": true
}

STATEs dispositivo

Le entità con questa caratteristica possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per scoprire di più sulla gestione degli intent QUERY, consulta Soddisfazione degli intent.

Stati Tipo Descrizione
activityState Stringa

Indica se il dispositivo è attivo e se l'utente interagisce attivamente con esso.

Valori supportati:

INACTIVE
STANDBY
ACTIVE
playbackState Stringa

Indica lo stato attuale durante la riproduzione di contenuti multimediali.

Valori supportati:

PAUSED
PLAYING
FAST_FORWARDING
REWINDING
BUFFERING
STOPPED

Esempi

Dispositivo multimediale che segnala sia l'attività che lo stato di riproduzione

{
  "activityState": "ACTIVE",
  "playbackState": "PAUSED"
}

comandi del dispositivo

Nessuna.

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.