Schéma Trait de maison pour TransportControl

action.devices.traits.TransportControl : cette caractéristique est utilisée pour les appareils qui peuvent contrôler la lecture de contenus multimédias (par exemple, reprendre la lecture pendant la pause).

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
transportControlSupportedCommands Array

Obligatoire.

Liste de chaînes décrivant les commandes de transport compatibles sur cet appareil.
[item, ...] String

Commandes compatibles

Valeurs acceptées :

CAPTION_CONTROL
NEXT
PAUSE
PREVIOUS
RESUME
SEEK_RELATIVE
SEEK_TO_POSITION
SET_REPEAT
SHUFFLE
STOP

Exemples

Appareil compatible avec les commandes de lecture

{
  "transportControlSupportedCommands": [
    "NEXT",
    "PREVIOUS",
    "PAUSE",
    "STOP",
    "RESUME"
  ]
}

Appareil STATES

Aucun.

Appareil COMMANDS

Les appareils disposant de cette caractéristique peuvent répondre aux commandes suivantes dans le cadre de l'opération EXECUTE. Pour en savoir plus sur la gestion des intents EXECUTE, consultez Traitement des intents.

action.devices.commands.mediaStop

Mettre en pause la lecture du contenu multimédia.

Cette commande nécessite les attributs suivants :
{
  "transportControlSupportedCommands": [
    "STOP"
  ]
}

Paramètres

Paramètres Type Description

Aucune propriété

Exemples

Aucun paramètre

{
  "command": "action.devices.commands.mediaStop",
  "params": {}
}

action.devices.commands.mediaNext

Passer à l'élément multimédia suivant.

Cette commande nécessite les attributs suivants :
{
  "transportControlSupportedCommands": [
    "NEXT"
  ]
}

Paramètres

Paramètres Type Description

Aucune propriété

Exemples

Aucun paramètre

{
  "command": "action.devices.commands.mediaNext",
  "params": {}
}

action.devices.commands.mediaPrevious

Passer à l'élément multimédia précédent.

Cette commande nécessite les attributs suivants :
{
  "transportControlSupportedCommands": [
    "PREVIOUS"
  ]
}

Paramètres

Paramètres Type Description

Aucune propriété

Exemples

Aucun paramètre

{
  "command": "action.devices.commands.mediaPrevious",
  "params": {}
}

action.devices.commands.mediaPause

Mettre en pause la lecture du contenu multimédia.

Cette commande nécessite les attributs suivants :
{
  "transportControlSupportedCommands": [
    "PAUSE"
  ]
}

Paramètres

Paramètres Type Description

Aucune propriété

Exemples

Aucun paramètre

{
  "command": "action.devices.commands.mediaPause",
  "params": {}
}

action.devices.commands.mediaResume

Reprendre la lecture du contenu multimédia.

Cette commande nécessite les attributs suivants :
{
  "transportControlSupportedCommands": [
    "RESUME"
  ]
}

Paramètres

Paramètres Type Description

Aucune propriété

Exemples

Aucun paramètre

{
  "command": "action.devices.commands.mediaResume",
  "params": {}
}

action.devices.commands.mediaSeekRelative

Accéder à une position relative

Cette commande nécessite les attributs suivants :
{
  "transportControlSupportedCommands": [
    "SEEK_RELATIVE"
  ]
}

Paramètres

Paramètres Type Description
relativePositionMs Entier

Obligatoire.

Millisecondes de la valeur avant (positif positif) ou arrière (entier positif) à rechercher.

Exemples

Avancer de 10 secondes

{
  "command": "action.devices.commands.mediaSeekRelative",
  "params": {
    "relativePositionMs": 10000
  }
}

Avancer de 10 secondes

{
  "command": "action.devices.commands.mediaSeekRelative",
  "params": {
    "relativePositionMs": -10000
  }
}

action.devices.commands.mediaSeekToPosition

Recherchez une position absolue.

Cette commande nécessite les attributs suivants :
{
  "transportControlSupportedCommands": [
    "SEEK_TO_POSITION"
  ]
}

Paramètres

Paramètres Type Description
absPositionMs Entier

Obligatoire.

Milliseconde de la position absolue à rechercher.

Exemples

Avancer jusqu'à 30 s

{
  "command": "action.devices.commands.mediaSeekToPosition",
  "params": {
    "absPositionMs": 30000
  }
}

action.devices.commands.mediaRepeatMode

Définissez le mode de lecture en boucle.

Cette commande nécessite les attributs suivants :
{
  "transportControlSupportedCommands": [
    "SET_REPEAT"
  ]
}

Paramètres

Paramètres Type Description
isOn Booléen

Obligatoire.

Vrai pour activer le mode répétition, faux pour désactiver le mode répétition.
isSingle Booléen

(Par défaut : false)

Si elle est spécifiée, la valeur "true" signifie que le mode de répétition d'un seul élément est activé, et la valeur "false" correspond à l'activation du mode de répétition normal (par exemple, une playlist).

Exemples

Répéter le

{
  "command": "action.devices.commands.mediaRepeatMode",
  "params": {
    "isOn": true
  }
}

Désactiver la répétition

{
  "command": "action.devices.commands.mediaRepeatMode",
  "params": {
    "isOn": false
  }
}

Répéter un seul titre

{
  "command": "action.devices.commands.mediaRepeatMode",
  "params": {
    "isOn": true,
    "isSingle": true
  }
}

action.devices.commands.mediaShuffle

Activer la lecture aléatoire de la playlist en cours

Cette commande nécessite les attributs suivants :
{
  "transportControlSupportedCommands": [
    "SHUFFLE"
  ]
}

Paramètres

Paramètres Type Description

Aucune propriété

Exemples

Aucun paramètre

{
  "command": "action.devices.commands.mediaShuffle",
  "params": {}
}

action.devices.commands.mediaClosedCaptioningOn

Activez les sous-titres.

Cette commande nécessite les attributs suivants :
{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

Paramètres

Paramètres Type Description
closedCaptioningLanguage String

Langue ou paramètres régionaux pour les sous-titres
userQueryLanguage String

Langue ou paramètres régionaux pour la requête de l'utilisateur.

Exemples

Activer les sous-titres en anglais

{
  "command": "action.devices.commands.mediaClosedCaptioningOn",
  "params": {
    "closedCaptioningLanguage": "en"
  }
}

Activer les sous-titres en coréen

{
  "command": "action.devices.commands.mediaClosedCaptioningOn",
  "params": {
    "closedCaptioningLanguage": "ko-KR"
  }
}

Activer les sous-titres en coréen avec la requête de l'utilisateur en anglais américain

{
  "command": "action.devices.commands.mediaClosedCaptioningOn",
  "params": {
    "closedCaptioningLanguage": "ko-KR",
    "userQueryLanguage": "en-US"
  }
}

action.devices.commands.mediaClosedCaptioningOff

Désactivez les sous-titres.

Cette commande nécessite les attributs suivants :
{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

Paramètres

Paramètres Type Description

Aucune propriété

Exemples

Désactiver les sous-titres

{
  "command": "action.devices.commands.mediaClosedCaptioningOff",
  "params": {}
}

ERREURS sur l'appareil

Consultez la liste complète des erreurs et exceptions.