Esquema de características de velocidade do ventilador da casa inteligente

action.devices.traits.FanSpeed : essa característica pertence a dispositivos que oferecem suporte à definição da velocidade de um ventilador.

As velocidades do ventilador (ou seja, o ar que sai do dispositivo em vários níveis, que pode fazer parte de uma unidade de ar condicionado ou aquecimento ou em um carro) podem incluir configurações como baixa, média e alta ou uma porcentagem.

ATRIBUTOS do dispositivo

Os dispositivos com essa característica podem informar os seguintes atributos como parte da SYNC operação. Para saber mais sobre como processar SYNC intents, consulte Processamento de intents.

Atributos Tipo Descrição
reversible Booleano

Padrão: false.

Se definido como verdadeiro, esse dispositivo oferece suporte à ventilação em ambas as direções e pode aceitar o comando para inverter a direção do ventilador.
commandOnlyFanSpeed Booleano

Padrão: false.

Indica se o dispositivo oferece suporte à comunicação unidirecional (verdadeira) ou bidirecional (falsa). Defina esse atributo como verdadeiro se o dispositivo não puder responder a um intent QUERY ou ao estado do relatório para essa característica.
Contém um dos seguintes itens:
0 Objeto

Suporte para configurações de velocidade.
availableFanSpeeds Objeto

Obrigatório.

Configurações de velocidade com suporte do dispositivo.
speeds Array

Obrigatório.

Lista de configurações de velocidade.
[item, ...] Objeto

Configuração de velocidade.
speed_name String

Obrigatório.

Nome interno da configuração de velocidade. Ele pode não ser fácil de usar e será compartilhado em todos os idiomas.
speed_values Array

Obrigatório.

Sinônimos para a configuração de velocidade em cada idioma com suporte.
[item, ...] Objeto

Sinônimo para a configuração de velocidade em um determinado idioma. Pelo menos um item com um valor lang de en é necessário para fornecer fallback de idioma.
speed_synonym Array

Obrigatório.

Sinônimos para a configuração de velocidade, incluindo formas singulares e plurais, quando aplicável. O primeiro sinônimo na lista será considerado o nome canônico da configuração de velocidade.
[item, ...] String

Sinônimo. Pelo menos um item com um valor lang de en é necessário para fornecer fallback de idioma.
lang String

Obrigatório.

Código de idioma (ISO 639-1). Veja os que são aceitos.
ordered Booleano

Obrigatório.

Se definido como verdadeiro, uma gramática adicional para a lógica de aumento ou diminuição será aplicada, na ordem (aumentando) da matriz de velocidades.
1 Objeto

Suporte para porcentagem de velocidade.
supportsFanSpeedPercent Booleano

Obrigatório.

Padrão: false.

Se definido como verdadeiro, esse dispositivo vai aceitar comandos para ajustar a velocidade usando uma porcentagem de 0,0 a 100,0.

Exemplos

Dispositivo com duas configurações de velocidade, suporte para direção inversa e ajustes de porcentagem.

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

As entidades com essa característica podem informar os seguintes estados como parte da QUERY operação. Para saber mais sobre como processar QUERY intents, consulte Processamento de intents.

Estados Tipo Descrição
currentFanSpeedSetting String

Representa o nome interno da configuração de velocidade atual do atributo availableFanSpeeds.
currentFanSpeedPercent Número

Indica a velocidade atual do ventilador por porcentagem. Obrigatório se o atributo supportsFanSpeedPercent estiver definido como true.

O valor precisa estar entre 0 e 100.

Exemplos

Qual é a velocidade dos ventiladores na sala de estar?

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

COMANDOS do dispositivo

Os dispositivos com essa característica podem responder aos seguintes comandos como parte da EXECUTE operação. Para saber mais sobre como processar EXECUTE intents, consulte Processamento de intents.

action.devices.commands.SetFanSpeed

Definir velocidade.

Parâmetros

O payload contém um dos seguintes:

Definir velocidade por configurações.

Parâmetros Tipo Descrição
fanSpeed String

Obrigatório.

As configurações de velocidade solicitadas do ventilador.

Definir velocidade por porcentagem.

Parâmetros Tipo Descrição
fanSpeedPercent Número

Obrigatório.

A porcentagem de configuração de velocidade solicitada.

O valor precisa estar entre 0 e 100.

Exemplos

Defina o ventilador como alto.

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

Defina o ventilador como 50%.

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeedPercent": 50
  }
}

action.devices.commands.SetFanSpeedRelative

Definir velocidade relativa.

Esse comando exige os seguintes atributos: 
{
  "commandOnlyFanSpeed": true
}

Parâmetros

O payload contém um dos seguintes:

Definir velocidade relativa por peso.

Parâmetros Tipo Descrição
fanSpeedRelativeWeight Número inteiro

Obrigatório.

Esse valor indica a quantidade relativa da mudança de velocidade. O valor absoluto indica a quantidade dimensionada, enquanto o sinal numérico indica a direção da mudança.

O valor precisa estar entre -5 e 5.

Definir velocidade relativa por porcentagem.

Parâmetros Tipo Descrição
fanSpeedRelativePercent Número

Obrigatório.

Esse valor representa a porcentagem de velocidade a ser alterada.

O valor precisa estar entre -100 e 100.

Exemplos

Diminua um pouco a velocidade do ventilador.

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

Aumente a velocidade do ventilador em 10%.

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativePercent": 10
  }
}

action.devices.commands.Reverse

Inverter a direção do ventilador.

Esse comando exige os seguintes atributos: 
{
  "reversible": true
}

Parâmetros

Parâmetros Tipo Descrição

Não há propriedades

Exemplos

Inverta a direção do ventilador.

{
  "command": "action.devices.commands.Reverse",
  "params": {}
}

Exemplos de declarações

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

ERROS do dispositivo

Consulte a lista completa de erros e exceções.
  • maxSpeedReached: o dispositivo já está definido para a velocidade máxima.
  • minSpeedReached: o dispositivo já está definido para a velocidade mínima.