Schéma MediaState Trait de la maison connectée

action.devices.traits.MediaState : cette caractéristique est utilisée pour les appareils pouvant générer des rapports sur les états des contenus multimédias.

La caractéristique MediaState est utilisée par l'Assistant aux fins suivantes:

  • Pour savoir ce qui est en cours de lecture sur chaque appareil, si la lecture a été lancée ou non par l'Assistant. Ces informations aident l'Assistant à mieux comprendre les intentions des utilisateurs. Par exemple, les utilisateurs peuvent dire "Mets en pause l'émission de ce soir" si leur intention réelle est "Mets en pause l'émission de ce soir sur l'appareil en cours de lecture".
  • Pour assurer la portabilité d'un lecteur multimédia à un autre : si l'Assistant connaît le contenu en cours de lecture et la position de la lecture en cours, il peut transférer cette lecture vers un autre appareil lorsque l'utilisateur se déplace d'une pièce à l'autre, ou enregistrer la lecture pour la retrouver plus tard sur un appareil arbitraire.

Vous pouvez spécifier le niveau et l'aspect des états multimédias fournis par votre solution en configurant les attributs de cette caractéristique. Ce trait est généralement utilisé avec le trait TransportControl.

Attributs d'appareil

Les appareils dotés de cette caractéristique peuvent signaler les attributs suivants dans le cadre de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez la section Traitement des intents.

Attributs Type Description
supportActivityState Booléen

(Par défaut : false)

Indiquez si l'appareil peut signaler l'état d'activité.

supportPlaybackState Booléen

(Par défaut : false)

Indiquez si l'appareil peut signaler l'état de lecture actuel.

Exemples

Périphérique multimédia indiquant à la fois l'activité et l'état de lecture pour la réponse SYNC

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

Device STATES

Les entités dotées de cette caractéristique peuvent signaler les états suivants dans le cadre de l'opération QUERY. Pour en savoir plus sur la gestion des intents QUERY, consultez la section Traitement des intents.

États Type Description
activityState String

Indiquer si l'appareil est actif et si l'utilisateur interagit activement avec lui.

Valeurs acceptées :

INACTIVE
STANDBY
ACTIVE
playbackState String

Indique l'état actuel lors de la lecture de contenus multimédias.

Valeurs acceptées :

PAUSED
PLAYING
FAST_FORWARDING
REWINDING
BUFFERING
STOPPED

Exemples

Périphérique multimédia signalant à la fois l'activité et l'état de lecture

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

COMMANDS d'appareil

Aucun.

ERREURS sur l'appareil

Consultez la liste complète des erreurs et exceptions.