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 de modos para un dispositivo.
Esta característica pertenece a cualquier dispositivo con un número arbitrario de "n-way" modos en los que el los modos y las configuraciones 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 "delicado", "normal", y "trabajo pesado" al mismo tiempo. Un parámetro de configuración que simplemente se puede activar o desactivar pertenece al trait Toggles.
Por ejemplo, una lavadora puede tener la configuración del tamaño de carga y la temperatura. Ambos serían modos porque son independientes entre sí, pero puede estar en un solo estado a la vez. El usuario puede configurar un modo como de manera explícita con un comando como Set the washer’sTemperature to frío.
Algunos modos están "ordenados" y se puede ajustar con las flechas hacia arriba y abajo, aumentar/disminuir el texto. Por ejemplo, el tamaño de carga (pequeño, mediano, grande) y de temperatura estén claramente ordenados (ten en cuenta que la temperatura no es un valor termostato con objetivo numérico, como en otros dispositivos), pero el tipo de carga (delicadas, normales, de lana, etc.).
Esta característica abarca uno o más modos individuales que los usuarios pueden configurar. En general,
estos modos deben usarse para la funcionalidad que no está vinculada a otro dispositivo
el comportamiento de los usuarios. El comportamiento vinculado, como el encendido o apagado del dispositivo, debe
usar características más específicas (por ejemplo, thermostatMode en el
trait TemperatureSetting).
ATRIBUTOS DISPOSITIVOS
Los dispositivos con este trait pueden informar lo siguiente
atributos como parte de la operación SYNC. Para aprender
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 |
String |
Obligatorio. Nombre interno del modo, que se usará en comandos y estados. Esta opción no es fácil de usar y se compartirá en todos los idiomas. |
name_values |
Matriz |
Obligatorio. Sinónimos del modo en cada idioma admitido. |
[item, ...] |
Objeto |
Sinónimos del modo en un idioma determinado. |
name_synonym |
Matriz |
Obligatorio. Sinónimos del modo. La primera cadena de esta lista se usa como nombre canónico del nivel en ese idioma. |
[item, ...] |
String |
Nombre del sinónimo. |
lang |
String |
Obligatorio. Código de idioma (ISO 639-1). Consulta los idiomas compatibles. |
settings |
Matriz |
Obligatorio. Parámetros de configuración compatibles con este modo. |
[item, ...] |
Objeto |
Parámetro de configuración compatible. Requiere al menos 2 elementos. |
setting_name |
String |
Obligatorio. Nombre interno de la configuración del modo, que se usará en comandos y estados. Esta opción no es fácil de usar y se compartirá en todos los idiomas. |
setting_values |
Matriz |
Obligatorio. Sinónimos del parámetro de configuración en cada idioma admitido. |
[item, ...] |
Objeto |
Sinónimos del entorno en un idioma determinado. |
setting_synonym |
Matriz |
Obligatorio. Sinónimos del entorno. La primera cadena de esta lista se usa como nombre canónico del nivel en ese idioma. |
[item, ...] |
String |
Nombre del sinónimo. |
lang |
String |
Obligatorio. Código de idioma (ISO 639-1). Consulta los idiomas compatibles. |
ordered |
Booleano |
(Predeterminado: Si se establece como verdadera, se aplicará la gramática adicional para la lógica de aumento o disminución, en el orden (aumento) de la matriz 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 CONSULTA o a un informe de estado de esta característica. |
queryOnlyModes |
Booleano |
(Predeterminado: Obligatorio si el dispositivo admite la ejecución de solo consulta. Este atributo indica si solo se puede consultar al dispositivo para obtener información de estado y no se puede controlar. |
Ejemplos
Dispositivo con varios modos y parámetros 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 lo siguiente
estados como parte de la operación QUERY. Para aprender
Para obtener más información sobre cómo controlar los intents QUERY, consulta
Entrega de intents.
| Estados | Tipo | Descripción |
|---|---|---|
currentModeSettings |
Objeto |
Obligatorio. Par clave-valor con el modo |
<string> |
String |
|
Ejemplos
¿En qué modo está el dispositivo?
{
"currentModeSettings": {
"load_mode": "small_load",
"temp_mode": "cold_temp"
}
}
COMANDOS del dispositivo
Los dispositivos con este rasgo pueden responder a lo siguiente
comandos como parte de la operación EXECUTE. Para aprender
Para obtener más información sobre cómo controlar los intents EXECUTE, consulta
Entrega de intents.
action.devices.commands.SetModes
Actualiza la configuración del modo.
Parámetros
| Parámetros | Tipo | Descripción |
|---|---|---|
updateModeSettings |
Objeto |
Obligatorio. Par clave-valor con el modo |
<string> |
String |
Nuevo |
Ejemplos
Configura en 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