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