La casa inteligente activa o desactiva el esquema de trait
action.devices.traits.Toggles
: Esta característica pertenece a cualquier dispositivo con configuración que solo puede existir en uno de dos estados.
Esta configuración puede representar un botón físico con estado activado/desactivado o 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 no se seleccionó ninguna de las opciones binarias, se representa mejor como una característica Modes, que equivale a marcas 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 "Caliente/Frío").
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 deben usarse para funcionalidades que no están vinculadas a otros comportamientos del dispositivo. El comportamiento vinculado, como encender o apagar el dispositivo, debe usar rasgos más específicos (por ejemplo, thermostatMode
en la característica TemperatureSetting).
Dispositivo ATTRIBUTES
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 controlar 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 |
Cadena |
Obligatorio. Nombre interno del botón de activación, que se usará en comandos y estados Es posible que no sea 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 la lista se usa como nombre canónico del nivel en ese idioma. |
[item, ...] |
Cadena |
Es el nombre sinónimo. |
lang |
Cadena |
Obligatorio. Es el código de idioma (ISO 639-1). Consulta 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 de QUERY o a un estado de informe de esta característica. |
queryOnlyToggles |
Booleano |
(Predeterminado: Es obligatorio si el dispositivo admite la ejecución de solo consulta. Este atributo indica si el dispositivo solo se puede consultar y si no se puede controlar. |
Ejemplos
Dispositivo con 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 solo de comandos.
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "Filtered", "Filter" ], "lang": "en" } ] } ], "commandOnlyToggles": true }
Dispositivo con botones de activación solo para consultas
{ "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 controlar 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 actual del botón de activación. |
Ejemplos
¿Está activada la esterilización?
{ "currentToggleSettings": { "sterilization_toggle": true, "energysaving_toggle": false } }
COMANDOS del dispositivo
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 controlar 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
Activar 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 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