Esquema do Trait de FanSpeed da casa inteligente

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

As velocidades do ventilador, ou seja, soprar ar do dispositivo em vários níveis, que podem fazer parte de um ar-condicionado, de uma unidade de aquecimento ou de 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 gerenciamento de intents SYNC, consulte fulfillment de intents.

Atributos Tipo Descrição
reversible Booleano

Padrão: false.

Se definida como verdadeira, o dispositivo vai ter suporte para soprar o ventilador 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 oferece suporte ao uso de comunicação unidirecional (verdadeiro) ou bidirecional (falso). Defina esse atributo como verdadeiro se o dispositivo não puder responder a uma intent QUERY ou ao estado do relatório dessa característica.

Contém qualquer um dos seguintes itens:
0 Object

Suporte a 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. Ele não é fácil de usar e vai 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, ...] 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 precisam incluir as formas singular e plural, se for o caso. O primeiro sinônimo da 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). Veja os idiomas compatíveis.

ordered Booleano

Obrigatório.

Se definido como verdadeiro, 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 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 e suporte a ajustes de direção inversa e 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

Entidades com essa característica podem informar os seguintes estados como parte da operação QUERY. Para saber mais sobre o gerenciamento 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 da ventilação por 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 seguintes comandos como parte da operação EXECUTE. Para saber mais sobre o gerenciamento de intents EXECUTE, consulte fulfillment de intents.

action.devices.commands.SetFanSpeed

Definir velocidade.

Parâmetros

O payload contém um dos seguintes itens:

Definir a velocidade pelas configurações.

Parâmetros Tipo Descrição
fanSpeed String

Obrigatório.

Configurações de velocidade solicitadas do ventilador.

Define a velocidade por porcentagem.

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

Obrigatório.

Porcentagem solicitada de configuração de velocidade.

Exemplos

Defina o ventilador como alto.

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

Defina a ventilação como 50%.

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

action.devices.commands.SetFanSpeedRelative

Definir a velocidade relativa.

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

Parâmetros

O payload contém um dos seguintes itens:

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.

Define a velocidade relativa por porcentagem.

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

Obrigatório.

Esse valor representa a porcentagem da velocidade a ser alterada.

Exemplos

Reduza 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 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 medel

ERROS DO Dispositivo

Veja 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.