Esquema de atributo de alternância da casa inteligente

action.devices.traits.Toggles: essa característica pertence a todos os dispositivos com configurações que só podem 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á melhor representada como um atributo Modes, que equivale a marcadores de vários estados, botões de opção (físicos ou HTML) ou estados binários que não são explicitamente ativados/desativados (por exemplo, "AM/FM" ou "quente/frio").

Essa característica abrange um ou mais alternâncias individuais que os usuários podem definir. Em geral, esses botões precisam ser usados para funcionalidades que não estão vinculadas a outros comportamentos do dispositivo. O comportamento vinculado, como ligar ou desligar o dispositivo, precisa usar características mais específicas (por exemplo, thermostatMode no atributo TemperatureSetting).

ATRIBUTOS do dispositivo

Dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC. Para saber mais sobre o processamento de intents SYNC, consulte Fulfillment de intents.

Exemplos

Dispositivo com vários botões de ativaçã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 o processamento de intents QUERY, consulte 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 comandos abaixo como parte da operação EXECUTE. Para saber mais sobre o processamento de intents EXECUTE, consulte 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
    }
  }
}

Desativar o filtro.

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

Exemplos de declarações

ERROS do dispositivo