Esquema del rasgo FanSpeed de Smart Home
action.devices.traits.FanSpeed
: Este rasgo pertenece a los dispositivos que admiten el ajuste de la velocidad de un ventilador.
Atributos del dispositivo
Los dispositivos con este rasgo pueden informar los siguientes atributos como parte de la operación SYNC
. Para obtener más información sobre cómo controlar intents de SYNC
, consulta Entrega de intents.
Atributos | Tipo | Descripción |
---|---|---|
reversible |
Booleano |
(Predeterminado: Si se establece como verdadero, este dispositivo admite el ventilador en ambas direcciones y puede aceptar el comando para invertir la dirección del ventilador. |
commandOnlyFanSpeed |
Booleano |
(Predeterminado: Indica si el dispositivo admite la comunicación unidireccional (verdadero) o bidireccional (falso). Establece este atributo como verdadero si el dispositivo no puede responder a una intención de QUERY o a un Report State para este rasgo. |
Contiene cualquiera de los siguientes elementos: | ||
0
|
Objeto |
Se agregó compatibilidad con la configuración de velocidad. |
availableFanSpeeds |
Objeto |
Obligatorio. Es la configuración de velocidad que admite el dispositivo. |
speeds |
Matriz |
Obligatorio. Lista de parámetros de configuración de velocidad. |
[item, ...] |
Objeto |
Ajuste de velocidad |
speed_name |
String |
Obligatorio. Nombre interno del parámetro de configuración de velocidad. Esto puede no ser fácil de usar y se compartirá en todos los idiomas. |
speed_values |
Matriz |
Obligatorio. Son sinónimos del parámetro de configuración de velocidad en cada idioma admitido. |
[item, ...] |
Objeto |
Sinónimo del parámetro de configuración de velocidad en un idioma determinado. Se requiere al menos un elemento con un valor de |
speed_synonym |
Matriz |
Obligatorio. Sinónimos para el parámetro de configuración de velocidad. Deben incluir las formas en singular y plural, 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. Se requiere al menos un elemento con un valor de |
lang |
String |
Obligatorio. Código de idioma (ISO 639-1). Consulta los idiomas admitidos. |
ordered |
Booleano |
Obligatorio. Si se establece como verdadero, se aplicará una gramática adicional para la lógica de aumento o disminución, en el orden (aumento) del array de velocidades. |
1
|
Objeto |
Se agregó compatibilidad con el porcentaje de velocidad. |
supportsFanSpeedPercent |
Booleano |
Obligatorio. (Predeterminado: Si se establece en verdadero, este dispositivo aceptará comandos para ajustar la velocidad con un porcentaje de 0.0 a 100.0. |
Ejemplos
Dispositivo con dos ajustes de velocidad, compatibilidad con la dirección inversa y 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 }
ESTADOS del dispositivo
Las entidades con este rasgo pueden informar los siguientes estados como parte de la operación QUERY
. Para obtener más información sobre cómo controlar intents de QUERY
, consulta Entrega de intents.
Estados | Tipo | Descripción |
---|---|---|
currentFanSpeedSetting |
String |
Representa el nombre interno del parámetro de configuración de velocidad actual del atributo |
currentFanSpeedPercent |
Número |
Indica la velocidad actual del ventilador en porcentaje. Obligatorio si el atributo |
Ejemplos
¿A qué velocidad están los ventiladores de la sala de estar?
{ "currentFanSpeedSetting": "speed_low", "currentFanSpeedPercent": 10 }
COMANDOS del dispositivo
Los dispositivos con este rasgo pueden responder a los siguientes comandos como parte de la operación EXECUTE
. Para obtener más información sobre cómo controlar intents de EXECUTE
, consulta Entrega de intents.
action.devices.commands.SetFanSpeed
Establece la velocidad.
Parámetros
La carga útil contiene uno de los siguientes elementos:
Establece la velocidad según la configuración.
Parámetros | Tipo | Descripción |
---|---|---|
fanSpeed |
String |
Obligatorio. Es 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
Coloca el ventilador en la velocidad alta.
{ "command": "action.devices.commands.SetFanSpeed", "params": { "fanSpeed": "speed_high" } }
Establece el ventilador en un 50%.
{ "command": "action.devices.commands.SetFanSpeed", "params": { "fanSpeedPercent": 50 } }
action.devices.commands.SetFanSpeedRelative
Establece la velocidad relativa.
Este comando requiere los siguientes atributos:{ "commandOnlyFanSpeed": true }
Parámetros
La carga útil contiene uno de los siguientes elementos:
Establece la velocidad relativa según el 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. |
Establece la velocidad relativa por porcentaje.
Parámetros | Tipo | Descripción |
---|---|---|
fanSpeedRelativePercent |
Número |
Obligatorio. Este valor representa el porcentaje de velocidad que se debe cambiar. |
Ejemplos
Baja un poco 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
Invierte 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
ERRORES del dispositivo
Consulta la lista completa de errores y excepciones.maxSpeedReached
: El dispositivo ya está configurado en la velocidad máxima.minSpeedReached
: El dispositivo ya está establecido en la velocidad mínima.