Esquema de la función de autocompletado del hogar inteligente

action.devices.traits.Fill: Esta característica se aplica a los dispositivos que admiten llenarse, como una bañera.

ATRIBUTOS DEL Dispositivo

Los dispositivos con esta característica pueden informar los siguientes atributos como parte de la operación SYNC. Para obtener más información sobre cómo manejar los intents SYNC, consulta Entrega de intents.

Atributos	Tipo	Descripción
availableFillLevels	Objeto	Describe los diferentes niveles de relleno del dispositivo.
levels	Matriz	Obligatorio. Lista de nombres de nivel y sinónimos específicos de idioma.
[item, ...]	Objeto	Nombre del nivel y sus sinónimos específicos del idioma
level_name	String	Obligatorio. Nombre interno del nivel. Esto puede no ser fácil de usar y se compartirá en todos los idiomas.
level_values	Matriz	Obligatorio. Sinónimos del nivel en cada idioma admitido.
[item, ...]	Objeto	Sinónimos del nivel en un idioma determinado.
level_synonym	Matriz	Obligatorio. Sinónimo del nivel. La primera string de esta lista se usa como el nombre canónico del nivel en ese idioma.
[item, ...]	String	Nombre del sinónimo.
lang	String	Obligatorio. Código de idioma (ISO 639-1). Consulte los idiomas compatibles.
ordered	Booleano	Obligatorio. Si es verdadero, el dispositivo controla la gramática adicional para la lógica de aumento o disminución, como lo representa el array levels (por ejemplo, medio nivel).
supportsFillPercent	Booleano	(Predeterminado: false) Si es verdadero, acepta comandos para ajustar el nivel a un porcentaje.

Ejemplos

Dispositivo con capacidades básicas de relleno o desvío que no admite niveles de relleno discretos.

{}

Dispositivo que admite niveles de relleno 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
  }
}

Dispositivo STATEs

Las entidades con esta característica pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre cómo manejar los intents QUERY, consulta Entrega de intents.

Estados	Tipo	Descripción
isFilled	Booleano	Obligatorio. Verdadero si el dispositivo está lleno. Falso si el dispositivo se agota por completo.
currentFillLevel	String	Obligatorio si se configura el atributo availableFillLevels. Indica el level_name actual del atributo availableFillLevels en el que se completa el dispositivo.
currentFillPercent	Número	Obligatorio si se configura el atributo supportsFillPercent. Indica el porcentaje actual de nivel de relleno.

Ejemplos

¿La bañera está llena?

{
  "isFilled": true
}

¿La bañera está llena? (con niveles).

{
  "isFilled": true,
  "currentFillLevel": "half_level"
}

Dispositivo COMMAND

Los dispositivos con esta característica pueden responder a los siguientes comandos como parte de la operación EXECUTE. Para obtener más información sobre cómo manejar los intents EXECUTE, consulta Entrega de intents.

action.devices.commands.Fill

Llena o desvía el dispositivo.

Parámetros

Parámetros	Tipo	Descripción
fill	Booleano	Obligatorio. True para rellenar, false para vaciar.
fillLevel	String	Indica el level_name del atributo availableFillLevels que se establecerá. Si no se especifica, se rellena al nivel predeterminado.
fillPercent	Número	Indica el porcentaje de nivel solicitado.

Ejemplos

Llene la bañera

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

Desvía la bañera.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": false
  }
}

Llene la bañera a la mitad.

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

Aumenta el nivel de relleno de la bañera en uno (el atributo ordered debe ser true).

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

Dispositivo ERRORS

Consulta la lista completa de errores y excepciones.