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