Schema des SensorState-Traits für Smart-Home-Geräte
action.devices.traits.SensorState
: Diese Eigenschaft umfasst sowohl quantitative Messungen als auch den qualitativen Status.
Geräte-ATTRIBUTE
Geräte mit dieser Eigenschaft melden möglicherweise die folgenden Attribute im Rahmen des SYNC
-Vorgangs. Weitere Informationen zum Umgang mit SYNC
-Intents finden Sie unter Intent-Auftragsausführung.
Attribute | Typ | Beschreibung |
---|---|---|
sensorStatesSupported |
Array |
Erforderlich. Jedes Objekt stellt die von diesem Gerät unterstützten Sensorstatusfunktionen dar. Jeder Sensor muss mindestens eine beschreibende oder numerische Fähigkeit haben. Sensoren können auch beide erfassen. In diesem Fall wird der numerische Wert bevorzugt. |
[item, ...] |
Objekt |
Unterstützte Sensorfunktionen. Erfordert mindestens 1 Artikel. |
name |
String |
Erforderlich. Unterstützter Sensortyp. Siehe Tabelle der unterstützten Sensoren. |
descriptiveCapabilities |
Objekt |
Eine Beschreibung der Sensorfunktionen. |
availableStates |
Array |
Erforderlich. Liste der verfügbaren Status für das Gerät. Der Status „Unbekannt“ wird implizit unterstützt, wenn der Sensor keinen Wert zurückgibt. |
[item, ...] |
String |
Unterstützter beschreibender Statuswert. Erfordert mindestens 1 Artikel. |
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 dieser Eigenschaft unterstützt werden, findest du 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 den 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 | Beschreibende Funktionen | Numerische Funktionen |
---|---|---|
Unterstützte Werte:
|
Unterstützte Werte:
|
Unterstützte Werte:
|
Kohlenmonoxid
Name | Beschreibende Funktionen | Numerische Funktionen |
---|---|---|
Unterstützte Werte:
|
Unterstützte Werte:
|
Unterstützte Werte:
|
Rauchkonzentration
Name | Beschreibende Funktionen | Numerische Funktionen |
---|---|---|
Unterstützte Werte:
|
Unterstützte Werte:
|
Unterstützte Werte:
|
Filtersauberkeit
Name | Beschreibende Funktionen | Numerische Funktionen |
---|---|---|
Unterstützte Werte:
|
Unterstützte Werte:
|
Nicht unterstützt. |
Wasserleck
Name | Beschreibende Funktionen | Numerische Funktionen |
---|---|---|
Unterstützte Werte:
|
Unterstützte Werte:
|
Nicht unterstützt. |
Regenerkennung
Name | Beschreibende Funktionen | Numerische Funktionen |
---|---|---|
Unterstützte Werte:
|
Unterstützte Werte:
|
Nicht unterstützt. |
Filterlebensdauer
Name | Beschreibende Funktionen | Numerische Funktionen |
---|---|---|
Unterstützte Werte:
|
Unterstützte Werte:
|
Unterstützte Werte:
|
Berechnete Filterlebensdauer
Name | Beschreibende Funktionen | Numerische Funktionen |
---|---|---|
Unterstützte Werte:
|
Nicht unterstützt. | Unterstützte Werte:
|
Kohlendioxidkonzentration
Name | Beschreibende Funktionen | Numerische Funktionen |
---|---|---|
Unterstützte Werte:
|
Nicht unterstützt. | Unterstützte Werte:
|
Feinstaub
Name | Beschreibende Funktionen | Numerische Funktionen |
---|---|---|
Unterstützte Werte:
|
Nicht unterstützt. | Unterstützte Werte:
|
Flüchtige organische Verbindungen
Name | Beschreibende Funktionen | Numerische Funktionen |
---|---|---|
Unterstützte Werte:
|
Nicht unterstützt. | Unterstützte Werte:
|
Gerät STATES
Entitäten mit diesem Trait können die folgenden Status im Rahmen des QUERY
-Vorgangs melden. Weitere Informationen zum Umgang mit QUERY
-Intents finden Sie unter Intent-Auftragsausführung.
Bundesstaaten | Typ | Beschreibung |
---|---|---|
currentSensorStateData |
Array |
Erforderlich. Liste der aktuellen Sensorstatus. |
[item, ...] |
Objekt |
Aktueller Sensorstatus. |
name |
String |
Erforderlich. Name des Sensorstatus. Stimmt mit einem Wert aus |
currentSensorState |
String |
Aktueller beschreibender Statuswert. Stimmt mit einem Wert aus |
rawValue |
Number |
Aktueller numerischer Sensorwert. |
Weitere Informationen zu den verschiedenen Funktionen und Sensortypen, die von dieser Eigenschaft unterstützt werden, findest du unter Unterstützte Sensoren.
Beispiele
Sensorgerät, das einen beschreibenden Statuswert meldet.
{ "currentSensorStateData": [ { "name": "AirQuality", "currentSensorState": "healthy" } ] }
Sensorgerät, das den 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 } ] }
BEFEHLUNGEN auf dem Gerät
Keine.
Gerätebenachrichtigungen
Geräte mit dieser Eigenschaft können bei einer Gerätestatusänderung die folgende Nutzlast für Benachrichtigungen zurückgeben. Weitere Informationen zur Implementierung von Benachrichtigungen findest du unter Benachrichtigungen für Smart-Home-Aktionen.
Felder | Typ | Beschreibung |
---|---|---|
SensorState |
Objekt |
Erforderlich. Nutzlast für Benachrichtigungen. |
priority |
Ganzzahl |
Erforderlich. Stellt die Benachrichtigungsebene dar. Der derzeit unterstützte Wert ist 0. Dies bedeutet, dass die Benachrichtigung vorgelesen werden soll. |
name |
String |
Erforderlich. Name des Sensorstatus. Siehe Liste der unterstützten Sensortypen für Benachrichtigungen. |
currentSensorState |
String |
Erforderlich. Aktueller beschreibender Statuswert. Siehe 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
{ "SensorState": { "priority": 0, "name": "SmokeLevel", "currentSensorState": "high" } }