Schema del tratto MediaState per la smart home

action.devices.traits.MediaState: questo attributo viene utilizzato per i dispositivi in grado di segnalare gli stati dei contenuti multimediali.

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

  • Per sapere cosa viene riprodotto su ogni dispositivo e se la riproduzione è stata avviata o meno dall'assistente. Queste informazioni aiutano l'assistente a comprendere meglio le intenzioni degli utenti. Ad esempio, gli utenti diranno "Metti in pausa il Tonight Show" quando la loro intenzione effettiva è "Metti in pausa il dispositivo su cui è in riproduzione il Tonight Show".
  • Per la portabilità tra lettori multimediali: se l'assistente sa cosa viene riprodotto e la posizione della riproduzione corrente, può trasferirla su un altro dispositivo mentre l'utente si sposta da una stanza all'altra o salvarla per guardarla in un secondo momento su un dispositivo qualsiasi.

Puoi specificare il livello e l'aspetto degli stati dei contenuti multimediali forniti dalla tua soluzione configurando gli attributi in questa caratteristica. Questo attributo viene in genere utilizzato insieme agli attributi TransportControl

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
supportActivityState Valore booleano

(valore predefinito: false)

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

supportPlaybackState Valore booleano

(valore predefinito: false)

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

Esempi

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

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

STATI del dispositivo

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

Stati Tipo Descrizione
activityState String

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

Valori supportati:

INACTIVE
STANDBY
ACTIVE
playbackState String

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à sia lo stato di riproduzione

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

COMANDI del dispositivo

Nessuno.

ERRORI del dispositivo

Consulta l'elenco completo di errori ed eccezioni.