Esquema do traço de volume da casa inteligente
action.devices.traits.Volume
: essa característica pertence a dispositivos que podem mudar o volume, como ativar ou desativar o som em um determinado nível.
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 |
---|---|---|
volumeMaxLevel |
Número inteiro |
Obrigatório. O nível de volume máximo, presumindo um valor de referência de 0 (mudo). O Google Assistente ajustará os comandos adverbiais (por exemplo, "deixar a TV um pouco mais alta") conforme necessário. |
volumeCanMuteAndUnmute |
Booleano |
Obrigatório. Indica se o dispositivo pode ativar e desativar o som. Essa opção é separada, já que essa opção muda o volume para 0 sem perder o volume anterior. Dessa forma, ele é restaurado. Isso é refletido no estado de volume: se o volume for 5 e o usuário desativar o som, ele permanecerá como 5 e |
volumeDefaultPercentage |
Número inteiro |
Padrão: O volume (em porcentagem) do volume padrão definido pelo usuário ou fabricante. A escala precisa ser de 0 a 100. |
levelStepSize |
Número inteiro |
Padrão: A taxa de aprendizado padrão para consultas de volume relativo, como "aumentar volume em <device_name>". |
commandOnlyVolume |
Booleano |
Padrão: Indica se o dispositivo opera usando comunicação unidirecional (verdadeiro) ou bidirecional (falso). Por exemplo, se o controlador puder confirmar o novo estado do dispositivo após enviar a solicitação, esse campo será falso. Se não for possível confirmar se a solicitação foi executada com êxito ou obter o estado do dispositivo (por exemplo, se o dispositivo for um controle remoto infravermelho tradicional), defina esse campo como verdadeiro. |
Exemplos
Alto-falante que pode ser silenciado e informa o estado atual
{ "volumeMaxLevel": 11, "volumeCanMuteAndUnmute": true, "levelStepSize": 2, "commandOnlyVolume": false, "volumeDefaultPercentage": 6 }
STATES do dispositivo
Entidades com essa característica podem informar os seguintes estados como parte da operação QUERY
. Para saber
mais sobre o gerenciamento de intents QUERY
, consulte
fulfillment de intents.
Estados | Tipo | Descrição |
---|---|---|
currentVolume |
Número inteiro |
Obrigatório. A porcentagem do volume atual. O valor precisa estar entre |
isMuted |
Booleano |
Obrigatório se o atributo |
Exemplos
Alto-falante que pode ser silenciado e informa o estado atual
{ "currentVolume": 5, "isMuted": false }
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.mute
Desativa ou ativa o som do dispositivo.
Parâmetros
Parâmetros | Tipo | Descrição |
---|---|---|
mute |
Booleano |
Obrigatório. Ativar ou desativar o som de um dispositivo. |
Exemplos
Desativar som do alto-falante
{ "command": "action.devices.commands.mute", "params": { "mute": true } }
action.devices.commands.setVolume
Definir o volume para o nível solicitado, com base em volumeMaxLevel
.
Parâmetros
Parâmetros | Tipo | Descrição |
---|---|---|
volumeLevel |
Número inteiro |
Obrigatório. Novo volume, de |
Exemplos
Definir o volume absoluto do alto-falante
{ "command": "action.devices.commands.setVolume", "params": { "volumeLevel": 6 } }
action.devices.commands.volumeRelative
Aumentar ou diminuir o volume em n etapas, com base em volumeMaxLevel
. Para comandos que usam uma escala relativa, o Assistente selecionará n da forma apropriada para dimensioná-lo de acordo com os passos disponíveis. Por exemplo, Aumentar o volume da TV definirá um número de passos maior do que Aumentar o volume da TV.
Parâmetros
Parâmetros | Tipo | Descrição |
---|---|---|
relativeSteps |
Número inteiro |
Obrigatório. negativo para "diminuir". |
Exemplos
Definir o volume relativo do alto-falante no modo somente comando
{ "command": "action.devices.commands.volumeRelative", "params": { "relativeSteps": -1 } }
ERROS DO Dispositivo
Veja a lista completa de erros e exceções.volumeAlreadyMax
: o dispositivo recebe o comandoVolumeUp
quando já está no volume mais alto.volumeAlreadyMin
: o dispositivo recebe o comandoVolumeDown
quando já está no volume mais baixo.