Esquema del atributo FanSpeed de la casa inteligente

action.devices.traits.FanSpeed: Este atributo pertenece a los dispositivos que admiten la configuración de la velocidad de un ventilador.

Las velocidades del ventilador (es decir, la expulsión de aire del dispositivo en varios niveles, que pueden ser parte de una unidad de aire acondicionado o calefacción, o en un automóvil) pueden incluir parámetros de configuración como bajo, medio y alto, o un porcentaje.

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 cómo controlar intents SYNC, consulta Cómo entregar intents.

Atributos Tipo Descripción
reversible Booleano

(Predeterminado: false)

Si se establece como verdadero, este dispositivo admite que el ventilador sople en ambas direcciones y puede aceptar el comando para invertir la dirección del ventilador.
commandOnlyFanSpeed Booleano

(Predeterminado: false)

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 un intent de QUERY o a un estado de informe para esta función.
Contiene cualquiera de los siguientes elementos:
0 Objeto

Compatibilidad con la configuración de velocidad
availableFanSpeeds Objeto

Obligatorio.

Configuración de velocidad que admite el dispositivo
speeds Matriz

Obligatorio.

Lista de parámetros de configuración de velocidad.
[item, ...] Objeto

Configuración de velocidad
speed_name String

Obligatorio.

Es el nombre interno de la configuración de velocidad. Esto puede no ser fácil de usar y se compartirá en todos los idiomas.
speed_values Matriz

Obligatorio.

Sinónimos para la configuración de velocidad en cada idioma admitido.
[item, ...] Objeto

Es un sinónimo de la configuración de velocidad en un idioma determinado.
speed_synonym Matriz

Obligatorio.

Los sinónimos para el parámetro de configuración de velocidad deben incluir las formas 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.
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 (aumentando) del array de velocidades.
1 Objeto

Compatibilidad con el porcentaje de velocidad
supportsFanSpeedPercent Booleano

Obligatorio.

(Predeterminado: false)

Si se establece como verdadero, 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 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 atributo pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre cómo controlar intents QUERY, consulta Cómo entregar intents.

Estados Tipo Descripción
currentFanSpeedSetting String

Representa el nombre interno de la configuración de velocidad actual del atributo availableFanSpeeds.
currentFanSpeedPercent Número

Indica la velocidad actual del ventilador en porcentaje. Obligatorio si el atributo supportsFanSpeedPercent se establece en true

Ejemplos

¿A qué velocidad funcionan los ventiladores de la sala de estar?

{
  "currentFanSpeedSetting": "speed_low",
  "currentFanSpeedPercent": 10
}

COMANDOS del dispositivo

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 cómo controlar intents EXECUTE, consulta Cómo entregar intents.

action.devices.commands.SetFanSpeed

Establece la 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.

Es la configuración de velocidad solicitada del ventilador.

Establece la velocidad en porcentaje.

Parámetros Tipo Descripción
fanSpeedPercent Número

Obligatorio.

Es el porcentaje de configuración de velocidad solicitado.

Ejemplos

Establece el ventilador en alta.

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeed": "speed_high"
  }
}

Establece el ventilador en 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 una de las siguientes opciones:

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 el importe ajustado, mientras que el signo numérico indica la dirección del cambio.

Establece la velocidad relativa en porcentaje.

Parámetros Tipo Descripción
fanSpeedRelativePercent Número

Obligatorio.

Este valor representa el porcentaje de velocidad que se cambiará.

Ejemplos

Baja un poco la velocidad del ventilador.

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativeWeight": -1
  }
}

Sube la velocidad del ventilador 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á configurado en la velocidad mínima.