Esquema de traço Smart Home FanSpeed

action.devices.traits.FanSpeed: essa característica pertence a dispositivos que permitem definir a 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 um aparelho de ar-condicionado ou 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 como processar intents SYNC, consulte Lógica de fulfillment de intents.

Atributos Tipo Descrição
reversible Booleano

Padrão: false.

Se definido como verdadeiro, o dispositivo vai ser compatível com o ventilador em ambas as direções e poderá aceitar o comando para inverter a direção.
commandOnlyFanSpeed Booleano

Padrão: false.

Indica se o dispositivo aceita comunicação unidirecional (true) ou bidirecional (false). Defina esse atributo como "true" se o dispositivo não puder responder a uma intent QUERY ou Report State 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çã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 em todos os idiomas.
speed_values Array

Obrigatório.

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

Sinônimo da configuração de velocidade em um determinado idioma. É necessário pelo menos um item com um valor lang de en para oferecer substituição de idioma.
speed_synonym Array

Obrigatório.

Sinônimos para a configuração de velocidade, incluindo as formas singular e 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. É necessário pelo menos um item com um valor lang de en para oferecer substituição de idioma.
lang String

Obrigatório.

Código de idioma (ISO 639-1). Confira os idiomas aceitos.
ordered Booleano

Obrigatório.

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

Suporte para porcentagem de velocidade.
supportsFanSpeedPercent Booleano

Obrigatório.

Padrão: false.

Se definido como verdadeiro, 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 para 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
}

ESTADOS DO DISPOSITIVO

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

Estados Tipo Descrição
currentFanSpeedSetting String

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

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 como processar intents EXECUTE, consulte Lógica de fulfillment de intents.

action.devices.commands.SetFanSpeed

Defina a velocidade.

Parâmetros

O payload contém uma das seguintes opções:

Definir a velocidade pelas configurações.

Parâmetros Tipo Descrição
fanSpeed String

Obrigatório.

As configurações de velocidade solicitadas do ventilador.

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

Defina a ventilação como 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 uma das seguintes opções:

Defina 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 a quantidade escalonada, enquanto o sinal numérico indica a direção da mudança.

Defina 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

Diminua um pouco a velocidade do ventilador.

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

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 på medel

ERROS do dispositivo

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