Te damos la bienvenida al Centro para desarrolladores de Google Home, el nuevo destino para aprender a desarrollar acciones para el hogar inteligente. Nota: Continuarás compilando acciones en la Consola de Actions.
Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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:

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

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

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

Dispositivo ERRORS

Consulta la lista completa de errores y excepciones.