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 frysen

ERROS DO Dispositivo

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