Esta é a Central do desenvolvedor do Google Home, a nova plataforma para aprender a desenvolver ações de casa inteligente. Observação: você continua criando ações no Console do Actions.
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Esquema de características do Smart Home FanSpeed

action.devices.traits.FanSpeed: essa característica pertence a dispositivos que permitem definir a velocidade de um ventilador.

As velocidades dos ventiladores, ou seja, ventilação do ar do dispositivo em vários níveis, que podem fazer parte de um ar-condicionado, unidade de aquecimento ou carro, podem incluir configurações como baixa, média e alta ou 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 fulfillment de intent.

Atributos Tipo Descrição
reversible Booleano

Padrão: false.

Se ela for definida como verdadeira, o dispositivo terá a capacidade de assombrar o ventilador nas duas direções e poderá 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 QUERY ou a um 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ção de velocidade.

speed_name String

Obrigatório.

Nome interno da configuração de velocidade. Essa página pode ser fácil de usar e será compartilhada em todos os idiomas.

speed_values Array

Obrigatório.

Sinônimos para a configuração de velocidade em cada idioma suportado.

[item, ...] Object

Sinônimo da configuração de velocidade em um determinado idioma.

speed_synonym Array

Obrigatório.

Sinônimos para a configuração de velocidade devem incluir formas no singular e plural, se aplicável. O primeiro sinônimo da lista será considerado como 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, a gramática adicional para lógica de aumento ou diminuição será aplicada, na ordem (aumento) da matriz de velocidades.

1 Object

Compatibilidade com a porcentagem de velocidade.

supportsFanSpeedPercent Booleano

Obrigatório.

Padrão: false.

Se ela for 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 porcentagem e direção inversa.

{
  "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 os estados a seguir como parte da operação QUERY. Para saber mais sobre como processar intents QUERY, consulte fulfillment de 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 por porcentagem. Obrigatório se o atributo supportsFanSpeedPercent estiver definido como true.

Exemplos

Qual é a velocidade dos fãs 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 fulfillment de intent.

action.devices.commands.SetFanSpeed

Definir a velocidade.

Parâmetros

O payload contém um dos seguintes itens:

Defina a velocidade por 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 de configuração de velocidade solicitada.

Exemplos

Defina o ventilador como alto.

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

Defina o ventilador em 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:

Definir 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 ajustado, 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 de velocidade a ser alterada.

Exemplos

Reduza a velocidade do ventilador.

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

Aumentar 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

Dispositivo ERRORS

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.