Schema des Sensorstatus der Smart-Home-Steuerung
action.devices.traits.SensorState
: Diese Eigenschaft deckt sowohl die quantitative Messung als auch den qualitativen Zustand ab.
Geräte-ATTRIBUTE
Geräte mit diesem Merkmal können im Rahmen des SYNC
-Vorgangs die folgenden Attribute melden. Weitere Informationen zum Verarbeiten von SYNC
-Intents finden Sie unter Intent-Auftragsausführung.
Attribute | Typ | Beschreibung |
---|---|---|
sensorStatesSupported |
Array |
Erforderlich. Jedes Objekt stellt Sensorstatusfunktionen dar, die von diesem Gerät unterstützt werden. Jeder Sensor muss mindestens eine beschreibende oder numerische Fähigkeit haben. Die Sensoren können auch beides melden. In diesem Fall wird der numerische Wert bevorzugt. |
[item, ...] |
Objekt |
Unterstützte Sensorfunktionen. Erfordert mindestens 1 Element. |
name |
String |
Erforderlich. Unterstützter Sensortyp Siehe Tabelle mit den unterstützten Sensoren. |
descriptiveCapabilities |
Objekt |
Eine Beschreibung der Funktionen des Sensors. |
availableStates |
Array |
Erforderlich. Liste der verfügbaren Status für das Gerät. Der Status „Unbekannt“ wird unterstützt, wenn der Sensor keinen Wert zurückgibt. |
[item, ...] |
String |
Unterstützter Wert für beschreibenden Status Erfordert mindestens 1 Element. |
numericCapabilities |
Objekt |
Beschreibt die möglichen numerischen Werte, die vom Sensor erfasst werden können. |
rawValueUnit |
String |
Erforderlich. Unterstützte numerische Einheit. |
Weitere Informationen zu den verschiedenen Funktionen und Sensortypen, die von diesem Merkmal 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 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 ihre 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:
|
Sauberkeit filtern
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ätestatus
Entitäten mit diesem Merkmal können im Rahmen des QUERY
-Vorgangs die folgenden Status melden: Weitere Informationen zum Verarbeiten von 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. Entspricht einem Wert aus |
currentSensorState |
String |
Aktueller Wert für den beschreibenden Status. Entspricht einem Wert aus |
rawValue |
Number |
Aktueller numerischer Sensorwert |
Weitere Informationen zu den verschiedenen Funktionen und Sensortypen, die von diesem Merkmal 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 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 } ] }
BEISPIELE für Geräte
Keine.
BENACHRICHTIGUNGEN auf Geräten
Geräte mit diesem Merkmal können im Rahmen einer Gerätestatusänderung die folgende Nutzlast der Benachrichtigung zurückgeben. Weitere Informationen zum Implementieren von Benachrichtigungen finden Sie unter Benachrichtigungen für Smart-Home-Aktionen.
Felder | Typ | Beschreibung |
---|---|---|
SensorState |
Objekt |
Erforderlich. Nutzlast der Benachrichtigung. |
priority |
Ganzzahl |
Erforderlich. Die Benachrichtigungsebene. Der aktuell unterstützte Wert ist 0, was bedeutet, dass die Benachrichtigung vorgelesen werden soll. |
name |
String |
Erforderlich. Name des Sensorstatus. Benachrichtigungen finden Sie in der Liste der unterstützten Sensortypen. |
currentSensorState |
String |
Erforderlich. Aktueller Wert für den beschreibenden Status. Benachrichtigungen finden Sie in der Liste der unterstützten Sensortypen. |
Die Benachrichtigungsnutzlast kann die folgenden Sensortypen enthalten:
AirQuality
CarbonMonoxideLevel
SmokeLevel
FilterCleanliness
WaterLeak
RainDetection
FilterLifeTime
Unter Unterstützte Sensoren finden Sie weitere Informationen zu den verschiedenen Funktionen, die von den einzelnen Sensortypen unterstützt werden.
Beispiele
Das
{ "SensorState": { "priority": 0, "name": "SmokeLevel", "currentSensorState": "high" } }