Schema dei tratti di riempimento per la smart home

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

ATTRIBUTES del dispositivo

I dispositivi con questo trait potrebbero segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta fulfillment dell'intent.

Attributi	Tipo	Descrizione
availableFillLevels	Oggetto	Descrive i diversi livelli di riempimento del dispositivo.
levels	Matrice	Obbligatorio. Elenco di nomi dei livelli e sinonimi specifici della lingua.
[item, ...]	Oggetto	Il nome del livello e i relativi sinonimi specifici della lingua.
level_name	String	Obbligatorio. Nome interno del livello. Non è facile da usare e verrà condiviso in tutte le lingue.
level_values	Matrice	Obbligatorio. Sinonimi del livello in ogni lingua supportata.
[item, ...]	Oggetto	Sinonimi del livello in una determinata lingua.
level_synonym	Matrice	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.
lang	String	Obbligatorio. Codice lingua (ISO 639-1). Consulta le lingue supportate.
ordered	Booleano	Obbligatorio. Se il valore è true, il dispositivo gestisce la grammatica aggiuntiva per la logica di aumento o diminuzione, come rappresentato dall'array levels (ad esempio, metà livello).
supportsFillPercent	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
  }
}

Dispositivo STATES

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

Stati	Tipo	Descrizione
isFilled	Booleano	Obbligatorio. True se il dispositivo viene riempito a qualsiasi livello. Falso se il dispositivo è completamente svuotato.
currentFillLevel	String	Obbligatorio se è impostato l'attributo availableFillLevels. Indica l'attuale level_name dall'attributo availableFillLevels in cui il dispositivo viene compilato.
currentFillPercent	Number	Obbligatorio se è 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 i livelli).

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

COMMANDS dispositivo

I dispositivi con questa caratteristica potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per scoprire di più sulla gestione degli intent EXECUTE, consulta fulfillment dell'intent.

action.devices.commands.Fill

Riempi o svuota il dispositivo.

Parametri

Parametri	Tipo	Descrizione
fill	Booleano	Obbligatorio. Vero per riempire, falso per svuotare.
fillLevel	String	Indica level_name dell'attributo availableFillLevels da impostare. Se non specificato, inserisci 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 l'attributo ordered di true).

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

ERRORS dispositivo

Consulta l'elenco completo di errori ed eccezioni.