Schema für die Anwesenheitserkennung für Smart Home

action.devices.traits.OccupancySensing: Dieses Merkmal gehört zu Geräten, die Anwesenheit erkennen können, z. B. über PIR, Ultraschall oder physische Kontakterkennung.

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
occupancySensorConfiguration Array

Eine Liste von Objekten, die jeweils den Sensortyp und die zugehörigen Verzögerungen und Ereignisgrenzwerte enthalten.
[item, ...] Objekt

Einen Sensortyp und gegebenenfalls die zugehörigen Verzögerungen und Ereignisgrenzwerte
occupancySensorType String

Erforderlich.

Unterstützte Werte:

PIR
Das Gerät unterstützt die Anwesenheitserkennung durch passive Infraroterkennung (PIR).
ULTRASONIC
Das Gerät unterstützt die Anwesenheitserkennung durch Ultraschallerkennung.
PHYSICAL_CONTACT
Das Gerät unterstützt die Anwesenheit über die physische Kontakterkennung.
occupiedToUnoccupiedDelaySec Ganzzahl

Die Zeitverzögerung in Sekunden, bevor die gemeldete Belegung nach dem letzten erkannten Ereignis in einen Status wechselt, der nicht genutzt wird.
unoccupiedToOccupiedDelaySec Ganzzahl

Stellt die Zeitverzögerung in Sekunden dar, bevor die gemeldete Belegung nach dem letzten erkannten Ereignis in einen Belegungsstatus wechselt. Erforderlich, wenn occupiedToUnoccupiedDelaySec festgelegt ist.
unoccupiedToOccupiedEventThreshold Ganzzahl

Gibt die Anzahl der Erkennungsereignisse an, die im unoccupiedToOccupiedDelaySec-Zeitraum auftreten müssen, bevor sich die gemeldete Belegung in einen besetzten Status ändert. Erforderlich, wenn unoccupiedToOccupiedDelaySec festgelegt ist.

Beispiele

Anwesenheitssensor, der PIR und Ultraschallerkennung unterstützt.

{
  "occupancySensorConfiguration": [
    {
      "occupancySensorType": "PIR",
      "occupiedToUnoccupiedDelaySec": 10,
      "unoccupiedToOccupiedDelaySec": 10,
      "unoccupiedToOccupiedEventThreshold": 2
    },
    {
      "occupancySensorType": "ULTRASONIC",
      "occupiedToUnoccupiedDelaySec": 10,
      "unoccupiedToOccupiedDelaySec": 10,
      "unoccupiedToOccupiedEventThreshold": 2
    }
  ]
}

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
occupancy String

Erforderlich.

Gibt an, ob das Gerät eine Anwesenheit erkennt.

Unterstützte Werte:

OCCUPIED
Das Gerät erkennt Anwesenheit.
UNOCCUPIED
Das Gerät erkennt keine Anwesenheit.
UNKNOWN_OCCUPANCY_STATE
Der aktuelle vom Gerät erkannte Anwesenheitsstatus ist unbekannt.

Beispiele

Erkennt der Sensor, ob jemand zu Hause ist?

{
  "occupancy": "OCCUPIED"
}

BEISPIELE für Geräte

Keine.

Gerät ERRORS

Hier finden Sie die vollständige Liste der Fehler und Ausnahmen.