Esquema del trait de velocidad del ventilador de una casa inteligente

action.devices.traits.FanSpeed: Esta característica pertenece a dispositivos que admiten la configuración de la velocidad de un ventilador.

Las velocidades del ventilador (es decir, soplar aire del dispositivo en varios niveles, que puede ser parte de una 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 DISPOSITIVOS

Los dispositivos con este trait pueden informar lo siguiente atributos como parte de la operación SYNC. Para aprender Para obtener más información sobre cómo controlar los intents SYNC, consulta Entrega de intents.

Atributos Tipo Descripción
reversible Booleano

(Predeterminado: false)

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

(Predeterminado: false)

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 de CONSULTA o a un estado de informe de esta característica.
Contiene cualquiera de los siguientes elementos:
0 Objeto

Compatibilidad con la configuración de velocidad.
availableFanSpeeds Objeto

Obligatorio.

Son los parámetros de 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.

Nombre interno de la configuración de velocidad. Esta opción no es 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 de la 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á la gramática adicional para la lógica de aumento o disminución, en el orden (aumento) de la matriz de velocidades.
1 Objeto

Compatibilidad con el porcentaje de velocidad.
supportsFanSpeedPercent Booleano

Obligatorio.

(Predeterminado: false)

Si la estableces como verdadera, el dispositivo aceptará comandos para ajustar la velocidad con un porcentaje de 0.0 a 100.0.

Ejemplos

Dispositivo con dos configuraciones de velocidad, compatibilidad con sentido inverso 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
}

Dispositivo STATES

Las entidades con esta característica pueden informar lo siguiente estados como parte de la operación QUERY. Para aprender Para obtener más información sobre cómo controlar los 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 availableFanSpeeds.
currentFanSpeedPercent Número

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

Ejemplos

¿Qué velocidad tienen los ventiladores de la sala de estar?

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

COMANDOS del dispositivo

Los dispositivos con este rasgo pueden responder a lo siguiente comandos como parte de la operación EXECUTE. Para aprender Para obtener más información sobre cómo controlar los intents EXECUTE, consulta Entrega de intents.

action.devices.commands.SetFanSpeed

Establecer velocidad.

Parámetros

La carga útil contiene uno de los siguientes elementos:

Establecer la velocidad según la configuración

Parámetros Tipo Descripción
fanSpeed String

Obligatorio.

La configuración de velocidad solicitada del ventilador.

Establecer la velocidad por porcentaje.

Parámetros Tipo Descripción
fanSpeedPercent Número

Obligatorio.

El porcentaje de la configuración de velocidad solicitado.

Ejemplos

Establece el ventilador en alto.

{
  "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

Establecer la velocidad relativa.

Este comando requiere los siguientes atributos: 
{
  "commandOnlyFanSpeed": true
}

Parámetros

La carga útil contiene uno de los siguientes elementos:

Establecer la 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 por 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
  }
}

Aumentar 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 DE DISPOSITIVO

Consulta la lista completa de errores y excepciones.
  • maxSpeedReached: El dispositivo ya está establecido en la velocidad máxima.
  • minSpeedReached: El dispositivo ya está establecido en la velocidad mínima.