Esquema de la función de llenado de casa inteligente
action.devices.traits.Fill
: Esta característica se aplica a los dispositivos que permiten llenarlos, como una bañera.
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 el manejo de intents SYNC
, consulta Entrega de intents.
Atributos | Tipo | Descripción |
---|---|---|
availableFillLevels |
Objeto |
Describe diferentes niveles de llenado del dispositivo. |
levels |
Matriz |
Obligatorio. Lista de nombres de niveles y sinónimos específicos de idiomas. |
[item, ...] |
Objeto |
Nombre del nivel y sus sinónimos específicos para cada idioma. |
level_name |
String |
Obligatorio. Es el nombre interno del nivel. Esto puede ser poco fácil de usar y se compartirá en todos los idiomas. |
level_values |
Matriz |
Obligatorio. Sinónimos del nivel en cada idioma admitido. |
[item, ...] |
Objeto |
Sinónimos del nivel en un idioma determinado. |
level_synonym |
Matriz |
Obligatorio. Sinónimo del nivel. 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). Consulta los idiomas compatibles. |
ordered |
Booleano |
Obligatorio. Si es verdadero, el dispositivo controla la gramática adicional para aumentar o disminuir la lógica, como se representa con el array |
supportsFillPercent |
Booleano |
(Predeterminado: Si es verdadero, acepta comandos para ajustar el nivel a un porcentaje. |
Ejemplos
Dispositivo con capacidades básicas de llenado o vaciado que no admite niveles de relleno discretos.
{}
Dispositivo que admite niveles de relleno discretos.
{ "availableFillLevels": { "levels": [ { "level_name": "half_level", "level_values": [ { "level_synonym": [ "Half", "Half way", "One half" ], "lang": "en" } ] }, { "level_name": "full_level", "level_values": [ { "level_synonym": [ "Full", "All the way", "Complete" ], "lang": "en" } ] } ], "ordered": 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 el manejo de intents QUERY
, consulta Entrega de intents.
Estados | Tipo | Descripción |
---|---|---|
isFilled |
Booleano |
Obligatorio. Verdadero si el dispositivo está lleno en algún nivel. Falso si el dispositivo se vacía por completo. |
currentFillLevel |
String |
Es obligatorio si se configura el atributo |
currentFillPercent |
Número |
Es obligatorio si se configura el atributo |
Ejemplos
¿La bañera está llena?
{ "isFilled": true }
¿La bañera está llena? (con niveles).
{ "isFilled": true, "currentFillLevel": "half_level" }
Dispositivo COMMANDS
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 el manejo de intents EXECUTE
, consulta Entrega de intents.
action.devices.commands.Fill
Llena o desvía el dispositivo.
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
fill |
Booleano |
Obligatorio. Verdadero para rellenar y falso para drenar. |
fillLevel |
String |
Indica el |
fillPercent |
Número |
Indica el porcentaje de nivel solicitado. |
Ejemplos
Llene la bañera.
{ "command": "action.devices.commands.Fill", "params": { "fill": true } }
Vacíe la bañera.
{ "command": "action.devices.commands.Fill", "params": { "fill": false } }
Llene la bañera hasta la mitad.
{ "command": "action.devices.commands.Fill", "params": { "fill": true, "fillLevel": "half_level" } }
Aumente el nivel de relleno de la bañera en uno (requera que el atributo ordered
sea true
).
{ "command": "action.devices.commands.Fill", "params": { "fill": true, "fillLevel": "full_level" } }