Te damos la bienvenida al Centro para desarrolladores de Google Home, el nuevo destino para aprender a desarrollar acciones para el hogar inteligente. Nota: Continuarás compilando acciones en la Consola de Actions.
Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Esquema de la característica de relleno para el hogar inteligente

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

ATTRIBUTES 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 el manejo de 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 niveles y sinónimos específicos de idiomas.

[item, ...] Objeto

Nombre del nivel y sus sinónimos específicos del idioma.

level_name String

Obligatorio.

El 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 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 maneja la gramática adicional para aumentar o disminuir la lógica, como lo representa el arreglo 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 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

Los dispositivos con esta característica pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre el manejo de 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 establece el atributo availableFillLevels. Indica el level_name actual del atributo availableFillLevels en el que se llena el dispositivo.

currentFillPercent Número

Obligatorio si se establece 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 COMMANDS

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 el manejo de 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.

Verdadero para completar, falso para vaciar.

fillLevel String

Indica el level_name del atributo availableFillLevels que se establecerá. Si no se especifica, llena 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
  }
}

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

Aumente 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.