Schema dei tratti di riempimento della smart home

action.devices.traits.Fill: questa caratteristica si applica ai dispositivi che supportano il riempimento, ad esempio le vasche da bagno.

ATTRIBUTES dispositivo

I dispositivi con questo tratto potrebbero segnalare quanto segue nell'ambito dell'operazione SYNC. Per ulteriori informazioni scopri di più sulla gestione degli intent SYNC; consulta Completamento dell'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 della lingua.
[item, ...]	Oggetto	Nome del livello e sinonimi specifici della lingua.
level_name	String	Obbligatorio. Nome interno del livello. Questi dati non sono facili da usare e verranno condivisi in tutte le lingue.
level_values	Array	Obbligatorio. Sinonimi del livello in ogni lingua supportata.
[item, ...]	Oggetto	Sinonimi del livello in una data lingua.
level_synonym	Array	Obbligatorio. Sinonimo del livello. La prima stringa di questo elenco viene utilizzata come nome canonico del livello nella lingua in questione.
[item, ...]	String	Nome sinonimo.
lang	String	Obbligatorio. Codice lingua (ISO 639-1). Vedi le lingue supportate.
ordered	Valore booleano	Obbligatorio. Se il valore è true, il dispositivo gestisce una grammatica aggiuntiva per la logica di aumento o diminuzione, come rappresentato dall'array levels (ad esempio, metà livello).
supportsFillPercent	Valore booleano	(Valore predefinito: false) Se il valore è true, accetta i comandi per impostare il livello su una percentuale.

Esempi

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

{}

Dispositivo che supporta 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
  }
}

STATES del dispositivo

Le entità con questo tratto possono segnalare quanto segue nell'ambito dell'operazione QUERY. Per ulteriori informazioni scopri di più sulla gestione degli intent QUERY; consulta Completamento dell'intent.

Stati	Tipo	Descrizione
isFilled	Valore booleano	Obbligatorio. True se il dispositivo è riempito a qualsiasi livello. Falso se il dispositivo è completamente svuotato.
currentFillLevel	String	Obbligatorio se viene impostato l'attributo availableFillLevels. Indica il valore level_name corrente dell'attributo availableFillLevels in cui viene compilato il dispositivo.
currentFillPercent	Number	Obbligatorio se viene impostato l'attributo supportsFillPercent. Indica la percentuale del livello di riempimento attuale.

Esempi

La vasca da bagno è piena?

{
  "isFilled": true
}

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

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

COMANDI dispositivo

I dispositivi con questo tratto potrebbero rispondere ai seguenti nell'ambito dell'operazione EXECUTE. Per ulteriori informazioni scopri di più sulla gestione degli intent EXECUTE; consulta Completamento dell'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 valore level_name dell'attributo availableFillLevels da impostare. Se non specificato, viene utilizzato il 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 uno (richiede che l'attributo ordered sia true).

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

ERRORI dispositivo

Consulta l'elenco completo errori ed eccezioni.