Schema del tratto di riempimento della smart home

action.devices.traits.Fill: questa caratteristica si applica ai dispositivi che supportano il riempimento, come una vasca da bagno.

ATTRIBUTI dispositivo

I dispositivi con questa caratteristica potrebbero segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per saperne di più sulla gestione degli intent SYNC, consulta Completamento degli intent.

Attributi Tipo Descrizione
availableFillLevels Oggetto

Descrive i diversi livelli di riempimento del dispositivo.
levels Array

Obbligatorio.

Elenco dei nomi dei livelli e dei sinonimi specifici per la lingua.
[item, ...] Oggetto

Nome del livello e relativi sinonimi specifici per lingua.
level_name String

Obbligatorio.

Nome interno del livello. Questo può essere difficile da leggere e verrà condiviso in tutte le lingue.
level_values Array

Obbligatorio.

Sinonimi del livello in ogni lingua supportata.
[item, ...] Oggetto

Sinonimi del livello in una determinata lingua. Per fornire il fallback della lingua, è necessario almeno un elemento con un valore lang di en.
level_synonym Array

Obbligatorio.

Sinonimo del livello. La prima stringa di questo elenco viene utilizzata come nome canonico del livello in quella lingua.
[item, ...] String

Nome del sinonimo. Per fornire il fallback della lingua, è necessario almeno un elemento con un valore lang di en.
lang String

Obbligatorio.

Codice lingua (ISO 639-1). Consulta le lingue supportate.
ordered Valore booleano

Obbligatorio.

Se è vero, il dispositivo gestisce la grammatica aggiuntiva per la logica di aumento o diminuzione, come rappresentato dall'array levels (ad esempio, metà livello).
supportsFillPercent Valore booleano

(Predefinito: false)

Se è true, accetta i comandi per regolare il livello su una percentuale.

Esempi

Dispositivo con funzionalità di riempimento o svuotamento di base che non supporta livelli di riempimento discreti.

{}

Dispositivo che supporta i livelli di riempimento discreti.

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

STATI del dispositivo

Le entità con questo tratto possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per saperne di più sulla gestione degli intent QUERY, consulta Completamento degli intent.

Stati Tipo Descrizione
isFilled Valore booleano

Obbligatorio.

Vero se il dispositivo è riempito a qualsiasi livello. False se il dispositivo è completamente scarico.
currentFillLevel String

Obbligatorio se l'attributo availableFillLevels è impostato. Indica l'level_name attuale dell'attributo availableFillLevels a cui viene riempito il dispositivo.
currentFillPercent Number

Obbligatorio se l'attributo supportsFillPercent è impostato. Indica la percentuale di riempimento attuale.

Esempi

La vasca da bagno è piena?

{
  "isFilled": true
}

La vasca da bagno è piena? (con livelli).

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

COMANDI del dispositivo

I dispositivi con questo tratto potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per saperne di più sulla gestione degli intent EXECUTE, consulta Completamento degli intent.

action.devices.commands.Fill

Riempi o svuota il dispositivo.

Parametri

Parametri Tipo Descrizione
fill Valore booleano

Obbligatorio.

True per riempire, false per svuotare.
fillLevel String

Indica il level_name dell'attributo availableFillLevels da impostare. Se non specificato, riempi fino al livello predefinito.
fillPercent Number

Indica la percentuale del livello richiesto.

Esempi

Riempi la vasca da bagno.

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

Svuota la vasca da bagno.

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

Riempi la vasca da bagno a metà.

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

Aumenta il livello di riempimento della vasca da bagno di un'unità (richiede che l'attributo ordered sia true).

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

ERRORI del dispositivo

Consulta l'elenco completo di errori ed eccezioni.