Schema delle caratteristiche di riempimento della smart home

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

ATTRIBUTE del dispositivo

I dispositivi con questa caratteristica potrebbero segnalare i seguenti attributi come parte dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta Soddisfazione degli intent.

Attributi	Tipo	Descrizione
availableFillLevels	Oggetto	Descrive i diversi livelli di riempimento del dispositivo.
levels	Array	Obbligatorio. Elenco di nomi di livelli e sinonimi specifici per la lingua.
[item, ...]	Oggetto	Nome del livello e i suoi sinonimi specifici per la lingua.
level_name	Stringa	Obbligatorio. Nome interno del livello. Questa funzionalità non è facile da usare e verrà condivisa in tutte le lingue.
level_values	Array	Obbligatorio. Sinonimi del livello in ogni lingua supportata.
[item, ...]	Oggetto	Sinonimi del livello in una determinata lingua.
level_synonym	Array	Obbligatorio. Sinonimo di livello. La prima stringa dell'elenco viene utilizzata come nome canonico del livello in quella lingua.
[item, ...]	Stringa	Nome sinonimo.
lang	Stringa	Obbligatorio. Codice lingua (ISO 639-1). Scopri le lingue supportate.
ordered	Booleano	Obbligatorio. Se true, il dispositivo gestisce una grammatica aggiuntiva per aumentare o diminuire la logica, come rappresentato dall'array levels (ad esempio, a metà livello).
supportsFillPercent	Booleano	(Valore 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 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 dispositivo

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

Stati	Tipo	Descrizione
isFilled	Booleano	Obbligatorio. True se il dispositivo è riempito a qualsiasi livello. False se il dispositivo è completamente svuotato.
currentFillLevel	Stringa	Obbligatorio se è impostato l'attributo availableFillLevels. Indica il level_name attuale dall'attributo availableFillLevels in cui il dispositivo viene riempito.
currentFillPercent	Number	Obbligatorio se è impostato l'attributo supportsFillPercent. Indica la percentuale del livello di riempimento corrente.

Esempi

La vasca da bagno è piena?

{
  "isFilled": true
}

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

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

comandi del dispositivo

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

action.devices.commands.Fill

Riempi o svuota il dispositivo.

Parametri

Parametri	Tipo	Descrizione
fill	Booleano	Obbligatorio. True per riempire, falso per svuotare.
fillLevel	Stringa	Indica il level_name dell'attributo availableFillLevels da impostare. Se il valore non è specificato, compila 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 di uno il livello di riempimento della vasca (è necessario che l'attributo ordered sia true).

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

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.