Esquema de rasgo de relleno de casa inteligente

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

ATRIBUTOS DISPOSITIVOS

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

Atributos	Tipo	Descripción
availableFillLevels	Objeto	Describe los diferentes niveles de llenado del dispositivo.
levels	Matriz	Obligatorio. 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. No es 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 cadena de esta lista se usa como nombre canónico del nivel en ese idioma.
[item, ...]	String	Nombre del sinónimo.
lang	String	Obligatorio. Código de idioma (ISO 639-1). Consulta 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 se representa en el array levels (por ejemplo, medio nivel).
supportsFillPercent	Booleano	(Predeterminado: false) Si esta preferencia se establece como "true", acepta comandos para ajustar el nivel a porcentaje.

Ejemplos

Dispositivo con capacidades básicas de llenado o vaciado 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 lo siguiente estados como parte de la operación QUERY. Para aprender Para obtener más información sobre cómo controlar los intents QUERY, consulta Entrega de intents.

Estados	Tipo	Descripción
isFilled	Booleano	Obligatorio. Es verdadero si el dispositivo está lleno en algún nivel. Falso si el dispositivo se vaciaba por completo.
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 del nivel de relleno 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 lo siguiente comandos como parte de la operación EXECUTE. Para aprender Para obtener más información sobre cómo controlar los intents EXECUTE, consulta Entrega de intents.

action.devices.commands.Fill

Llena o vacía el dispositivo.

Parámetros

Parámetros	Tipo	Descripción
fill	Booleano	Obligatorio. True para completar; falso para desviar.
fillLevel	String	Indica el level_name del atributo availableFillLevels que se debe configurar. Si no se especifica, se debe completar el nivel predeterminado.
fillPercent	Número	Indica el porcentaje del nivel solicitado.

Ejemplos

Llena la bañera.

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

Vacía 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"
  }
}

Aumenta el nivel de relleno 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 DE DISPOSITIVO

Consulta la lista completa de errores y excepciones.