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