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.

As velocidades do ventilador (ou seja, a quantidade de ar que sai do dispositivo em vários níveis, que podem fazer parte de uma unidade de ar-condicionado ou de 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 informar os seguintes atributos como parte da operação SYNC. Para saber mais sobre o processamento de intents SYNC, consulte Fulfillment de intents.

Atributos Tipo Descrição
reversible Booleano

Padrão: false.

Se definido como "true", o dispositivo oferece suporte ao ventilador em ambas as direções e pode aceitar o comando para reverter a direção do ventilador.
commandOnlyFanSpeed Booleano

Padrão: false.

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

Suporte para 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ções de velocidade.
speed_name String

Obrigatório.

Nome interno da configuração de velocidade. Isso pode ser difí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 compatível.
[item, ...] Object

Sinônimo da 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 de idioma (ISO 639-1). Consulte os idiomas aceitos.
ordered Booleano

Obrigatório.

Se definido como "true", a gramática adicional para a lógica de aumento ou diminuição será aplicada na ordem (crescente) da matriz de velocidades.
1 Object

Suporte à porcentagem de velocidade.
supportsFanSpeedPercent Booleano

Obrigatório.

Padrão: false.

Se definido como "true", o 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 à direção reversa 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
}

STATES do dispositivo

As entidades com essa característica podem informar os seguintes estados como parte da operação QUERY. Para saber mais sobre o processamento de intents QUERY, consulte Fulfillment 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 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 aos comandos abaixo como parte da operação EXECUTE. Para saber mais sobre o processamento de intents EXECUTE, consulte Fulfillment de intents.

action.devices.commands.SetFanSpeed

Definir a velocidade.

Parâmetros

O payload contém um dos seguintes:

Definir a velocidade pelas 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

Definir a velocidade relativa.

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

Parâmetros

O payload contém um dos seguintes:

Definir a 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 o valor dimensionado, enquanto o sinal numérico indica a direção da mudança.

Definir a velocidade relativa por 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 da ventilação.

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

Aumente a velocidade da ventilação em 10%.

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

action.devices.commands.Reverse

Inverta a direção do ventilador.

Este 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

Confira a lista completa de 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.