Smart-Home-Attributschema für Anwesenheitserkennung

action.devices.traits.OccupancySensing: Diese Eigenschaft bezieht sich auf Geräte, die die Anwesenheit erkennen können, sei es durch PIR-, Ultraschall- oder Berührungssensoren.

Geräteattribute

Geräte mit diesem Merkmal können die folgenden Attribute im Rahmen des Vorgangs SYNC melden. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Ausfü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

Ein Sensortyp und die zugehörigen Verzögerungen und Ereignisgrenzwerte, falls zutreffend.
occupancySensorType String

Erforderlich.

Unterstützte Werte:

PIR
Das Gerät unterstützt die Anwesenheitserkennung durch passive Infrarot-Technologie (PIR).
ULTRASONIC
Das Gerät unterstützt die Anwesenheitserkennung durch Ultraschall.
PHYSICAL_CONTACT
Das Gerät unterstützt die Anwesenheitserkennung durch physischen Kontakt.
occupiedToUnoccupiedDelaySec Ganzzahl

Die Zeitverzögerung in Sekunden, bevor sich die gemeldete Belegung nach dem letzten erkannten Ereignis in den Status „Nicht besetzt“ ändert.
unoccupiedToOccupiedDelaySec Ganzzahl

Die Zeitverzögerung in Sekunden, bevor sich die gemeldete Belegung nach dem letzten erkannten Ereignis in einen besetzten Status ändert. Erforderlich, wenn occupiedToUnoccupiedDelaySec festgelegt ist.
unoccupiedToOccupiedEventThreshold Ganzzahl

Gibt an, wie viele Erfassungsereignisse im Zeitraum unoccupiedToOccupiedDelaySec auftreten müssen, bevor der gemeldete Belegungsgrad in den Status „Belegt“ wechselt. Erforderlich, wenn unoccupiedToOccupiedDelaySec festgelegt ist.

Beispiele

Bewegungssensor, 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 Attribut können im Rahmen des Vorgangs QUERY die folgenden Status melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Ausführung.

Bundesstaaten Typ Beschreibung
occupancy String

Erforderlich.

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

Unterstützte Werte:

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

Beispiele

Erkennt der Sensor die Anwesenheit im Büro?

{
  "occupancy": "OCCUPIED"
}

Gerätebefehle

Keine.

GERÄTEFEHLER

Eine vollständige Liste der Fehler und Ausnahmen