Esquema de la característica de transporte de control inteligente para el hogar
action.devices.traits.TransportControl
: Esta característica se usa en dispositivos que pueden controlar la reproducción de contenido multimedia (por ejemplo, reanudar la música mientras está en pausa).
ATRIBUTOS DEL Dispositivo
Los dispositivos con esta característica pueden informar los siguientes atributos como parte de la operación SYNC
. Para obtener más información sobre cómo manejar los intents SYNC
, consulta Entrega de intents.
Atributos | Tipo | Descripción |
---|---|---|
transportControlSupportedCommands |
Matriz |
Obligatorio. Una lista de strings que describen los comandos de control de transporte compatibles en este dispositivo. |
[item, ...] |
String |
Comandos compatibles. Valores admitidos:
|
Ejemplos
Dispositivo que admite comandos de reproducción
{ "transportControlSupportedCommands": [ "NEXT", "PREVIOUS", "PAUSE", "STOP", "RESUME" ] }
Dispositivo STATEs
Ninguna
Dispositivo COMMAND
Los dispositivos con esta característica pueden responder a los siguientes comandos como parte de la operación EXECUTE
. Para obtener más información sobre cómo manejar los intents EXECUTE
, consulta Entrega de intents.
action.devices.commands.mediaStop
Pausar la reproducción de contenido multimedia
Este comando requiere los siguientes atributos:{ "transportControlSupportedCommands": [ "STOP" ] }
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
Sin propiedades |
Ejemplos
Sin parámetros
{ "command": "action.devices.commands.mediaStop", "params": {} }
action.devices.commands.mediaNext
Ir al siguiente elemento multimedia.
Este comando requiere los siguientes atributos:{ "transportControlSupportedCommands": [ "NEXT" ] }
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
Sin propiedades |
Ejemplos
Sin parámetros
{ "command": "action.devices.commands.mediaNext", "params": {} }
action.devices.commands.mediaPrevious
Ir al elemento multimedia anterior.
Este comando requiere los siguientes atributos:{ "transportControlSupportedCommands": [ "PREVIOUS" ] }
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
Sin propiedades |
Ejemplos
Sin parámetros
{ "command": "action.devices.commands.mediaPrevious", "params": {} }
action.devices.commands.mediaPause
Pausar la reproducción de contenido multimedia
Este comando requiere los siguientes atributos:{ "transportControlSupportedCommands": [ "PAUSE" ] }
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
Sin propiedades |
Ejemplos
Sin parámetros
{ "command": "action.devices.commands.mediaPause", "params": {} }
action.devices.commands.mediaResume
Reanudar la reproducción de contenido multimedia
Este comando requiere los siguientes atributos:{ "transportControlSupportedCommands": [ "RESUME" ] }
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
Sin propiedades |
Ejemplos
Sin parámetros
{ "command": "action.devices.commands.mediaResume", "params": {} }
action.devices.commands.mediaSeekRelative
Busca una posición relativa.
Este comando requiere los siguientes atributos:{ "transportControlSupportedCommands": [ "SEEK_RELATIVE" ] }
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
relativePositionMs |
Número entero |
Obligatorio. Milisegundos de la cantidad adelantada (int positiva) o hacia atrás (int. negativo) que buscar. |
Ejemplos
Avanza 10 s
{ "command": "action.devices.commands.mediaSeekRelative", "params": { "relativePositionMs": 10000 } }
Retroceder 10 s
{ "command": "action.devices.commands.mediaSeekRelative", "params": { "relativePositionMs": -10000 } }
action.devices.commands.mediaSeekToPosition
Busca una posición absoluta.
Este comando requiere los siguientes atributos:{ "transportControlSupportedCommands": [ "SEEK_TO_POSITION" ] }
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
absPositionMs |
Número entero |
Obligatorio. Milisegundo de la posición absoluta a buscar. |
Ejemplos
Ir a 30 s
{ "command": "action.devices.commands.mediaSeekToPosition", "params": { "absPositionMs": 30000 } }
action.devices.commands.mediaRepeatMode
Establecer modo de repetición
Este comando requiere los siguientes atributos:{ "transportControlSupportedCommands": [ "SET_REPEAT" ] }
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
isOn |
Booleano |
Obligatorio. Verdadero para activar el modo de repetición; falso para desactivar el modo de repetición. |
isSingle |
Booleano |
(Predeterminado: Si se especifica, verdadero significa activar el modo de repetición de un solo elemento, falso significa activar el modo de repetición normal (por ejemplo, una lista de reproducción). |
Ejemplos
Repetir el
{ "command": "action.devices.commands.mediaRepeatMode", "params": { "isOn": true } }
Repetición desactivada
{ "command": "action.devices.commands.mediaRepeatMode", "params": { "isOn": false } }
Repetir una sola pista
{ "command": "action.devices.commands.mediaRepeatMode", "params": { "isOn": true, "isSingle": true } }
action.devices.commands.mediaShuffle
Reproduce aleatoriamente la lista de reproducción actual.
Este comando requiere los siguientes atributos:{ "transportControlSupportedCommands": [ "SHUFFLE" ] }
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
Sin propiedades |
Ejemplos
Sin parámetros
{ "command": "action.devices.commands.mediaShuffle", "params": {} }
action.devices.commands.mediaClosedCaptioningOn
Activa los subtítulos.
Este comando requiere los siguientes atributos:{ "transportControlSupportedCommands": [ "CAPTION_CONTROL" ] }
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
closedCaptioningLanguage |
String |
Idioma o configuración regional de subtítulos. |
userQueryLanguage |
String |
Idioma o configuración regional para consulta del usuario. |
Ejemplos
Cómo activar los subtítulos en inglés
{ "command": "action.devices.commands.mediaClosedCaptioningOn", "params": { "closedCaptioningLanguage": "en" } }
Cómo activar los subtítulos opcionales en coreano
{ "command": "action.devices.commands.mediaClosedCaptioningOn", "params": { "closedCaptioningLanguage": "ko-KR" } }
Activa los subtítulos opcionales en coreano con la consulta del usuario en inglés de EE.UU.
{ "command": "action.devices.commands.mediaClosedCaptioningOn", "params": { "closedCaptioningLanguage": "ko-KR", "userQueryLanguage": "en-US" } }
action.devices.commands.mediaClosedCaptioningOff
Desactiva los subtítulos.
Este comando requiere los siguientes atributos:{ "transportControlSupportedCommands": [ "CAPTION_CONTROL" ] }
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
Sin propiedades |
Ejemplos
Cómo desactivar los subtítulos opcionales
{ "command": "action.devices.commands.mediaClosedCaptioningOff", "params": {} }