Schema Trait MediaState Trait per la smart home

action.devices.traits.MediaState: questo tratto 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 favorire la portabilità tra lettori multimediali: se l'assistente sa quali contenuti sono in riproduzione e la posizione della riproduzione attuale, può trasferire la riproduzione a un altro dispositivo man mano che 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 contenuti multimediali forniti dalla tua soluzione configurando gli attributi in questo tratto. 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 è in grado di segnalare lo stato di riproduzione attuale.

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

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

COMANDI dispositivo

Nessuno.

ERRORI del dispositivo

Consulta l'elenco completo di errori ed eccezioni.