Esquema de características do Smart Home FanSpeed
action.devices.traits.FanSpeed
: essa característica pertence a dispositivos que permitem definir a velocidade de um ventilador.
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 |
---|---|---|
reversible |
Booleano |
Padrão: Se ela for definida como verdadeira, o dispositivo terá a capacidade de assombrar o ventilador nas duas direções e poderá aceitar o comando para inverter a direção do ventilador. |
commandOnlyFanSpeed |
Booleano |
Padrão: Indica se o dispositivo suporta o uso de comunicação unidirecional (verdadeiro) ou bidirecional (falso). Defina esse atributo como verdadeiro se o dispositivo não puder responder a uma intent QUERY ou a um estado de relatório para essa característica. |
Contém qualquer um dos seguintes itens: | ||
0
|
Object |
Suporte para configurações de velocidade. |
availableFanSpeeds |
Object |
Obrigatório. Configurações de velocidade compatíveis com o dispositivo. |
speeds |
Array |
Obrigatório. Lista de configurações de velocidade. |
[item, ...] |
Object |
Configuração de velocidade. |
speed_name |
String |
Obrigatório. Nome interno da configuração de velocidade. Essa página pode ser fácil de usar e será compartilhada em todos os idiomas. |
speed_values |
Array |
Obrigatório. Sinônimos para a configuração de velocidade em cada idioma suportado. |
[item, ...] |
Object |
Sinônimo da configuração de velocidade em um determinado idioma. |
speed_synonym |
Array |
Obrigatório. Sinônimos para a configuração de velocidade devem incluir formas no singular e plural, se aplicável. O primeiro sinônimo da lista será considerado como o nome canônico da configuração de velocidade. |
[item, ...] |
String |
Sinônimo. |
lang |
String |
Obrigatório. Código do idioma (ISO 639-1). Consulte os idiomas compatíveis. |
ordered |
Booleano |
Obrigatório. Se definida como verdadeira, a gramática adicional para lógica de aumento ou diminuição será aplicada, na ordem (aumento) da matriz de velocidades. |
1
|
Object |
Compatibilidade com a porcentagem de velocidade. |
supportsFanSpeedPercent |
Booleano |
Obrigatório. Padrão: Se ela for definida como verdadeira, o dispositivo aceitará comandos para ajustar a velocidade usando uma porcentagem de 0,0 a 100,0. |
Exemplos
Dispositivo com duas configurações de velocidade e suporte a ajustes de porcentagem e direção inversa.
{ "availableFanSpeeds": { "speeds": [ { "speed_name": "speed_low", "speed_values": [ { "speed_synonym": [ "Low", "Slow" ], "lang": "en" } ] }, { "speed_name": "speed_high", "speed_values": [ { "speed_synonym": [ "High", "Fast" ], "lang": "en" } ] } ], "ordered": true }, "reversible": true, "supportsFanSpeedPercent": true }
STATES do dispositivo
Entidades com essa característica podem relatar os estados
a seguir como parte da operação QUERY
. Para saber
mais sobre como processar intents QUERY
, consulte
fulfillment de intent.
Estados | Tipo | Descrição |
---|---|---|
currentFanSpeedSetting |
String |
Representa o nome interno da configuração de velocidade atual do atributo |
currentFanSpeedPercent |
Número |
Indica a velocidade atual do ventilador por porcentagem. Obrigatório se o atributo |
Exemplos
Qual é a velocidade dos fãs na sala de estar?
{ "currentFanSpeedSetting": "speed_low", "currentFanSpeedPercent": 10 }
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.SetFanSpeed
Definir a velocidade.
Parâmetros
O payload contém um dos seguintes itens:
Defina a velocidade por configurações.
Parâmetros | Tipo | Descrição |
---|---|---|
fanSpeed |
String |
Obrigatório. As configurações de velocidade solicitadas do ventilador. |
Definir a velocidade por porcentagem.
Parâmetros | Tipo | Descrição |
---|---|---|
fanSpeedPercent |
Número |
Obrigatório. A porcentagem de configuração de velocidade solicitada. |
Exemplos
Defina o ventilador como alto.
{ "command": "action.devices.commands.SetFanSpeed", "params": { "fanSpeed": "speed_high" } }
Defina o ventilador em 50%.
{ "command": "action.devices.commands.SetFanSpeed", "params": { "fanSpeedPercent": 50 } }
action.devices.commands.SetFanSpeedRelative
Defina a velocidade relativa.
Esse comando requer os seguintes atributos:{ "commandOnlyFanSpeed": true }
Parâmetros
O payload contém um dos seguintes itens:
Definir a velocidade relativa por peso.
Parâmetros | Tipo | Descrição |
---|---|---|
fanSpeedRelativeWeight |
Número inteiro |
Obrigatório. Esse valor indica o valor relativo da mudança de velocidade. O valor absoluto indica o valor ajustado, enquanto o sinal numérico indica a direção da mudança. |
Defina a velocidade relativa por porcentagem.
Parâmetros | Tipo | Descrição |
---|---|---|
fanSpeedRelativePercent |
Número |
Obrigatório. Esse valor representa a porcentagem de velocidade a ser alterada. |
Exemplos
Reduza a velocidade do ventilador.
{ "command": "action.devices.commands.SetFanSpeedRelative", "params": { "fanSpeedRelativeWeight": -1 } }
Aumentar a velocidade do ventilador em 10%
{ "command": "action.devices.commands.SetFanSpeedRelative", "params": { "fanSpeedRelativePercent": 10 } }
action.devices.commands.Reverse
Inverter a direção do ventilador.
Esse comando requer os seguintes atributos:{ "reversible": true }
Parâmetros
Parâmetros | Tipo | Descrição |
---|---|---|
Não há propriedades |
Exemplos
Inverta a direção do ventilador.
{ "command": "action.devices.commands.Reverse", "params": {} }
Exemplos de declarações
de-DE
-
stell die Geschwindigkeit
vom Ventilator aufhoch
en-US
-
drop
the AC fan speed tomedium
es-ES
-
cambia la velocidad del
ventilador amedio
fr-FR
-
mets
la ventilation aumaximum
hi-IN
-
बेडरूम में पंखे
की गति
मीडियम करें
it-IT
-
metti
il condizionatore in salotto a velocitàmedia
ja-JP
-
エアコン の風量を高速 にセット
ko-KR
-
선풍기 강풍 으로 틀어 줘
nl-NL
-
zet de snelheid van
de ventilator opmedium
pt-BR
-
definir a velocidade do
ventilador parabaixa -
põe
a ventoinha nomáximo
sv-SE
-
Ställ in
fläkten påmedel
Dispositivo ERRORS
Veja a lista completa de erros e exceções.maxSpeedReached
: o dispositivo já está definido para a velocidade máxima.minSpeedReached
: o dispositivo já está definido para a velocidade mínima.