Esquema de traços de alternância de casa inteligente

action.devices.traits.Toggles: essa característica pertence a qualquer dispositivo 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, 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 tiver um estado em que nenhuma das opções binárias seja selecionada, ela será melhor representada como uma características Modes, o que equivale a discadores 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 uma ou mais alternâncias individuais que os usuários podem definir. Em geral, essas alternâncias precisam ser usadas para funcionalidades desvinculadas de outro comportamento do dispositivo. O comportamento vinculado, como ligar ou desligar o próprio dispositivo, precisa usar características mais específicas, como 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 o gerenciamento de intents SYNC, consulte fulfillment de intents.

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. Ele não é fácil de usar e vai ser compartilhado em todos os idiomas.
name_values	Array	Obrigatório. 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 do botão de alternância. A primeira string nessa lista é usada como o nome canônico do nível no idioma em questão.
[item, ...]	String	Nome do sinônimo.
lang	String	Obrigatório. Código do idioma (ISO 639-1). Veja os idiomas compatíveis.
commandOnlyToggles	Booleano	Padrão: false. Indica se o dispositivo oferece suporte ao 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 ao estado do relatório dessa característica.
queryOnlyToggles	Booleano	Padrão: false. Obrigatório se o dispositivo permitir a execução somente de consulta. Esse atributo indica se o dispositivo só pode ser consultado em busca de informações de estado e não pode ser controlado.

Exemplos

Dispositivo com vários botões de alternância.

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

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

Dispositivo com botões 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 informar os seguintes estados como parte da operação QUERY. Para saber mais sobre o gerenciamento de intents QUERY, consulte fulfillment de intents.

Estados	Tipo	Descrição
currentToggleSettings	Object	Obrigatório. Par de chave-valor com o botão de alternância name do dispositivo como 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 o gerenciamento de intents EXECUTE, consulte fulfillment de intents.

action.devices.commands.SetToggles

Define um determinado estado de alternância.

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

Ativar 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

ERROS DO Dispositivo

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