Schéma de Trait TransportControl pour la maison connectée

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, pour reprendre la lecture d'un contenu musical alors qu'elle est en pause).

ATTRIBUTS D'appareils

Les appareils présentant cette caractéristique peuvent signaler les éléments suivants : dans le cadre de l'opération SYNC. Pour apprendre 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 contrôle de transport compatibles avec 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"
  ]
}

STATES de l'appareil

Aucun

COMMANDS d'appareils

Les appareils présentant cette caractéristique peuvent répondre aux éléments suivants : dans le cadre de l'opération EXECUTE. Pour apprendre Pour en savoir plus sur la gestion des intents EXECUTE, consultez Traitement des intents.

action.devices.commands.mediaStop

Mettre en pause la lecture des contenus multimédias.

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 des contenus multimédias.

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 des contenus multimédias.

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

Recherchez 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 (int positive) ou arrière (int négative) à rechercher.

Exemples

Avancer de 10 s

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

Avancer de 10 secondes en arrière

{
  "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éfinir le mode de lecture répétée

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

Paramètres

Paramètres Type Description
isOn Valeur booléenne

Obligatoire.

"True" pour activer le mode de répétition, "false" pour le désactiver.
isSingle Valeur booléenne

(Par défaut : false)

Si la valeur "true" est spécifiée, le mode de répétition d'un élément individuel est activé. La valeur "false" indique 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 titre

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

action.devices.commands.mediaShuffle

Lire la playlist en cours de manière aléatoire.

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 du sous-titrage.
userQueryLanguage String

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

Exemples

Activer les sous-titres en anglais

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

Activer le sous-titrage en coréen

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

Activer le sous-titrage en coréen avec une requête utilisateur en anglais américain

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

action.devices.commands.mediaClosedCaptioningOff

Désactiver 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 le sous-titrage

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

Erreurs d'appareil

Voir la liste complète les erreurs et les exceptions.