Schéma de trait MediaState pour la maison connectée

action.devices.traits.MediaState : cette caractéristique est utilisée pour les appareils capables de signaler les états multimédias.

La caractéristique MediaState est utilisée par l'Assistant à ces fins:

  • Pour savoir ce qui est en cours de lecture sur chaque appareil, que la lecture ait été lancée par l'Assistant ou non. Ces informations aident l'Assistant à mieux comprendre les intentions des utilisateurs. Par exemple, les utilisateurs disent Mets en pause The Tonight Show alors que leur intention réelle est Mets en pause l'appareil qui diffuse actuellement The Tonight Show.
  • Pour la portabilité entre les lecteurs multimédias : si l'Assistant sait ce qui est 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 passe d'une pièce à l'autre, ou enregistrer la lecture pour plus tard sur un appareil arbitraire.

Vous pouvez spécifier le niveau et l'aspect des états multimédias que votre solution fournit en configurant les attributs de cette caractéristique. Cette caractéristique est généralement utilisée avec les caractéristiques TransportControl.

ATTRIBUTS de l'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 Valeur booléenne

(Par défaut : false)

Indique si l'appareil peut signaler l'état de l'activité.
supportPlaybackState Valeur booléenne

(Par défaut : false)

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

Exemples

Appareil multimédia qui signale à la fois l'activité et l'état de la lecture pour la réponse SYNC

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

ÉTATS DE L'APPAREIL

Les entités avec 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

Indique 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

Appareil multimédia qui signale à la fois l'activité et l'état de la lecture

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

COMMANDES DE L'APPAREIL

Aucune.

ERREURS de l'appareil

Consultez la liste complète des erreurs et exceptions.