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

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

• Bitte schalte Power Cool am Kühlschrank aus
• stelle den Kühlschrank auf Power Cool

en-US

• activate power freeze for the freezer
• cancel power cool for the kitchen fridge

es-ES

• pon el enfriamiento rápido en la nevera
• quita el enfriamiento rápido

fr-FR

• mets le mode power cool sur le réfrigérateur
• Éteins le mode power freeze du réfrigérateur .

hi-IN

• रेफ़्रिजरेटर का पावर कूल मोड बंद कर दो
• रेफ़्रिजरेटर में पावर कूल मोड चालू करो

it-IT

• disattiva il power freeze del freezer
• imposta la funzione power freeze del surgelatore

ja-JP

• 冷蔵庫 の 急速冷凍 つけて
• 冷蔵庫 の 急速冷凍 を切ってくれる

ko-KR

• 냉장고 급속 냉장 해제해
• 냉장고 모드 급속 냉장 으로 바꿔

nl-NL

• Zet de power cool uit op de koelkast
• zet de koelkast op superkoelen

pt-BR

• Ativa a função power freeze no congelador .
• Desativa o bloqueio infantil do forno .
• desligar o power cool da geladeira
• iniciar o modo power freeze do freezer

sv-SE

• Stäng av power cool i kylskåpet
• sätt på power freeze på frysen

Dispositivo ERRORS

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