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

action.devices.traits.TransportControl : cette caractéristique est utilisée pour les appareils capables de contrôler la lecture multimédia (par exemple, reprendre la lecture de musique lorsqu'elle est mise en pause).

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

Obligatoire.

Liste de chaînes décrivant les commandes de contrôle 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"
  ]
}

ÉTATS DE L'APPAREIL

Aucune.

COMMANDES DE L'APPAREIL

Les appareils dotés 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 la section Traitement des intents.

action.devices.commands.mediaStop

Mettez la lecture du contenu multimédia en pause.

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

Mettez la lecture du contenu multimédia en pause.

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 de 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.

Nombre de millisecondes de la valeur avant (entier positif) ou arrière (entier négatif) à rechercher.

Exemples

Avance rapide de 10 secondes

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

Revenir en arrière 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

Accéder à 30 secondes

{
  "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 Valeur booléenne

Obligatoire.

"True" pour activer le mode répétition, "false" pour le désactiver.

isSingle Valeur booléenne

(Par défaut : false)

Si cette valeur est spécifiée, la valeur "true" active le mode de répétition d'un seul élément, tandis que la valeur "false" active le mode de répétition normal (par exemple, une playlist).

Exemples

Répéter le

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

Répéter désactivé

{
  "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

Lire la playlist actuelle en mode 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

Active 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 des sous-titres.

userQueryLanguage String

Langue ou paramètres régionaux de 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 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é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 de l'appareil

Consultez la liste complète des erreurs et exceptions.