SensorState Trait-Schema für Smart Home

action.devices.traits.SensorState: Dieses Merkmal umfasst sowohl quantitative Messungen als auch den qualitativen Status.

Geräte-ATTRIBUTES

Auf Geräten mit diesem Trait kann Folgendes gemeldet werden im Rahmen des SYNC-Vorgangs verwenden. Weitere Informationen Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Absichtliche Umsetzung.

Attribute	Typ	Beschreibung
sensorStatesSupported	Array	Erforderlich. Jedes Objekt stellt Funktionen zum Sensorstatus dar, die von diesem Gerät unterstützt werden. Jeder Sensor muss über eine beschreibende oder numerische Fähigkeit verfügen. Sensoren können auch beide melden, wobei der numerische Wert bevorzugt wird.
[item, ...]	Objekt	Unterstützte Sensorfunktionen. Benötigt mindestens 1 Element.
name	String	Erforderlich. Unterstützter Sensortyp. Weitere Informationen finden Sie in der Tabelle mit den unterstützten Sensoren.
descriptiveCapabilities	Objekt	Eine Beschreibung der Sensorfunktionen.
availableStates	Array	Erforderlich. Liste der verfügbaren Status für das Gerät. Das „Unbekannte“ state wird implizit unterstützt, wenn der Sensor keinen Wert zurückgibt.
[item, ...]	String	Unterstützter Wert für beschreibenden Status. Benötigt mindestens 1 Element.
numericCapabilities	Objekt	Beschreibt die möglichen numerischen Werte, die der Sensor melden kann.
rawValueUnit	String	Erforderlich. Unterstützte numerische Einheit.

Unter Unterstützte Sensoren finden Sie weitere Informationen zu den verschiedenen Funktionen und Sensortypen, die diese Eigenschaft unterstützt.

Beispiele

Sensorgerät, das einen aussagekräftigen 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: 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	Beschreibende Funktionen	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	Beschreibende Funktionen	Numerische Funktionen
Unterstützte Werte: SmokeLevel	Unterstützte Werte: smoke detected high no smoke detected unknown	Unterstützte Werte: PARTS_PER_MILLION

Sauberkeit des Filters

Name	Beschreibende Funktionen	Numerische Funktionen
Unterstützte Werte: FilterCleanliness	Unterstützte Werte: clean dirty needs replacement unknown	Nicht unterstützt.

Wasserleck

Name	Beschreibende Funktionen	Numerische Funktionen
Unterstützte Werte: WaterLeak	Unterstützte Werte: leak no leak unknown	Nicht unterstützt.

Regenerkennung

Name	Beschreibende Funktionen	Numerische Funktionen
Unterstützte Werte: RainDetection	Unterstützte Werte: rain detected no rain detected unknown	Nicht unterstützt.

Filterlebensdauer

Name	Beschreibende Funktionen	Numerische Funktionen
Unterstützte Werte: FilterLifeTime	Unterstützte Werte: new good replace soon replace now unknown	Unterstützte Werte: PERCENTAGE

Berechnete Filterlebensdauer

Name	Beschreibende Funktionen	Numerische Funktionen
Unterstützte Werte: PreFilterLifeTime HEPAFilterLifeTime Max2FilterLifeTime	Nicht unterstützt.	Unterstützte Werte: PERCENTAGE

Kohlendioxidkonzentration

Name	Beschreibende Funktionen	Numerische Funktionen
Unterstützte Werte: CarbonDioxideLevel	Nicht unterstützt.	Unterstützte Werte: PARTS_PER_MILLION

Feinstaub

Name	Beschreibende Funktionen	Numerische Funktionen
Unterstützte Werte: PM2.5 PM10	Nicht unterstützt.	Unterstützte Werte: MICROGRAMS_PER_CUBIC_METER

Flüchtige organische Verbindungen

Name	Beschreibende Funktionen	Numerische Funktionen
Unterstützte Werte: VolatileOrganicCompounds	Nicht unterstützt.	Unterstützte Werte: PARTS_PER_MILLION

Gerät: STATES

Entitäten mit diesem Merkmal melden möglicherweise Folgendes: QUERY-Bundesstaaten. Weitere Informationen Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Absichtliche Umsetzung.

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 Wert für den beschreibenden Status. Entspricht einem Wert aus sensorStatesSupported.
rawValue	Number	Aktueller numerischer Sensorwert.

Unter Unterstützte Sensoren finden Sie weitere Informationen zu den verschiedenen Funktionen und Sensortypen, die diese Eigenschaft unterstützt.

Beispiele

Sensorgerät, das einen aussagekräftigen 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
    }
  ]
}

Gerät "COMMANDS"

Keine.

BENACHRICHTIGUNGEN ZUM GERÄT

Geräte mit diesem Merkmal können Folgendes zurückgeben: Benachrichtigungsnutzlast im Rahmen einer Gerätestatusänderung. Weitere Informationen 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 vorgelesen werden soll.
name	String	Erforderlich. Name des Sensorstatus. Liste der unterstützten Sensortypen für Benachrichtigungen ansehen.
currentSensorState	String	Erforderlich. Aktueller Wert für den beschreibenden Status. Liste der unterstützten Sensortypen für Benachrichtigungen ansehen.

Die Nutzlast der Benachrichtigung kann die folgenden Sensortypen enthalten:

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

Unter Unterstützte Sensoren finden Sie weitere Informationen zu den verschiedenen die von jedem Sensortyp unterstützt werden.

Beispiele

erkennt Rauch.

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

Gerätefehler

Vollständige Liste der Fehler und Ausnahmen.