Esquema de rasgo de los modos de casa inteligente
action.devices.traits.Modes: Esta característica abarca todos los modos disponibles y la configuración específica del modo de un dispositivo.
Esta característica pertenece a cualquier dispositivo con una cantidad arbitraria de modos "n-way", en los que los modos y la configuración de cada modo son arbitrarios y únicos para cada dispositivo o tipo de dispositivo. Cada modo tiene varias configuraciones posibles, pero solo se puede seleccionar una a la vez. Una secadora no puede estar en modo "delicado", "normal" y "de trabajo pesado" al mismo tiempo. Una configuración que solo se puede activar o desactivar pertenece a la característica Toggles.
Por ejemplo, una lavadora puede configurar el tamaño de la carga y la temperatura. Ambos serían modos porque son independientes entre sí, pero cada uno puede estar en un solo estado a la vez. El usuario puede configurar de forma explícita un modo, como la temperatura, con un comando como Establece la temperatura de la lavadora en frío.
Algunos modos están "ordenados" y también se pueden ajustar con el lenguaje hacia arriba, hacia abajo y hacia arriba o hacia abajo. Por ejemplo, el tamaño de la carga (pequeña, media y grande) y la temperatura están ordenados de manera clara (ten en cuenta que la temperatura no es un termostato real con un objetivo numérico, como en otros dispositivos), pero es posible que el tipo de carga (delicados, normal, de lana, etc.).
Esta característica cubre uno o más modos individuales que los usuarios pueden configurar. En general, estos modos deberían usarse para una funcionalidad que no está vinculada a otro comportamiento del dispositivo. El comportamiento vinculado, como encender o apagar el dispositivo, debe usar rasgos más específicos (por ejemplo, el thermostatMode en la trait 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 |
|---|---|---|
availableModes |
Matriz |
Obligatorio. Lista de modos disponibles. |
[item, ...] |
Objeto |
Modo disponible. |
name |
Cadena |
Obligatorio. Nombre interno del modo, 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 modo en cada idioma compatible. |
[item, ...] |
Objeto |
Sinónimos del modo en un idioma determinado. |
name_synonym |
Matriz |
Obligatorio. Sinónimos del modo. 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. |
settings |
Matriz |
Obligatorio. Parámetros de configuración compatibles para este modo. |
[item, ...] |
Objeto |
Es un parámetro de configuración compatible. Requiere al menos 2 elementos. |
setting_name |
Cadena |
Obligatorio. Nombre interno de la configuración del modo, que se usará en los comandos y estados. Es posible que no sea fácil de usar y se compartirá en todos los idiomas. |
setting_values |
Matriz |
Obligatorio. Sinónimos de la configuración en cada idioma compatible. |
[item, ...] |
Objeto |
Sinónimos de la configuración en un idioma determinado. |
setting_synonym |
Matriz |
Obligatorio. Sinónimos del parámetro. 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. |
ordered |
Booleano |
(Predeterminado: Si esto se establece como verdadera, se aplicará la gramática adicional para la lógica de aumento o disminución, en el orden (en aumento) del array de configuración. |
commandOnlyModes |
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. |
queryOnlyModes |
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 varios modos y opciones de configuración.
{
"availableModes": [
{
"name": "load_mode",
"name_values": [
{
"name_synonym": [
"Load",
"Size",
"Load size"
],
"lang": "en"
}
],
"settings": [
{
"setting_name": "small_load",
"setting_values": [
{
"setting_synonym": [
"Small",
"Half"
],
"lang": "en"
}
]
},
{
"setting_name": "medium_load",
"setting_values": [
{
"setting_synonym": [
"Medium",
"Normal"
],
"lang": "en"
}
]
},
{
"setting_name": "large_load",
"setting_values": [
{
"setting_synonym": [
"Large",
"Full"
],
"lang": "en"
}
]
}
],
"ordered": true
},
{
"name": "temp_mode",
"name_values": [
{
"name_synonym": [
"Temperature",
"Temp"
],
"lang": "en"
}
],
"settings": [
{
"setting_name": "hot_temp",
"setting_values": [
{
"setting_synonym": [
"Hot",
"White"
],
"lang": "en"
}
]
},
{
"setting_name": "warm_temp",
"setting_values": [
{
"setting_synonym": [
"Warm",
"Color"
],
"lang": "en"
}
]
},
{
"setting_name": "cold_temp",
"setting_values": [
{
"setting_synonym": [
"Cold",
"Delicate"
],
"lang": "en"
}
]
}
],
"ordered": false
}
]
}
Dispositivo con modos de solo comandos.
{
"availableModes": [
{
"name": "light_mode",
"name_values": [
{
"name_synonym": [
"Light",
"Lighting"
],
"lang": "en"
}
],
"settings": [
{
"setting_name": "day_light",
"setting_values": [
{
"setting_synonym": [
"Day",
"Bright"
],
"lang": "en"
}
]
},
{
"setting_name": "night_light",
"setting_values": [
{
"setting_synonym": [
"Night",
"Dark"
],
"lang": "en"
}
]
},
{
"setting_name": "reading_light",
"setting_values": [
{
"setting_synonym": [
"Reading",
"Ambiant"
],
"lang": "en"
}
]
}
],
"ordered": false
}
],
"commandOnlyModes": true,
"queryOnlyModes": false
}
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 |
|---|---|---|
currentModeSettings |
Objeto |
Obligatorio. Es el par clave-valor con el modo |
<string> |
Cadena |
|
Ejemplos
¿En qué modo está el dispositivo?
{
"currentModeSettings": {
"load_mode": "small_load",
"temp_mode": "cold_temp"
}
}
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.SetModes
Actualizar configuración del modo
Parámetros
| Parámetros | Tipo | Descripción |
|---|---|---|
updateModeSettings |
Objeto |
Obligatorio. Es el par clave-valor con el modo |
<string> |
Cadena |
Nuevo |
Ejemplos
Establece una carga grande.
{
"command": "action.devices.commands.SetModes",
"params": {
"updateModeSettings": {
"load_mode": "large_load"
}
}
}
Expresiones de muestra
de-DE
- Stelle den Staubsauger auf Ruhemodus
en-US
- set the vacuum to energy saver mode
es-ES
- pon la lavadora en modo frío
fr-FR
- mets l'aspirateur en silencieux
hi-IN
- वैक्यूम पर कार्पेट मोड लगाएं
it-IT
- imposta l'aspirapolvere su silenzioso
ja-JP
- 掃除機 を 静音 モードに設定して
ko-KR
- 세탁기 세탁량 많음 으로 설정해
pt-BR
- acionar a função autolimpeza do aspirador
- ligar o modo de aquecimento