Esquema de la función de Velocidad del ventilador de casa inteligente
action.devices.traits.FanSpeed
: Esta característica pertenece a los dispositivos que admiten la configuración de la velocidad de un ventilador.
ATRIBUTOS DEL DISPOSITIVO
Los dispositivos con esta característica pueden informar los siguientes atributos como parte de la operación SYNC
. Para obtener más información sobre el manejo de intents SYNC
, consulta Entrega de intents.
Atributos | Tipo | Descripción |
---|---|---|
reversible |
Booleano |
(Predeterminado: Si se configura como verdadera, el dispositivo admite hacer volar el ventilador en ambas direcciones y puede aceptar el comando para revertir la dirección del ventilador. |
commandOnlyFanSpeed |
Booleano |
(Predeterminado: Indica si el dispositivo admite el uso de comunicación unidireccional (verdadero) o bidireccional (falso). Establece este atributo como verdadero si el dispositivo no puede responder a un intent QUERY o al estado de informe para esta característica. |
Contiene cualquiera de los siguientes elementos: | ||
0
|
Objeto |
Compatibilidad con la configuración de velocidad. |
availableFanSpeeds |
Objeto |
Obligatorio. La configuración de velocidad es compatible con el dispositivo. |
speeds |
Matriz |
Obligatorio. Lista de parámetros de configuración de velocidad. |
[item, ...] |
Objeto |
Configuración de velocidad. |
speed_name |
String |
Obligatorio. Nombre interno del parámetro de configuración de velocidad. Esto puede ser poco fácil de usar y se compartirá en todos los idiomas. |
speed_values |
Matriz |
Obligatorio. Sinónimos de la configuración de velocidad en cada idioma compatible. |
[item, ...] |
Objeto |
Sinónimo de la configuración de velocidad en un idioma determinado. |
speed_synonym |
Matriz |
Obligatorio. Los sinónimos de la configuración de velocidad deben incluir formas singulares y plurales, si corresponde. El primer sinónimo de la lista se considerará el nombre canónico del parámetro de configuración de velocidad. |
[item, ...] |
String |
Sinónimo. |
lang |
String |
Obligatorio. Código de idioma (ISO 639-1). Consulta los idiomas compatibles. |
ordered |
Booleano |
Obligatorio. Si se establece como verdadera, se aplicará una gramática adicional para la lógica de aumento o disminución, en el orden (creciente) del array de velocidades. |
1
|
Objeto |
Compatibilidad con el porcentaje de velocidad. |
supportsFanSpeedPercent |
Booleano |
Obligatorio. (Predeterminado: Si se establece como verdadera, este dispositivo aceptará comandos para ajustar la velocidad con un porcentaje de 0.0 a 100.0. |
Ejemplos
Dispositivo con dos parámetros de configuración de velocidad, compatibilidad con la dirección inversa y los ajustes de porcentaje.
{ "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 }
Dispositivo STATEs
Las entidades con esta característica pueden informar los siguientes estados como parte de la operación QUERY
. Para obtener más información sobre el manejo de intents QUERY
, consulta Entrega de intents.
Estados | Tipo | Descripción |
---|---|---|
currentFanSpeedSetting |
String |
Representa el nombre interno de la configuración de velocidad actual del atributo |
currentFanSpeedPercent |
Número |
Indica la velocidad actual del ventilador según el porcentaje. Obligatorio si el atributo |
Ejemplos
¿Qué velocidad tienen los ventiladores de la sala de estar?
{ "currentFanSpeedSetting": "speed_low", "currentFanSpeedPercent": 10 }
Dispositivo COMMANDS
Los dispositivos con esta característica pueden responder a los siguientes comandos como parte de la operación EXECUTE
. Para obtener más información sobre el manejo de intents EXECUTE
, consulta Entrega de intents.
action.devices.commands.SetFanSpeed
Establecer velocidad.
Parámetros
La carga útil contiene una de las siguientes opciones:
Establece la velocidad según la configuración.
Parámetros | Tipo | Descripción |
---|---|---|
fanSpeed |
String |
Obligatorio. La configuración de velocidad solicitada del ventilador. |
Establece la velocidad por porcentaje.
Parámetros | Tipo | Descripción |
---|---|---|
fanSpeedPercent |
Número |
Obligatorio. Es el porcentaje de configuración de velocidad solicitado. |
Ejemplos
Establece el ventilador en alto.
{ "command": "action.devices.commands.SetFanSpeed", "params": { "fanSpeed": "speed_high" } }
Establece el ventilador al 50%.
{ "command": "action.devices.commands.SetFanSpeed", "params": { "fanSpeedPercent": 50 } }
action.devices.commands.SetFanSpeedRelative
Establecer velocidad relativa.
Este comando requiere los siguientes atributos:{ "commandOnlyFanSpeed": true }
Parámetros
La carga útil contiene una de las siguientes opciones:
Establecer velocidad relativa por peso.
Parámetros | Tipo | Descripción |
---|---|---|
fanSpeedRelativeWeight |
Número entero |
Obligatorio. Este valor indica la cantidad relativa del cambio de velocidad. El valor absoluto indica la cantidad ajustada, mientras que el signo numérico indica la dirección del cambio. |
Establecer la velocidad relativa en función de un porcentaje
Parámetros | Tipo | Descripción |
---|---|---|
fanSpeedRelativePercent |
Número |
Obligatorio. Este valor representa el porcentaje de velocidad que se cambiará. |
Ejemplos
Baja la velocidad del ventilador.
{ "command": "action.devices.commands.SetFanSpeedRelative", "params": { "fanSpeedRelativeWeight": -1 } }
Aumenta la velocidad del ventilador en un 10%.
{ "command": "action.devices.commands.SetFanSpeedRelative", "params": { "fanSpeedRelativePercent": 10 } }
action.devices.commands.Reverse
Invertir la dirección del ventilador
Este comando requiere los siguientes atributos:{ "reversible": true }
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
Sin propiedades |
Ejemplos
Invierte la dirección del ventilador.
{ "command": "action.devices.commands.Reverse", "params": {} }
Expresiones de muestra
de-DE
- stell die Geschwindigkeit vom Ventilator auf hoch
en-US
- drop the AC fan speed to medium
es-ES
- cambia la velocidad del ventilador a medio
fr-FR
- mets la ventilation au maximum
hi-IN
- बेडरूम में पंखे की गति मीडियम करें
it-IT
- metti il condizionatore in salotto a velocità media
ja-JP
- エアコン の風量を 高速 にセット
ko-KR
- 선풍기 강풍 으로 틀어 줘
nl-NL
- zet de snelheid van de ventilator op medium
pt-BR
- definir a velocidade do ventilador para baixa
- põe a ventoinha no máximo
sv-SE
- Ställ in fläkten på medel
Dispositivo ERRORS
Consulta la lista completa de errores y excepciones.maxSpeedReached
: El dispositivo ya está configurado en la velocidad máxima.minSpeedReached
: El dispositivo ya está configurado en la velocidad mínima.