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.

Il trait MediaState viene usato dall'assistente per i seguenti scopi:

  • Per sapere cosa è in riproduzione su ogni dispositivo, se la riproduzione è stata o meno avviato dall'assistente. Queste informazioni aiutano l'assistente a comprendere meglio gli intenti dell'utente. Ad esempio, gli utenti diranno "Metti in pausa il programma di stasera" quando il loro reale obiettivo è "Metti in pausa il dispositivo su cui è in riproduzione il programma Tonight Show".
  • Per la portabilità tra lettori multimediali, se l'assistente sa cosa sta riproducendo e posizione della riproduzione corrente, l'assistente può trasferirla su un altro dispositivo l'utente si sposta da una stanza all'altra o salva 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 a configurare gli attributi in questo tratto. Questo tratto viene generalmente utilizzato insieme TransportControl trait

ATTRIBUTES dispositivo

I dispositivi con questo tratto potrebbero segnalare quanto segue nell'ambito dell'operazione SYNC. Per ulteriori informazioni scopri di più sulla gestione degli intent SYNC; consulta Completamento dell'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 l'attività e lo stato di riproduzione per la risposta SYNC

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

STATES del dispositivo

Le entità con questo tratto possono segnalare quanto segue nell'ambito dell'operazione QUERY. Per ulteriori informazioni scopri di più sulla gestione degli intent QUERY; consulta Completamento dell'intent.

Stati Tipo Descrizione
activityState String

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

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 dispositivo

Consulta l'elenco completo errori ed eccezioni.