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 levels (por exemplo, metade do 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 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 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"
}

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

Dispositivo ERRORS

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