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.