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 da alternância de casa inteligente

action.devices.traits.Toggles: essa característica pertence a qualquer dispositivo com configurações que só possam existir em um dos dois estados.

Essas configurações podem representar um botão físico com um estado ativado/desativado ou ativo/inativo, uma caixa de seleção em HTML ou qualquer outro tipo de elemento especificamente ativado/desativado. Se a configuração tiver mais de dois estados ou um estado em que nenhuma das opções binárias estiver selecionada, ela será representada melhor como uma característica de Modos, que equivale a mostradores de vários estados, botões de opção (físico ou HTML) ou estados binários que não são explicitamente ativados/desativados (por exemplo, "AM/FM" ou "hot/cold").

Essa característica abrange um ou mais botões de alternância individuais que os usuários podem definir. Em geral, esses botões precisam ser usados para uma funcionalidade desvinculada de outros comportamentos do dispositivo. O comportamento vinculado, como ativar ou desativar o próprio dispositivo, precisa usar características mais específicas, por exemplo, o thermostatMode na característica TemperatureSetting.

ATRIBUTOS DO DISPOSITIVO

Dispositivos com essa característica podem relatar 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
availableToggles Array

Obrigatório.

Lista de botões de alternância disponíveis.

[item, ...] Object

Botão de alternância disponível.

name String

Obrigatório.

Nome interno do botão de alternância, que será usado em comandos e estados. Essa página pode ser fácil de usar e será compartilhada em todos os idiomas.

name_values Array

Obrigatório.

São sinônimos do botão de alternância em cada idioma com suporte.

[item, ...] Object

Sinônimos do botão de alternância em um determinado idioma.

name_synonym Array

Obrigatório.

Sinônimos da alternância. A primeira string nessa lista é usada como o nome canônico do nível nesse idioma.

[item, ...] String

Nome de sinônimo.

lang String

Obrigatório.

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

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

queryOnlyToggles Booleano

Padrão: false.

Obrigatório se o dispositivo for compatível com a execução somente de consultas. Esse atributo indica se o dispositivo só pode ser consultado para informações de estado e não pode ser controlado.

Exemplos

Dispositivo com alternância de interruptor.

{
  "availableToggles": [
    {
      "name": "sterilization_toggle",
      "name_values": [
        {
          "name_synonym": [
            "clean",
            "bio clean"
          ],
          "lang": "en"
        }
      ]
    },
    {
      "name": "energysaving_toggle",
      "name_values": [
        {
          "name_synonym": [
            "energy saving",
            "eco"
          ],
          "lang": "en"
        }
      ]
    }
  ]
}

Dispositivo com botões de alternância.

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "filtered",
            "filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "commandOnlyToggles": true
}

Dispositivo com botões de alternância somente de consulta.

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "filtered",
            "filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "queryOnlyToggles": true
}

STATES do dispositivo

Dispositivos com essa característica podem informar 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
currentToggleSettings Object

Obrigatório.

Par de chave-valor com o botão de alternância name do dispositivo como a chave e o estado atual como o valor.

<string> Booleano

Estado de alternância atual.

Exemplos

A esterilização está ativada?

{
  "currentToggleSettings": {
    "sterilization_toggle": true,
    "energysaving_toggle": false
  }
}

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

Define um estado de alternância específico.

Parâmetros

Parâmetros Tipo Descrição
updateToggleSettings Object

Obrigatório.

Par de chave-valor com o botão de alternância name do dispositivo como chave e o novo estado como o valor.

<string> Booleano

Novo estado de alternância

Exemplos

Ative a economia de energia.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "energysaving_toggle": true
    }
  }
}

Desative o filtro.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "filter_toggle": false
    }
  }
}

Exemplos de declarações

de-DE

  • Schitt Bitte Power Cool am Kühlschrank aus
  • Stelle den Kühlschrank auf Power Cool

en-US

  • ativar congelamento para congelador
  • Cancelar liga/desliga elétrica a geladeira da cozinha

es-ES

  • Pel el enfriamiento rápido pt-BR la nonea
  • quita el enfriamiento rápido

fr-FR

  • atende ao modo liga/desliga sur le réfrigérateur
  • Éteins le mode congelamento de energia du réfrigérateur

Dispositivo ERRORS

Veja a lista completa de erros e exceções.