Esquema do traço da velocidade do ventilador de casa inteligente

action.devices.traits.FanSpeed: essa característica pertence a dispositivos compatíveis com a configuração da velocidade de um ventilador.

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

ATRIBUTOS DO dispositivo

Dispositivos com essa característica podem relatar o seguinte atributos como parte da operação SYNC. Para saber mais sobre como lidar com intents SYNC, consulte Fulfillment da intent.

Atributos Tipo Descrição
reversible Booleano

Padrão: false.

Se a política for definida como verdadeira, o dispositivo vai oferecer suporte ao vento em ambas as direções e aceitar o comando para inverter a direção do ventilador.
commandOnlyFanSpeed Booleano

Padrão: false.

Indica se o dispositivo suporta o uso de comunicação unidirecional (verdadeiro) ou bidirecional (falso). Defina esse atributo como verdadeiro se o dispositivo não puder responder a uma intent de CONSULTA ou ao estado do relatório para essa característica.
Contém qualquer um dos seguintes itens:
0 Object

Compatibilidade com configurações de velocidade.
availableFanSpeeds Object

Obrigatório.

Configurações de velocidade compatíveis com o dispositivo.
speeds Array

Obrigatório.

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

Configuração de velocidade.
speed_name String

Obrigatório.

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

Obrigatório.

Sinônimos da configuração de velocidade em cada idioma compatível.
[item, ...] Object

Sinônimo para a configuração de velocidade em um determinado idioma.
speed_synonym Array

Obrigatório.

Os sinônimos para a configuração de velocidade devem incluir as formas no singular e no plural, se aplicável. O primeiro sinônimo na lista será considerado o nome canônico da configuração de velocidade.
[item, ...] String

Sinônimo.
lang String

Obrigatório.

Código do idioma (ISO 639-1). Consulte os idiomas compatíveis.
ordered Booleano

Obrigatório.

Se definida como verdadeira, será aplicada uma gramática adicional para a lógica de aumento ou diminuição na ordem (de crescimento) da matriz de velocidades.
1 Object

Suporte à porcentagem de velocidade.
supportsFanSpeedPercent Booleano

Obrigatório.

Padrão: false.

Se definida como verdadeira, o dispositivo aceitará comandos para ajustar a velocidade usando uma porcentagem de 0,0 a 100,0.

Exemplos

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

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

STATES do dispositivo

Entidades com essa característica podem relatar o seguinte como parte da operação QUERY. Para saber mais sobre como lidar com intents QUERY, consulte Fulfillment da intent.

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 em porcentagem. Obrigatório se o atributo supportsFanSpeedPercent estiver definido como true

Exemplos

Qual é a velocidade dos ventiladores na sala de estar?

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

COMANDOS DO dispositivo

Dispositivos com essa característica podem responder ao seguinte como parte da operação EXECUTE. Para saber mais sobre como lidar com intents EXECUTE, consulte Fulfillment da intent.

action.devices.commands.SetFanSpeed

Definir velocidade.

Parâmetros

O payload contém um dos seguintes itens:

Defina a velocidade nas configurações.

Parâmetros Tipo Descrição
fanSpeed String

Obrigatório.

As configurações de velocidade solicitadas do ventilador.

Definir a velocidade por porcentagem.

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

Obrigatório.

A porcentagem da configuração de velocidade solicitada.

Exemplos

Defina a ventilação como alta.

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

Ajuste a ventilação para 50%.

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

action.devices.commands.SetFanSpeedRelative

Defina a velocidade relativa.

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

Parâmetros

O payload contém um dos seguintes itens:

Defina a velocidade relativa por peso.

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

Obrigatório.

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

Definir a velocidade relativa em porcentagem.

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

Obrigatório.

Esse valor representa a porcentagem de velocidade da mudança.

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

Inverta a direção do ventilador.

Esse comando requer 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 no dispositivo

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