Esquema de características do Smart Home TransportControl

action.devices.traits.TransportControl: esta 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

Os dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC. Para saber mais sobre como lidar com intents SYNC, consulte fulfillment de 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. Os valores suportados são: 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

Nenhuma.

Dispositivo COMMANDS

Os dispositivos com essa característica podem responder aos comandos a seguir como parte da operação EXECUTE. Para saber mais sobre como lidar com intents EXECUTE, consulte fulfillment de intent.

action.devices.commands.mediaStop

Pausar 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

Pular 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 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 inverso (int positivo) ou reverso (int negativo) a serem buscados.

Exemplos

Olhar para frente

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

Voltar 10 segundos

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

action.devices.commands.mediaSeekToPosition

Busque 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

Procurar 30 segundos

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

action.devices.commands.mediaRepeatMode

Definir o modo de reprodução repetida.

Esse comando requer os seguintes atributos:

{
  "transportControlSupportedCommands": [
    "SET_REPEAT"
  ]
}

Parâmetros

Parâmetros	Tipo	Descrição
isOn	Booleano	Obrigatório. Verdadeiro para ativar o modo de repetição, falso 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

Reproduza aleatoriamente a lista de reprodução atual.

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 para legendas ocultas.
userQueryLanguage	String	Idioma ou localidade para a consulta do usuário.

Exemplos

Ativar closed captions em inglês

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

Ativar closed captions em coreano

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

Ativar legendas em coreano com a consulta do usuário em inglês americano

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

action.devices.commands.mediaClosedCaptioningOff

Desativar legendas.

Esse comando requer os seguintes atributos:

{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

Parâmetros

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

Exemplos

Desativar legendas

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

Dispositivo ERRORS

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