Esquema del rasgo de Smart Home Fill

action.devices.traits.Fill: Este rasgo se aplica a los dispositivos que admiten llenado, como una bañera.

Atributos del dispositivo

Los dispositivos con este rasgo pueden informar los siguientes atributos como parte de la operación SYNC. Para obtener más información sobre cómo controlar intents de SYNC, consulta Entrega de intents.

Atributos Tipo Descripción
availableFillLevels Objeto

Describe los diferentes niveles de llenado del dispositivo.
levels Matriz

Obligatorio.

Es una lista de nombres de niveles y sinónimos específicos del 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

Son los sinónimos del nivel en un idioma determinado. Se requiere al menos un elemento con un valor de lang de en para proporcionar un resguardo de idioma.
level_synonym Matriz

Obligatorio.

Sinónimo del nivel. La primera cadena de esta lista se usa como el nombre canónico del nivel en ese idioma.
[item, ...] String

Nombre del sinónimo. Se requiere al menos un elemento con un valor de lang de en para proporcionar un resguardo de idioma.
lang String

Obligatorio.

Código de idioma (ISO 639-1). Consulta los idiomas admitidos.
ordered Booleano

Obligatorio.

Si es verdadero, el dispositivo controla la gramática adicional para la lógica de aumento o disminución, como se representa en 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 llenado o vaciado que no admite niveles de llenado discretos.

{}

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

ESTADOS del dispositivo

Las entidades con este rasgo pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre cómo controlar intents de QUERY, consulta Entrega de intents.

Estados Tipo Descripción
isFilled Booleano

Obligatorio.

Es verdadero si el dispositivo está lleno en cualquier nivel. Es falso si el dispositivo está completamente descargado.
currentFillLevel String

Es obligatorio si se configura el atributo availableFillLevels. Indica el level_name actual del atributo availableFillLevels en el que se llena el dispositivo.
currentFillPercent Número

Es obligatorio si se configura el atributo supportsFillPercent. Indica el porcentaje de nivel de llenado actual.

Ejemplos

¿La bañera está llena?

{
  "isFilled": true
}

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

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

COMANDOS del dispositivo

Los dispositivos con este rasgo pueden responder a los siguientes comandos como parte de la operación EXECUTE. Para obtener más información sobre cómo controlar intents de EXECUTE, consulta Entrega de intents.

action.devices.commands.Fill

Llenar o vaciar el dispositivo

Parámetros

Parámetros Tipo Descripción
fill Booleano

Obligatorio.

Verdadero para llenar, falso para vaciar.
fillLevel String

Indica el level_name del atributo availableFillLevels que se establecerá. Si no se especifica, se completará hasta el nivel predeterminado.
fillPercent Número

Indica el porcentaje de nivel solicitado.

Ejemplos

Llena la bañera.

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

Vaciar la bañera

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

Llena la bañera hasta la mitad.

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

Aumentar el nivel de llenado de la bañera en uno (requiere que el atributo ordered sea true)

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

ERRORES del dispositivo

Consulta la lista completa de errores y excepciones.