Esquema de preenchimento da casa inteligente

action.devices.traits.Fill: essa característica se aplica a dispositivos que permitem preenchimento, como uma banheira.

ATRIBUTOS do dispositivo

Dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC. Para saber mais sobre o gerenciamento de intents SYNC, consulte fulfillment de intents.

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. Ele não é fácil de usar e vai ser compartilhado em todos os idiomas.
level_values	Array	Obrigatório. Sinônimos do nível em cada idioma compatível.
[item, ...]	Object	Sinônimos do nível em um determinado idioma.
level_synonym	Array	Obrigatório. Sinônimo de "level". A primeira string nessa lista é usada como o nome canônico do nível no idioma em questão.
[item, ...]	String	Nome do 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 vai processar mais gramática para aumentar ou diminuir a lógica, conforme representado pela matriz levels (por exemplo, meio nível).
supportsFillPercent	Booleano	Padrão: false. Se verdadeiro, aceite os comandos para ajustar o nível como porcentagem.

Exemplos

Dispositivo com recursos básicos de preenchimento ou drenagem que não oferece suporte a níveis de preenchimento discretos.

{}

Dispositivo compatível com níveis de preenchimento 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
  }
}

STATES do dispositivo

Entidades com essa característica podem informar os seguintes estados como parte da operação QUERY. Para saber mais sobre o gerenciamento de intents QUERY, consulte fulfillment de intents.

Estados	Tipo	Descrição
isFilled	Booleano	Obrigatório. Verdadeiro se o dispositivo estiver cheio. Falso se o dispositivo estiver completamente drenado.
currentFillLevel	String	Obrigatório se o atributo availableFillLevels estiver definido. Indica o level_name atual do atributo availableFillLevels em que o dispositivo é preenchido.
currentFillPercent	Número	Obrigatório se o atributo supportsFillPercent estiver definido. Indica a porcentagem atual do nível de preenchimento.

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 o gerenciamento de intents EXECUTE, consulte fulfillment de intents.

action.devices.commands.Fill

Encha ou esvazie o dispositivo.

Parâmetros

Parâmetros	Tipo	Descrição
fill	Booleano	Obrigatório. Verdadeiro para preencher, falso para esvaziar.
fillLevel	String	Indica o level_name do atributo availableFillLevels a ser definido. Se não for especificado, preencha o nível padrão.
fillPercent	Número	Indica a porcentagem do 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 (o atributo ordered precisa ser true).

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "full_level"
  }
}

ERROS DO Dispositivo

Veja a lista completa de erros e exceções.