Esquema do traço TransportControl de casa inteligente
action.devices.traits.TransportControl
: essa característica é usada em dispositivos capazes de controlar a reprodução de mídia (por exemplo, retomar uma 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 o gerenciamento de intents SYNC
, consulte
fulfillment de intents.
Atributos | Tipo | Descrição |
---|---|---|
transportControlSupportedCommands |
Array |
Obrigatório. Uma lista de strings que descrevem os comandos de controle de transporte suportados no dispositivo. |
[item, ...] |
String |
Comandos compatíveis. Os valores suportados são:
|
Exemplos
Comandos de reprodução no dispositivo
{ "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 o gerenciamento de intents EXECUTE
, consulte
fulfillment de intents.
action.devices.commands.mediaStop
Pausar a 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 a 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 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 de avanço (int positivo) ou de trás (int) negativo a ser buscado. |
Exemplos
Avançar 10 segundos
{ "command": "action.devices.commands.mediaSeekRelative", "params": { "relativePositionMs": 10000 } }
Ir 10 segundos para trás
{ "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
Procurar até 30 segundos
{ "command": "action.devices.commands.mediaSeekToPosition", "params": { "absPositionMs": 30000 } }
action.devices.commands.mediaRepeatMode
Defina o modo de repetição de reprodução.
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: Se especificado, "true" significa ativar o modo de repetição de item único, e "false" significa ativar o modo de repetição normal (por exemplo, uma playlist). |
Exemplos
Repetir em
{ "command": "action.devices.commands.mediaRepeatMode", "params": { "isOn": true } }
Repetição do vídeo
{ "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 do closed caption. |
userQueryLanguage |
String |
Idioma ou localidade da consulta do usuário. |
Exemplos
Ativar closed caption em inglês
{ "command": "action.devices.commands.mediaClosedCaptioningOn", "params": { "closedCaptioningLanguage": "en" } }
Ativar closed caption 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
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 legendas
{ "command": "action.devices.commands.mediaClosedCaptioningOff", "params": {} }