Schéma Trait MediaState Smart Home

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

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

  • Pour savoir ce qui est diffusé sur chaque appareil, que la lecture ait été lancée ou non par l'Assistant Google Ces informations aident l'Assistant à mieux comprendre les intentions de l'utilisateur. Par exemple, les utilisateurs disent "Pause l'émission de ce soir" lorsque leur intention réelle est "Mets l'appareil en pause à l'événement en ce moment".
  • Pour la portabilité entre les lecteurs multimédias, si l'Assistant connaît la lecture en cours et la position de la lecture actuelle, il peut la transférer vers un autre appareil lorsqu'un utilisateur passe d'une pièce à une autre, ou l'enregistrer pour une lecture ultérieure sur un appareil arbitraire.

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

ATTRIBUTS de l'appareil

Les appareils disposant de cette caractéristique peuvent signaler les attributs suivants lors de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez Traitement des intents.

Attributs Type Description
supportActivityState Booléen

(Par défaut : false)

Indique si l'appareil peut signaler l'état de l'activité.

supportPlaybackState Booléen

(Par défaut : false)

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

Exemples

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

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

Appareil 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 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 lorsque vous lisez un contenu multimédia.

Valeurs acceptées :

PAUSED
PLAYING
FAST_FORWARDING
REWINDING
BUFFERING
STOPPED

Exemples

Appareil multimédia qui communique l'activité et l'état de lecture

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

Appareil COMMANDS

Aucun.

ERREURS sur l'appareil

Consultez la liste complète des erreurs et exceptions.