Esquema de características de transporte inteligente de casa inteligente

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

ATRIBUTOS DO DISPOSITIVO

Dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC. Para saber mais sobre como processar 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 suportados. 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.

Comandos do dispositivo

Dispositivos com essa característica podem responder aos seguintes comandos como parte da operação EXECUTE. Para saber mais sobre como processar 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

Procurar 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 de avanço (positivo) ou reverso (int negativo) a ser buscado.

Exemplos

Avançar 10 segundos

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

Voltar 10 segundos

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

action.devices.commands.mediaSeekToPosition

Procurar 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 s

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

action.devices.commands.mediaRepeatMode

Defina 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 e "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 e 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 para legenda.
userQueryLanguage	String	Idioma ou localidade da consulta do usuário.

Exemplos

Ativar as 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 as closed captions 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 closed captions

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

Dispositivo ERRORS

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