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 levels (por exemplo, meio nível).
supportsFillPercent	Booleano	Padrão: false. 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 availableFillLevels estiver definido. Indica o level_name atual do atributo availableFillLevels em que o dispositivo está 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"
}

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 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 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"
  }
}

Dispositivo ERRORS

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