Esquema de activación de Smart Home
action.devices.traits.Toggles
: Esta característica pertenece a cualquier dispositivo con una configuración que solo pueda existir en uno de dos estados.
Esta configuración puede representar un botón físico con un estado activado/desactivado, activo/inactivo, una casilla de verificación en HTML o cualquier otro tipo de elemento habilitado o inhabilitado específicamente. Si la configuración tiene más de dos estados, o tiene un estado en el que ninguna de las opciones binarias está seleccionada, se representa mejor como una característica de modos, que equivale a diales de varios estados, botones de selección (físicos o HTML) o estados binarios que no están activados o desactivados de forma explícita (por ejemplo, "AM/FM" o "hot/fd").
Esta característica cubre uno o más botones de activación individuales que los usuarios pueden configurar. En general, estos botones de activación se deben usar para la funcionalidad que está desvinculada de otros comportamientos del dispositivo. El comportamiento vinculado, como la activación o desactivación del dispositivo, debería usar rasgos más específicos (por ejemplo, el thermostatMode
en la característica TemperatureSetting).
ATRIBUTOS DEL Dispositivo
Los dispositivos con esta característica pueden informar los siguientes atributos como parte de la operación SYNC
. Para obtener más información sobre cómo manejar los intents SYNC
, consulta Entrega de intents.
Atributos | Tipo | Descripción |
---|---|---|
availableToggles |
Matriz |
Obligatorio. Lista de botones de activación disponibles. |
[item, ...] |
Objeto |
Botón de activación disponible. |
name |
String |
Obligatorio. Nombre interno del botón de activación, que se usará en comandos y estados. Esto puede no ser fácil de usar y se compartirá en todos los idiomas. |
name_values |
Matriz |
Obligatorio. Sinónimos del botón de activación en cada idioma compatible. |
[item, ...] |
Objeto |
Sinónimos del botón de activación en un idioma determinado. |
name_synonym |
Matriz |
Obligatorio. Sinónimos del botón de activación. La primera string de esta lista se usa como el nombre canónico del nivel en ese idioma. |
[item, ...] |
String |
Nombre del sinónimo. |
lang |
String |
Obligatorio. Código de idioma (ISO 639-1). Consulte los idiomas compatibles. |
commandOnlyToggles |
Booleano |
(Predeterminado: Indica si el dispositivo admite el uso de comunicación unidireccional (verdadero) o bidireccional (falso). Establece este atributo como verdadero si el dispositivo no puede responder a un intent QUERY o al estado del informe para esta característica. |
queryOnlyToggles |
Booleano |
(Predeterminado: Obligatorio si el dispositivo solo admite la ejecución de consultas. Este atributo indica si el dispositivo solo se puede consultar para obtener información de estado y no se puede controlar. |
Ejemplos
Dispositivo con botón de activación múltiple.
{ "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 con botones de activación de solo comando.
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "Filtered", "Filter" ], "lang": "en" } ] } ], "commandOnlyToggles": true }
Dispositivo con botones de activación de solo consulta.
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "Filtered", "Filter" ], "lang": "en" } ] } ], "queryOnlyToggles": true }
Dispositivo STATEs
Las entidades con esta característica pueden informar los siguientes estados como parte de la operación QUERY
. Para obtener más información sobre cómo manejar los intents QUERY
, consulta Entrega de intents.
Estados | Tipo | Descripción |
---|---|---|
currentToggleSettings |
Objeto |
Obligatorio. Es el par clave-valor con el botón de activación |
<string> |
Booleano |
Estado de activación o desactivación actual. |
Ejemplos
¿La esterilización está activada?
{ "currentToggleSettings": { "sterilization_toggle": true, "energysaving_toggle": false } }
Dispositivo COMMAND
Los dispositivos con esta característica pueden responder a los siguientes comandos como parte de la operación EXECUTE
. Para obtener más información sobre cómo manejar los intents EXECUTE
, consulta Entrega de intents.
action.devices.commands.SetToggles
Establece un estado de activación determinado.
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
updateToggleSettings |
Objeto |
Obligatorio. Es el par clave-valor con el botón de activación |
<string> |
Booleano |
Nuevo estado de activación |
Ejemplos
Activa el ahorro de energía.
{ "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "energysaving_toggle": true } } }
Desactiva el filtro.
{ "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "filter_toggle": false } } }
Expresiones de muestra
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