Willkommen beim Google Home Developer Center, der neuen Anlaufstelle für Smart-Home-Aktionen. Hinweis:Sie erstellen weiterhin Aktionen in der Actions Console.
Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

SensorState Trait-Schema von Smart Home

action.devices.traits.SensorState: Diese Eigenschaft deckt sowohl quantitative Messungen als auch qualitative Werte ab.

Gerät ATTRIBUTE

Geräte mit diesem Attribut können die folgenden Attribute als Teil des Vorgangs SYNC melden. Weitere Informationen zum Umgang mit 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. Sensoren können auch beides melden. In diesem Fall wird der numerische Wert bevorzugt.

[item, ...] Objekt

Unterstützte Sensorfunktionen.

Mindestens 1 Artikel erforderlich.

name String

Erforderlich.

Unterstützter Sensortyp. Weitere Informationen finden Sie in der Tabelle „Unterstützte 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 implizit unterstützt, wenn der Sensor keinen Wert zurückgibt.

[item, ...] String

Unterstützter Wert für beschreibenden Status.

Mindestens 1 Artikel 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 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 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 ihre 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 filtern

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

Partikel

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

Geräte mit diesem Attribut können im Rahmen des Vorgangs QUERY die folgenden Zustände melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Auftragsausführung.

Bundesstaaten Typ Beschreibung
currentSensorStateData Array

Erforderlich.

Liste der aktuellen Sensorzustände.

[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.

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 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
    }
  ]
}

Gerätebefehle

Keine.

BENACHRICHTIGUNGEN auf Geräten

Geräte mit diesem Attribut können im Rahmen einer Gerätestatusänderung die folgende Benachrichtigungsnutzlast zurückgeben. Weitere Informationen zum Implementieren von Benachrichtigungen findest du unter Benachrichtigungen für Smart-Home-Aktionen.

Felder Typ Beschreibung
SensorState Objekt

Erforderlich.

Nutzlast der Benachrichtigung.

priority Ganzzahl

Erforderlich.

Die Benachrichtigungsstufe. Der aktuell unterstützte Wert ist 0, was bedeutet, dass die Benachrichtigung laut gesprochen werden soll.

name String

Erforderlich.

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

currentSensorState String

Erforderlich.

Aktueller Wert für den beschreibenden Status. 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

Erkennt Rauch.

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

Gerät ERRORS

Vollständige Liste der Fehler und Ausnahmen