Esquema de la función de Control de transporte de casas inteligentes

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 el manejo de 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 con este dispositivo.
[item, ...]	String	Comandos compatibles: Valores admitidos: CAPTION_CONTROL NEXT PAUSE PREVIOUS RESUME SEEK_RELATIVE SEEK_TO_POSITION SET_REPEAT SHUFFLE STOP

Ejemplos

Dispositivo que admite comandos de reproducción

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

Dispositivo STATEs

Ninguno

Dispositivo COMMANDS

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 el manejo de 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. Milésimas de segundo del valor a futuro que se desea buscar (número entero positivo) o hacia atrás (valor int negativo).

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

Retrocede hasta 30 s

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

action.devices.commands.mediaRepeatMode

Configura el 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: false) 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
  }
}

Repite 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 los subtítulos
userQueryLanguage	String	Idioma o configuración regional para la 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 en coreano

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

Activa los subtítulos en coreano con la consulta del usuario en inglés estadounidense

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

action.devices.commands.mediaClosedCaptioningOff

Desactivar 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

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

Dispositivo ERRORS

Consulta la lista completa de errores y excepciones.