Esquema da característica de preenchimento de casa inteligente
action.devices.traits.Fill
: esta característica se aplica a dispositivos compatíveis com encher a banheira, como uma banheira.
ATRIBUTOS do dispositivo
Os dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC
. Para saber
mais sobre como lidar com 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 do idioma. |
[item, ...] |
Object |
Nome do nível e sinônimos específicos do idioma. |
level_name |
String |
Obrigatório. Nome interno do nível. Essa opção pode ser difícil de usar e será compartilhada em todos os idiomas. |
level_values |
Array |
Obrigatório. Sinônimos do nível em cada idioma suportado. |
[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). Veja os idiomas compatíveis. |
ordered |
Booleano |
Obrigatório. Se for verdadeiro, o dispositivo processará gramática adicional para aumentar ou diminuir a lógica, conforme 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 são compatíveis com 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
As entidades com essa característica podem informar os estados a seguir como parte da operação QUERY
. Para saber
mais sobre como lidar com 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 completamente 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" }
Dispositivo COMMANDS
Os dispositivos com essa característica podem responder aos comandos a seguir como parte da operação EXECUTE
. Para saber
mais sobre como lidar com 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 do nível solicitado. |
Exemplos
Preencha a banheira.
{ "command": "action.devices.commands.Fill", "params": { "fill": true } }
Drene a banheira.
{ "command": "action.devices.commands.Fill", "params": { "fill": false } }
Preencha a metade da banheira.
{ "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" } }