Schema dei tratti MediaState per la smart home

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

Il trait MediaState viene utilizzato 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 le intenzioni degli utenti. Ad esempio, gli utenti diranno "Metti in pausa il programma Tonight" quando l'intento effettivo è "Metti in pausa il dispositivo su cui è in riproduzione il Tonight Show".
  • Per la portabilità tra lettori multimediali: se l'assistente sa cosa è in riproduzione e la posizione della riproduzione corrente, può trasferire la riproduzione su un altro dispositivo mentre un utente si sposta da una stanza all'altra oppure salvare la riproduzione per utilizzarla in 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 trait. Questo trait viene solitamente utilizzato insieme ai trait TransportControl

ATTRIBUTES del dispositivo

I dispositivi con questo trait potrebbero segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta fulfillment dell'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 attività e stato di riproduzione per la risposta SYNC

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

Dispositivo STATES

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

Stati Tipo Descrizione
activityState String

Indica se il dispositivo è attivo e l'utente sta interagendo attivamente con il dispositivo.

Valori supportati:

INACTIVE
STANDBY
ACTIVE
playbackState String

Indica lo stato corrente durante la riproduzione dei contenuti multimediali.

Valori supportati:

PAUSED
PLAYING
FAST_FORWARDING
REWINDING
BUFFERING
STOPPED

Esempi

Dispositivo multimediale che segnala attività e stato di riproduzione

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

COMMANDS dispositivo

Nessuna.

ERRORS dispositivo

Consulta l'elenco completo di errori ed eccezioni.