Esquema de atributos de TransportControl de la casa inteligente

action.devices.traits.TransportControl: Esta característica se usa para dispositivos que pueden controlar la reproducción de contenido multimedia (por ejemplo, reanudar la música mientras está pausada).

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 controlar intents SYNC, consulta Cómo entregar intents.

Atributos Tipo Descripción
transportControlSupportedCommands Matriz

Obligatorio.

Es una lista de cadenas que describen los comandos de control de transporte compatibles en este dispositivo.
[item, ...] String

Comandos compatibles

Valores admitidos:

CAPTION_CONTROL
NEXT
PAUSE
PREVIOUS
RESUME
SEEK_RELATIVE
SEEK_TO_POSITION
SET_REPEAT
SHUFFLE
STOP

Ejemplos

Dispositivos compatibles con los comandos de reproducción

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

ESTADOS DEL DISPOSITIVO

Ninguno

COMANDOS del dispositivo

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 controlar intents EXECUTE, consulta Cómo entregar 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.

Es la cantidad de milisegundos hacia adelante (int positivo) o hacia atrás (int negativo) que se debe buscar.

Ejemplos

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

Es el milisegundo de la posición absoluta a la que se debe saltar.

Ejemplos

Saltar a 30 s

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

action.devices.commands.mediaRepeatMode

Establece el modo de reproducción repetida.

Este comando requiere los siguientes atributos: 
{
  "transportControlSupportedCommands": [
    "SET_REPEAT"
  ]
}

Parámetros

Parámetros Tipo Descripción
isOn Booleano

Obligatorio.

Es verdadero para activar el modo de repetición y falso para desactivarlo.
isSingle Booleano

(Predeterminado: false)

Si se especifica, verdadero significa activar el modo de repetición de un solo elemento y falso significa activar el modo de repetición normal (por ejemplo, una playlist).

Ejemplos

Repetir en

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

Repetir desactivado

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

Cómo repetir un solo segmento

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

action.devices.commands.mediaShuffle

Reproduce aleatoriamente la playlist 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

Es el idioma o la configuración regional de los subtítulos.
userQueryLanguage String

Es el idioma o la configuración regional de 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"
  }
}

Cómo activar los subtítulos en coreano con una búsqueda del usuario en inglés estadounidense

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

ERRORES del dispositivo

Consulta la lista completa de errores y excepciones.