Schema del tratto SensorState per la smart home

action.devices.traits.SensorState: questo attributo copre sia la misurazione quantitativa sia lo stato qualitativo.

ATTRIBUTI del dispositivo

I dispositivi con questa caratteristica possono segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta Adempimento degli intent.

Attributi Tipo Descrizione
sensorStatesSupported Array

Obbligatorio.

Ogni oggetto rappresenta le funzionalità dello stato del sensore supportate da questo dispositivo specifico. Ogni sensore deve avere almeno una funzionalità descrittiva o numerica. I sensori possono anche segnalare entrambi, in questo caso verrà preferito il valore numerico.
[item, ...] Oggetto

Funzionalità dei sensori supportate.

È necessario almeno un elemento.
name String

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, ...] String

Valore dello stato descrittivo supportato.

È necessario almeno un elemento.
numericCapabilities Oggetto

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

Obbligatorio.

Unità numerica supportata.

Per ulteriori dettagli sulle diverse funzionalità e sui tipi di sensori supportati da questa funzionalità, consulta Sensori supportati.

Esempi

Dispositivo sensore che riporta un valore di stato descrittivo.

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

Dispositivo sensore che riporta il valore dello stato numerico.

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

Dispositivo sensore che riporta un valore di stato descrittivo e numerico.

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

Sensori supportati

Le tabelle seguenti 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 supportati.

Perdita d'acqua

Nome Funzionalità descrittive Funzionalità numeriche

Valori supportati:

WaterLeak

Valori supportati:

leak
no leak
unknown
 Non supportati.

Rilevamento della pioggia

Nome Funzionalità descrittive Funzionalità numeriche

Valori supportati:

RainDetection

Valori supportati:

rain detected
no rain detected
unknown
 Non supportati.

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 calcolata

Nome Funzionalità descrittive Funzionalità numeriche

Valori supportati:

PreFilterLifeTime
HEPAFilterLifeTime
Max2FilterLifeTime
 Non supportati.

Valori supportati:

PERCENTAGE

Livello di anidride carbonica

Nome Funzionalità descrittive Funzionalità numeriche

Valori supportati:

CarbonDioxideLevel
 Non supportati.

Valori supportati:

PARTS_PER_MILLION

Particolato

Nome Funzionalità descrittive Funzionalità numeriche

Valori supportati:

PM2.5
PM10
 Non supportati.

Valori supportati:

MICROGRAMS_PER_CUBIC_METER

Sostanze organiche volatili

Nome Funzionalità descrittive Funzionalità numeriche

Valori supportati:

VolatileOrganicCompounds
 Non supportati.

Valori supportati:

PARTS_PER_MILLION

STATI del dispositivo

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

Stati Tipo Descrizione
currentSensorStateData Array

Obbligatorio.

Elenco degli stati attuali del sensore.
[item, ...] Oggetto

Stato attuale del sensore.
name String

Obbligatorio.

Nome dello stato del sensore. Corrisponde a un valore di sensorStatesSupported.
currentSensorState String

Valore dello stato descrittivo corrente. Corrisponde a un valore di sensorStatesSupported.
rawValue Number

Valore numerico corrente del sensore.
alarmState String

Lo stato dell'allarme corrispondente alla lettura del sensore corrente. Un pre-allarme o un allarme può essere attivato quando le letture del sensore si avvicinano e raggiungono livelli pericolosi.

Valori supportati:

IDLE
L'allarme è inattivo; i livelli rilevati non sono pericolosi.
PRE_ALARM_1
I livelli rilevati sono elevati, ma non hanno ancora raggiunto i livelli di emergenza. A breve potrebbero diventare pericolosi.
PRE_ALARM_2
Se il dispositivo supporta più avvisi prima di raggiungere i livelli di emergenza, significa che i livelli di rilevamento sono superiori a PRE_ALARM_1; i livelli continuano ad aumentare e potrebbero presto avvicinarsi ai livelli di emergenza.
ALARM
I livelli rilevati hanno raggiunto livelli di emergenza ed è stato attivato un allarme.
alarmSilenceState String

Indica lo stato di silenziamento dell'allarme del sensore, incluso se al momento è consentito silenziare un allarme attivo. Questo stato può essere fornito quando è attivo uno stato di preallarme o di allarme.

Valori supportati:

ALLOWED
La sveglia non è silenziata e al momento è consentito silenziarla.
DISALLOWED
La sveglia non è silenziata e al momento non è consentito silenziarla.
SILENCED
L'allarme è stato silenziato.

Per ulteriori dettagli sulle diverse funzionalità e sui tipi di sensori supportati da questa funzionalità, consulta Sensori supportati.

Esempi

Dispositivo sensore che riporta un valore di stato descrittivo.

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

Dispositivo sensore che riporta il valore dello stato numerico.

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

Dispositivo sensore che riporta un valore di stato descrittivo e numerico.

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

Dispositivo sensore che riporta un valore di stato descrittivo e numerico e indica che è attivo un avviso.

{
  "currentSensorStateData": [
    {
      "name": "SmokeLevel",
      "currentSensorState": "smoke detected",
      "rawValue": 200,
      "alarmState": "ALARM",
      "alarmSilenceState": "DISALLOWED"
    }
  ]
}

COMANDI del dispositivo

Nessuno.

NOTIFICHE del dispositivo

I dispositivi con questa caratteristica possono restituire il seguente payload di notifica nell'ambito di una modifica dello stato del dispositivo. Per scoprire di più sull'implementazione delle notifiche, consulta Notifiche per le azioni per la smart home.

Campi Tipo Descrizione
SensorState Oggetto

Obbligatorio.

Payload della notifica.
priority Intero

Obbligatorio.

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

Obbligatorio.

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

Obbligatorio.

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

Il payload della notifica può contenere i seguenti tipi di sensori:

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

Per ulteriori dettagli sulle diverse funzionalità supportate da ogni tipo di sensore, consulta la sezione Sensori supportati.

Esempi

Il rileva fumo.

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

ERRORI del dispositivo

Consulta l'elenco completo di errori ed eccezioni.