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 tratto sensore stato smart home

action.devices.traits.SensorState: questa caratteristica è valida sia per la misurazione quantitativa sia per lo stato qualitativo.

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
sensorStatesSupported Array

Obbligatorio.

Ogni oggetto rappresenta le funzionalità di stato del sensore supportate da questo dispositivo specifico. Ogni sensore deve avere almeno una capacità descrittiva o numerica. I sensori possono anche segnalare entrambi, nel qual caso verrà preferito il valore numerico.

[item, ...] Oggetto

Funzionalità dei sensori supportate.

Richiede almeno 1 articolo.

name Stringa

Obbligatorio.

Tipo di sensore supportato. Consulta la tabella Sensori supportati.

descriptiveCapabilities Oggetto

Una descrizione delle funzionalità del sensore.

availableStates Array

Obbligatorio.

Elenco degli stati disponibili per il dispositivo. Lo stato "sconosciuto" è supportato implicitamente quando il sensore non restituisce un valore.

[item, ...] Stringa

Valore di stato descrittivo supportato.

Richiede almeno 1 articolo.

numericCapabilities Oggetto

Descrive i possibili valori numerici che il sensore può segnalare.

rawValueUnit Stringa

Obbligatorio.

Unità numerica supportata.

Consulta la sezione Sensori supportati per ulteriori dettagli sulle diverse funzionalità e sui tipi di sensori supportati da questa caratteristica.

Esempi

Sensore che segnala un valore descrittivo.

{
  "sensorStatesSupported": [
    {
      "name": "AirQuality",
      "descriptiveCapabilities": {
        "availableStates": [
          "healthy",
          "moderate",
          "unhealthy",
          "very unhealthy"
        ]
      }
    }
  ]
}

Sensore che segnala un valore numerico di stato.

{
  "sensorStatesSupported": [
    {
      "name": "CarbonMonoxideLevel",
      "numericCapabilities": {
        "rawValueUnit": "PARTS_PER_MILLION"
      }
    }
  ]
}

Sensore che segnala un valore descrittivo e numerico.

{
  "sensorStatesSupported": [
    {
      "name": "SmokeLevel",
      "numericCapabilities": {
        "rawValueUnit": "PARTS_PER_MILLION"
      },
      "descriptiveCapabilities": {
        "availableStates": [
          "smoke detected",
          "high",
          "no smoke detected"
        ]
      }
    }
  ]
}

Sensori supportati

Le seguenti tabelle elencano i tipi di sensori supportati e le relative funzionalità associate.

Qualità dell'aria

Nome Funzionalità descrittive Funzionalità numeriche

Valori supportati:

AirQuality

Valori supportati:

healthy
moderate
unhealthy
unhealthy for sensitive groups
very unhealthy
hazardous
good
fair
poor
very poor
severe
unknown

Valori supportati:

AQI

Monossido di carbonio

Nome Funzionalità descrittive Funzionalità numeriche

Valori supportati:

CarbonMonoxideLevel

Valori supportati:

carbon monoxide detected
high
no carbon monoxide detected
unknown

Valori supportati:

PARTS_PER_MILLION

Livello di fumo

Nome Funzionalità descrittive Funzionalità numeriche

Valori supportati:

SmokeLevel

Valori supportati:

smoke detected
high
no smoke detected
unknown

Valori supportati:

PARTS_PER_MILLION

Pulizia del filtro

Nome Funzionalità descrittive Funzionalità numeriche

Valori supportati:

FilterCleanliness

Valori supportati:

clean
dirty
needs replacement
unknown
Non supportato.

Perdita d'acqua

Nome Funzionalità descrittive Funzionalità numeriche

Valori supportati:

WaterLeak

Valori supportati:

leak
no leak
unknown
Non supportato.

Rilevamento della pioggia

Nome Funzionalità descrittive Funzionalità numeriche

Valori supportati:

RainDetection

Valori supportati:

rain detected
no rain detected
unknown
Non supportato.

Durata del filtro

Nome Funzionalità descrittive Funzionalità numeriche

Valori supportati:

FilterLifeTime

Valori supportati:

new
good
replace soon
replace now
unknown

Valori supportati:

PERCENTAGE

Durata del filtro calcolato

Nome Funzionalità descrittive Funzionalità numeriche

Valori supportati:

PreFilterLifeTime
HEPAFilterLifeTime
Max2FilterLifeTime
Non supportato.

Valori supportati:

PERCENTAGE

Livello di anidride carbonica

Nome Funzionalità descrittive Funzionalità numeriche

Valori supportati:

CarbonDioxideLevel
Non supportato.

Valori supportati:

PARTS_PER_MILLION

Particolato

Nome Funzionalità descrittive Funzionalità numeriche

Valori supportati:

PM2.5
PM10
Non supportato.

Valori supportati:

MICROGRAMS_PER_CUBIC_METER

Composti organici volatili

Nome Funzionalità descrittive Funzionalità numeriche

Valori supportati:

VolatileOrganicCompounds
Non supportato.

Valori supportati:

PARTS_PER_MILLION

STATEs dispositivo

I dispositivi con questa caratteristica potrebbero 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
currentSensorStateData Array

Obbligatorio.

Elenco degli stati dei sensori correnti.

[item, ...] Oggetto

Stato attuale del sensore.

name Stringa

Obbligatorio.

Nome dello stato del sensore. Corrisponde a un valore da sensorStatesSupported.

currentSensorState Stringa

Valore attuale dello stato descrittivo. Corrisponde a un valore da sensorStatesSupported.

rawValue Number

Valore numerico del sensore attuale.

Consulta la sezione Sensori supportati per ulteriori dettagli sulle diverse funzionalità e sui tipi di sensori supportati da questa caratteristica.

Esempi

Sensore che segnala un valore descrittivo.

{
  "currentSensorStateData": [
    {
      "name": "AirQuality",
      "currentSensorState": "healthy"
    }
  ]
}

Sensore che segnala un valore numerico di stato.

{
  "currentSensorStateData": [
    {
      "name": "CarbonMonoxideLevel",
      "rawValue": 200
    }
  ]
}

Sensore che segnala un valore descrittivo e numerico.

{
  "currentSensorStateData": [
    {
      "name": "SmokeLevel",
      "currentSensorState": "smoke detected",
      "rawValue": 200
    }
  ]
}

comandi del dispositivo

Nessuno.

NOTIFICHE DEL DISPOSITIVO

Nell'ambito di una modifica dello stato del dispositivo, i dispositivi con questa caratteristica potrebbero restituire il seguente payload di notifica. Per scoprire di più sull'implementazione delle notifiche, consulta Notifiche per le azioni relative alla smart home.

Campi Tipo Descrizione
SensorState Oggetto

Obbligatorio.

Payload della notifica.

priority Intero

Obbligatorio.

Rappresenta il livello di notifica. Il valore attualmente supportato è 0, il che indica che la notifica deve essere pronunciata ad alta voce.

name Stringa

Obbligatorio.

Nome dello stato del sensore. Visualizza l'elenco dei tipi di sensori supportati per le notifiche.

currentSensorState Stringa

Obbligatorio.

Valore attuale dello stato descrittivo. Visualizza l'elenco dei tipi di sensori supportati per le notifiche.

Il payload delle notifiche può contenere i seguenti tipi di sensori:

  • AirQuality
  • CarbonMonoxideLevel
  • SmokeLevel
  • FilterCleanliness
  • WaterLeak
  • RainDetection
  • FilterLifeTime

Vedi Sensori supportati per ulteriori dettagli sulle diverse funzionalità supportate da ogni tipo di sensore.

Esempi

Il rileva fumo.

{
  "SensorState": {
    "priority": 0,
    "name": "SmokeLevel",
    "currentSensorState": "high"
  }
}

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.