Te damos la bienvenida al Centro para desarrolladores de Google Home, el nuevo destino para aprender a desarrollar acciones para el hogar inteligente. Nota: Continuarás compilando acciones en la Consola de Actions.
Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Esquema de la función Velocidad del ventilador para el hogar inteligente

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

Las velocidades de los ventiladores (es decir, soplar aire desde el dispositivo en varios niveles, que pueden ser parte de un aire acondicionado o de una unidad de calefacción, o en un automóvil), pueden incluir configuraciones como baja, media y alta o un porcentaje.

ATTRIBUTES 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: false)

Si se establece como verdadera, el dispositivo sopla 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 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 al estado del 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 que admite el dispositivo.

speeds Matriz

Obligatorio.

Lista de opciones de configuración de velocidad.

[item, ...] Objeto

Configuración de velocidad.

speed_name String

Obligatorio.

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 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 para la configuración de velocidad deben incluir formas en singular y plural, 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). Consulte 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 (en aumento) del arreglo de velocidades.

1 Objeto

Compatibilidad con 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 configuraciones de velocidad, compatible con la dirección inversa y los ajustes porcentuales.

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

Los dispositivos 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

Esto representa el nombre interno de la configuración de velocidad actual del atributo availableFanSpeeds.

currentFanSpeedPercent Número

Indica la velocidad actual del ventilador según el porcentaje. Obligatorio si el atributo supportsFanSpeedPercent está configurado como true

Ejemplos

¿A qué velocidad están los fans en 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 para el 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 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 por peso.

Parámetros Tipo Descripción
fanSpeedRelativeWeight Número entero

Obligatorio.

Este valor indica el valor relativo 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 función del porcentaje.

Parámetros Tipo Descripción
fanSpeedRelativePercent Número

Obligatorio.

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

Ejemplos

Baja 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

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 Venmator vom aufhoch

en-US

  • Disminuye la velocidad del AC del ventilador en media.

es-ES

  • cambia la velocidad del ventilador a medio

fr-FR

  • mets la ventilation au máximo

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.