Esquema de traço de alternâncias de casa inteligente

action.devices.traits.Toggles: pertence a dispositivos com configurações que só podem existir em um de 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 esteja selecionada, ela será melhor representada como um traço Modes, que equivale a controles de vários estados, botões de opção (físicos ou HTML) ou estados binários que não estão explicitamente ativados/desativados (por exemplo, "AM/FM" ou "quente/frio").

Essa característica abrange uma ou mais opções individuais que os usuários podem definir. Em geral, essas opções devem ser usadas para funcionalidades que não estão vinculadas a outros comportamentos do dispositivo. Comportamentos vinculados, como ligar ou desligar o dispositivo, devem usar características mais específicas (por exemplo, thermostatMode na característica TemperatureSetting).

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.

Exemplos

Dispositivo com várias opções de ativação/desativação.

{
  "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 alternâncias somente de comando.

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

Dispositivo com alternâncias somente de consulta.

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Filtered",
            "Filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "queryOnlyToggles": 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.

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 Lógica de fulfillment de intents.

action.devices.commands.SetToggles

Define um determinado estado de alternância.

Parâmetros

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

ERROS do dispositivo