Esquema do traço TransportControl da casa inteligente

action.devices.traits.TransportControl: essa característica é usada para dispositivos que podem controlar a reprodução de mídia (por exemplo, retomar música enquanto ela está pausada).

ATRIBUTOS DO dispositivo

Dispositivos com essa característica podem relatar o seguinte atributos como parte da operação SYNC. Para saber mais sobre como lidar com intents SYNC, consulte Fulfillment da intent.

Atributos	Tipo	Descrição
transportControlSupportedCommands	Array	Obrigatório. Uma lista de strings que descrevem os comandos de controle de transporte compatíveis neste dispositivo.
[item, ...]	String	Comandos compatíveis. Valores compatíveis: CAPTION_CONTROL NEXT PAUSE PREVIOUS RESUME SEEK_RELATIVE SEEK_TO_POSITION SET_REPEAT SHUFFLE STOP

Exemplos

Dispositivo com suporte a comandos de reprodução

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

STATES do dispositivo

Nenhum.

COMANDOS DO dispositivo

Dispositivos com essa característica podem responder ao seguinte como parte da operação EXECUTE. Para saber mais sobre como lidar com intents EXECUTE, consulte Fulfillment da intent.

action.devices.commands.mediaStop

Pausar a reprodução de mídia.

Esse comando requer os seguintes atributos:

{
  "transportControlSupportedCommands": [
    "STOP"
  ]
}

Parâmetros

Parâmetros	Tipo	Descrição
Não há propriedades

Exemplos

Nenhum parâmetro

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

action.devices.commands.mediaNext

Pular para o próximo item de mídia.

Esse comando requer os seguintes atributos:

{
  "transportControlSupportedCommands": [
    "NEXT"
  ]
}

Parâmetros

Parâmetros	Tipo	Descrição
Não há propriedades

Exemplos

Nenhum parâmetro

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

action.devices.commands.mediaPrevious

Voltar para o item de mídia anterior.

Esse comando requer os seguintes atributos:

{
  "transportControlSupportedCommands": [
    "PREVIOUS"
  ]
}

Parâmetros

Parâmetros	Tipo	Descrição
Não há propriedades

Exemplos

Nenhum parâmetro

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

action.devices.commands.mediaPause

Pausar a reprodução de mídia.

Esse comando requer os seguintes atributos:

{
  "transportControlSupportedCommands": [
    "PAUSE"
  ]
}

Parâmetros

Parâmetros	Tipo	Descrição
Não há propriedades

Exemplos

Nenhum parâmetro

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

action.devices.commands.mediaResume

Retomar a reprodução de mídia.

Esse comando requer os seguintes atributos:

{
  "transportControlSupportedCommands": [
    "RESUME"
  ]
}

Parâmetros

Parâmetros	Tipo	Descrição
Não há propriedades

Exemplos

Nenhum parâmetro

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

action.devices.commands.mediaSeekRelative

Procure uma posição relativa.

Esse comando requer os seguintes atributos:

{
  "transportControlSupportedCommands": [
    "SEEK_RELATIVE"
  ]
}

Parâmetros

Parâmetros	Tipo	Descrição
relativePositionMs	Número inteiro	Obrigatório. Milissegundos do valor adiantado (int positivo) ou atrasado (int negativo) a ser buscado.

Exemplos

Avançar dez segundos

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

Retroceder 10s

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

action.devices.commands.mediaSeekToPosition

Procure uma posição absoluta.

Esse comando requer os seguintes atributos:

{
  "transportControlSupportedCommands": [
    "SEEK_TO_POSITION"
  ]
}

Parâmetros

Parâmetros	Tipo	Descrição
absPositionMs	Número inteiro	Obrigatório. Milissegundos da posição absoluta a ser buscada.

Exemplos

Ir para os 30 segundos

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

action.devices.commands.mediaRepeatMode

Define o modo de repetição da reprodução.

Esse comando requer os seguintes atributos:

{
  "transportControlSupportedCommands": [
    "SET_REPEAT"
  ]
}

Parâmetros

Parâmetros	Tipo	Descrição
isOn	Booleano	Obrigatório. "True" para ativar o modo de repetição, "false" para desativar o modo de repetição.
isSingle	Booleano	Padrão: false. Se especificado, verdadeiro significa ativar o modo de repetição de item único, falso significa ativar o modo de repetição normal (por exemplo, uma playlist).

Exemplos

Repetir em

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

Repetir desativado

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

Repetir uma única faixa

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

action.devices.commands.mediaShuffle

Tocar a playlist atual em ordem aleatória.

Esse comando requer os seguintes atributos:

{
  "transportControlSupportedCommands": [
    "SHUFFLE"
  ]
}

Parâmetros

Parâmetros	Tipo	Descrição
Não há propriedades

Exemplos

Nenhum parâmetro

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

action.devices.commands.mediaClosedCaptioningOn

Ative as legendas.

Esse comando requer os seguintes atributos:

{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

Parâmetros

Parâmetros	Tipo	Descrição
closedCaptioningLanguage	String	Idioma ou localidade das legendas descritivas.
userQueryLanguage	String	Idioma ou localidade para a consulta do usuário.

Exemplos

Ativar as legendas em inglês

{
  "command": "action.devices.commands.mediaClosedCaptioningOn",
  "params": {
    "closedCaptioningLanguage": "en"
  }
}

Ativar as legendas em coreano

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

Ativar closed caption em coreano com consulta de usuário em inglês americano

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

action.devices.commands.mediaClosedCaptioningOff

Desative as legendas.

Esse comando requer os seguintes atributos:

{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

Parâmetros

Parâmetros	Tipo	Descrição
Não há propriedades

Exemplos

Desativar as legendas

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

ERROS no dispositivo

Veja a lista completa de erros e exceções.