Smart-Home-Attributschema „SensorState“

action.devices.traits.SensorState: Diese Eigenschaft umfasst sowohl quantitative Messungen als auch qualitative Status.

Geräteattribute

Geräte mit diesem Merkmal können die folgenden Attribute im Rahmen des Vorgangs SYNC melden. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Ausführung.

Attribute Typ Beschreibung
sensorStatesSupported Array

Erforderlich.

Jedes Objekt stellt Sensorstatusfunktionen dar, die von diesem bestimmten Gerät unterstützt werden. Jeder Sensor muss mindestens eine beschreibende oder numerische Funktion haben. Sensoren können auch beides melden. In diesem Fall wird der numerische Wert bevorzugt.
[item, ...] Objekt

Unterstützte Sensorfunktionen

Es ist mindestens ein Element erforderlich.
name String

Erforderlich.

Unterstützter Sensortyp. Siehe Tabelle „Unterstützte Sensoren“.
descriptiveCapabilities Objekt

Eine Beschreibung der Funktionen des Sensors.
availableStates Array

Erforderlich.

Liste der für das Gerät verfügbaren Status. Der Status „unbekannt“ wird implizit unterstützt, wenn der Sensor keinen Wert zurückgibt.
[item, ...] String

Unterstützter beschreibender Statuswert.

Es ist mindestens ein Element erforderlich.
numericCapabilities Objekt

Beschreibt die möglichen numerischen Werte, die der Sensor melden kann.
rawValueUnit String

Erforderlich.

Unterstützte numerische Einheit.

Weitere Informationen zu den verschiedenen Funktionen und Sensortypen, die von diesem Attribut unterstützt werden, finden Sie unter Unterstützte Sensoren.

Beispiele

Sensorgerät, das einen beschreibenden Statuswert meldet.

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

Sensorgerät, das einen numerischen Statuswert meldet.

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

Sensorgerät, das einen beschreibenden und numerischen Statuswert meldet.

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

Unterstützte Sensoren

In den folgenden Tabellen sind die unterstützten Sensortypen und die zugehörigen Funktionen aufgeführt.

Luftqualität

Name Beschreibungsfunktionen Numerische Funktionen

Unterstützte Werte:

AirQuality

Unterstützte Werte:

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

Unterstützte Werte:

AQI

Kohlenmonoxid

Name Beschreibungsfunktionen Numerische Funktionen

Unterstützte Werte:

CarbonMonoxideLevel

Unterstützte Werte:

carbon monoxide detected
high
no carbon monoxide detected
unknown

Unterstützte Werte:

PARTS_PER_MILLION

Rauchkonzentration

Name Beschreibungsfunktionen Numerische Funktionen

Unterstützte Werte:

SmokeLevel

Unterstützte Werte:

smoke detected
high
no smoke detected
unknown

Unterstützte Werte:

PARTS_PER_MILLION

Filtersauberkeit

Name Beschreibungsfunktionen Numerische Funktionen

Unterstützte Werte:

FilterCleanliness

Unterstützte Werte:

clean
dirty
needs replacement
unknown
 Nicht unterstützt.

Wasserleck

Name Beschreibungsfunktionen Numerische Funktionen

Unterstützte Werte:

WaterLeak

Unterstützte Werte:

leak
no leak
unknown
 Nicht unterstützt.

Regenerkennung

Name Beschreibungsfunktionen Numerische Funktionen

Unterstützte Werte:

RainDetection

Unterstützte Werte:

rain detected
no rain detected
unknown
 Nicht unterstützt.

Filterlebensdauer

Name Beschreibungsfunktionen Numerische Funktionen

Unterstützte Werte:

FilterLifeTime

Unterstützte Werte:

new
good
replace soon
replace now
unknown

Unterstützte Werte:

PERCENTAGE

Berechnete Filterlebensdauer

Name Beschreibungsfunktionen Numerische Funktionen

Unterstützte Werte:

PreFilterLifeTime
HEPAFilterLifeTime
Max2FilterLifeTime
 Nicht unterstützt.

Unterstützte Werte:

PERCENTAGE

Kohlendioxidkonzentration

Name Beschreibungsfunktionen Numerische Funktionen

Unterstützte Werte:

CarbonDioxideLevel
 Nicht unterstützt.

Unterstützte Werte:

PARTS_PER_MILLION

Feinstaub

Name Beschreibungsfunktionen Numerische Funktionen

Unterstützte Werte:

PM2.5
PM10
 Nicht unterstützt.

Unterstützte Werte:

MICROGRAMS_PER_CUBIC_METER

Flüchtige organische Verbindungen

Name Beschreibungsfunktionen Numerische Funktionen

Unterstützte Werte:

VolatileOrganicCompounds
 Nicht unterstützt.

Unterstützte Werte:

PARTS_PER_MILLION

GERÄTESTATUS

Entitäten mit diesem Attribut können im Rahmen des Vorgangs QUERY die folgenden Status melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Ausführung.

Bundesstaaten Typ Beschreibung
currentSensorStateData Array

Erforderlich.

Liste der aktuellen Sensorstatus.
[item, ...] Objekt

Aktueller Sensorstatus.
name String

Erforderlich.

Name des Sensorstatus. Entspricht einem Wert aus sensorStatesSupported.
currentSensorState String

Aktueller beschreibender Statuswert. Entspricht einem Wert aus sensorStatesSupported.
rawValue Number

Aktueller numerischer Sensorwert.
alarmState String

Der Alarmstatus, der der aktuellen Sensormessung entspricht. Ein Voralarm oder Alarm kann ausgelöst werden, wenn die Sensormesswerte gefährliche Werte erreichen.

Unterstützte Werte:

IDLE
Der Alarm ist inaktiv. Die erkannten Werte sind nicht gefährlich.
PRE_ALARM_1
Die gemessenen Werte sind erhöht, haben aber noch nicht den kritischen Wert erreicht. Sie können jedoch bald gefährlich werden.
PRE_ALARM_2
Wenn das Gerät mehrere Warnungen unterstützt, bevor kritische Grenzwerte erreicht werden, weist dies auf höhere Erkennungsgrenzwerte als PRE_ALARM_1 hin. Die Grenzwerte steigen weiter an und nähern sich bald den kritischen Grenzwerten.
ALARM
Die erkannten Werte haben ein kritisches Niveau erreicht und ein Alarm wurde ausgelöst.
alarmSilenceState String

Gibt den Status der Stummschaltung für den Alarm des Sensors an, einschließlich der Information, ob die Stummschaltung eines aktiven Alarms derzeit zulässig ist. Dieser Status kann angegeben werden, wenn ein Voralarm- oder Alarmstatus aktiv ist.

Unterstützte Werte:

ALLOWED
Der Wecker ist nicht stummgeschaltet und das Stummschalten ist derzeit zulässig.
DISALLOWED
Der Alarm ist nicht stummgeschaltet und das ist derzeit auch nicht möglich.
SILENCED
Der Wecker wurde stummgeschaltet.

Weitere Informationen zu den verschiedenen Funktionen und Sensortypen, die von diesem Attribut unterstützt werden, finden Sie unter Unterstützte Sensoren.

Beispiele

Sensorgerät, das einen beschreibenden Statuswert meldet.

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

Sensorgerät, das einen numerischen Statuswert meldet.

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

Sensorgerät, das einen beschreibenden und numerischen Statuswert meldet.

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

Sensorgerät, das einen beschreibenden und numerischen Statuswert meldet und angibt, dass ein Alarm aktiv ist.

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

Gerätebefehle

Keine.

Gerätebenachrichtigungen

Geräte mit dieser Eigenschaft können im Rahmen einer Gerätestatusänderung die folgende Benachrichtigungsnutzlast zurückgeben. Weitere Informationen zur Implementierung von Benachrichtigungen finden Sie unter Benachrichtigungen für Smart-Home-Aktionen.

Felder Typ Beschreibung
SensorState Objekt

Erforderlich.

Benachrichtigungsnutzlast.
priority Ganzzahl

Erforderlich.

Stellt die Benachrichtigungsstufe dar. Der derzeit unterstützte Wert ist „0“, was bedeutet, dass die Benachrichtigung laut vorgelesen werden soll.
name String

Erforderlich.

Name des Sensorstatus. Liste der unterstützten Sensortypen für Benachrichtigungen
currentSensorState String

Erforderlich.

Aktueller beschreibender Statuswert. Liste der unterstützten Sensortypen für Benachrichtigungen

Die Benachrichtigungsnutzlast kann die folgenden Sensortypen enthalten:

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

Weitere Informationen zu den verschiedenen Funktionen, die von den einzelnen Sensortypen unterstützt werden, finden Sie unter Unterstützte Sensoren.

Beispiele

Der erkennt Rauch.

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

GERÄTEFEHLER

Eine vollständige Liste der Fehler und Ausnahmen