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: 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: 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 |
<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 |
<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 aufPower Cool
en-US
-
activate
power freeze forthe freezer -
cancel
power cool forthe kitchen fridge
es-ES
-
pon el
enfriamiento rápido enla nevera -
quita el
enfriamiento rápido
fr-FR
-
mets le mode
power cool surle réfrigérateur -
Éteins le mode
power freeze duré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 opde koelkast -
zet
de koelkast opsuperkoelen
pt-BR
-
Ativa a função
power freeze nocongelador . -
Desativa o
bloqueio infantil doforno . -
desligar o
power cool dageladeira -
iniciar o modo
power freeze dofreezer
sv-SE
-
Stäng av
power cool ikylskåpet -
sätt på
power freeze påfrysen