Esquema de características de preenchimento inteligente de casas inteligentes
action.devices.traits.Fill
: essa característica se aplica a dispositivos que podem ser abastecidos, como banheiras.
ATRIBUTOS DO DISPOSITIVO
Dispositivos com essa característica podem informar os seguintes
atributos como parte da operação SYNC
. Para saber
mais sobre como processar intents SYNC
, consulte
fulfillment de intent.
Atributos | Tipo | Descrição |
---|---|---|
availableFillLevels |
Object |
Descreve diferentes níveis de preenchimento do dispositivo. |
levels |
Array |
Obrigatório. Lista de nomes de níveis e sinônimos específicos de idiomas. |
[item, ...] |
Object |
Nome do nível e sinônimos específicos do idioma |
level_name |
String |
Obrigatório. Nome interno do nível. Essa página pode ser fácil de usar e será compartilhada em todos os idiomas. |
level_values |
Array |
Obrigatório. Sinônimos do nível em cada idioma aceito. |
[item, ...] |
Object |
Sinônimos do nível em um determinado idioma. |
level_synonym |
Array |
Obrigatório. Sinônimo do nível. A primeira string nessa lista é usada como o nome canônico do nível nesse idioma. |
[item, ...] |
String |
Nome de sinônimo. |
lang |
String |
Obrigatório. Código do idioma (ISO 639-1). Consulte os idiomas compatíveis. |
ordered |
Booleano |
Obrigatório. Se for verdadeiro, o dispositivo vai processar outras gramáticas para aumentar ou diminuir a lógica, como representado pela matriz |
supportsFillPercent |
Booleano |
Padrão: Se verdadeiro, aceita comandos para ajustar o nível para uma porcentagem. |
Exemplos
Dispositivo com recursos básicos de preenchimento ou esvaziamento que não oferece suporte a níveis discretos de preenchimento
{}
Dispositivo compatível com níveis discretos de preenchimento.
{ "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 } }
STATES do dispositivo
Entidades com essa característica podem relatar os estados
a seguir como parte da operação QUERY
. Para saber
mais sobre como processar intents QUERY
, consulte
fulfillment de intent.
Estados | Tipo | Descrição |
---|---|---|
isFilled |
Booleano |
Obrigatório. Verdadeiro se o dispositivo estiver preenchido em qualquer nível. Falso se o dispositivo estiver totalmente drenado. |
currentFillLevel |
String |
Obrigatório se o atributo |
currentFillPercent |
Número |
Obrigatório se o atributo |
Exemplos
A banheira está cheia?
{ "isFilled": true }
A banheira está cheia? (com níveis).
{ "isFilled": true, "currentFillLevel": "half_level" }
Comandos do dispositivo
Dispositivos com essa característica podem responder aos seguintes
comandos como parte da operação EXECUTE
. Para saber
mais sobre como processar intents EXECUTE
, consulte
fulfillment de intent.
action.devices.commands.Fill
Preencha ou esvazie o dispositivo.
Parâmetros
Parâmetros | Tipo | Descrição |
---|---|---|
fill |
Booleano |
Obrigatório. Verdadeiro para preencher, falso para drenar. |
fillLevel |
String |
Indica o |
fillPercent |
Número |
Indica a porcentagem de nível solicitada. |
Exemplos
Encha a banheira.
{ "command": "action.devices.commands.Fill", "params": { "fill": true } }
Esvazie a banheira.
{ "command": "action.devices.commands.Fill", "params": { "fill": false } }
Encha a banheira até a metade.
{ "command": "action.devices.commands.Fill", "params": { "fill": true, "fillLevel": "half_level" } }
Aumente o nível de preenchimento da banheira em um. É necessário que o atributo ordered
seja true
.
{ "command": "action.devices.commands.Fill", "params": { "fill": true, "fillLevel": "full_level" } }