Ti diamo il benvenuto nel Centro sviluppatori Google Home, la nuova destinazione per imparare a sviluppare azioni per la smart home. Nota:continuerai a creare azioni nella Console Actions.
Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

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.