Esquema de trait de TransportControl de casa inteligente

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

ATRIBUTOS DISPOSITIVOS

Los dispositivos con este trait pueden informar lo siguiente atributos como parte de la operación SYNC. Para aprender Para obtener más información sobre cómo controlar los intents SYNC, consulta Entrega de intents.

Atributos	Tipo	Descripción
transportControlSupportedCommands	Matriz	Obligatorio. Una lista de cadenas que describen los comandos de control de transporte admitidos 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

Dispositivo compatible con comandos de reproducción

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

Dispositivo STATES

Ninguno

COMANDOS del dispositivo

Los dispositivos con este rasgo pueden responder a lo siguiente comandos como parte de la operación EXECUTE. Para aprender Para obtener más información sobre cómo controlar 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

Reanuda 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 hacia delante (int positivo) o hacia atrás (int negativo) a buscar.

Ejemplos

Avanzar 10 s

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

Avanzar 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 la que se va a buscar.

Ejemplos

Avanza hasta 30 s

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

action.devices.commands.mediaRepeatMode

Establece el modo de repetición de reproducció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, el valor verdadero significa activar el modo de repetición de un solo elemento; falso significa activar el modo de repetición normal (por ejemplo, una playlist).

Ejemplos

Repetir en

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

Desactivar repetición

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

Cómo repetir una sola pista

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

action.devices.commands.mediaShuffle

Reproducir 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 opcionales.
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"
  }
}

Activa los subtítulos en coreano con una consulta de un 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 opcionales

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

ERRORES DE DISPOSITIVO

Consulta la lista completa de errores y excepciones.