A casa inteligente alterna o esquema de traços

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 botão uma caixa de seleção em HTML ou qualquer outro tipo de especificamente ativado/desativado . Se a configuração tiver mais de dois estados ou um estado em que nenhuma das opções binárias for selecionada, ele será melhor representado como uma a característica Modes, que equivale a mostradores de vários estados; botões de opção (físicos ou HTML) ou estados binários que não são explicitamente ligado/desligado (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 devem ser usadas para funcionalidades não vinculadas de outro comportamento do dispositivo. Comportamento vinculado, como girar o próprio dispositivo ativada ou desativada, precisa usar características mais específicas (por exemplo, thermostatMode na característica TemperatureSetting).

ATRIBUTOS DO dispositivo

Dispositivos com essa característica podem relatar o seguinte atributos como parte da operação SYNC. Para saber mais sobre como lidar com intents SYNC, consulte Fulfillment da intent.

Atributos	Tipo	Descrição
availableToggles	Array	Obrigatório. Lista de alternâncias disponíveis.
[item, ...]	Object	Botão disponível.
name	String	Obrigatório. Nome interno do botão de alternância, que será usado em comandos e estados. Isso pode não ser fácil de usar e será compartilhado entre todos os idiomas.
name_values	Array	Obrigatório. Sinônimos do botão de alternância em cada idioma disponível.
[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). 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 de CONSULTA ou ao estado do 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 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 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 relatar o seguinte como parte da operação QUERY. Para saber mais sobre como lidar com intents QUERY, consulte Fulfillment da intent.

Estados	Tipo	Descrição
currentToggleSettings	Object	Obrigatório. Par de chave-valor com o botão 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 ao seguinte como parte da operação EXECUTE. Para saber mais sobre como lidar com intents EXECUTE, consulte Fulfillment da intent.

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 name do dispositivo como a 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

ERROS no dispositivo

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