Schema der Smart-Home-Anwesenheitserkennung

action.devices.traits.OccupancySensing: Diese Eigenschaft gehört zu Geräten, die Anwesenheit erkennen können, sei es über PIR, Ultraschall oder die Erkennung von physischen Kontakten.

Geräte-ATTRIBUTE

Geräte mit dieser Eigenschaft melden möglicherweise die folgenden Attribute im Rahmen des SYNC-Vorgangs. Weitere Informationen zum Umgang mit 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 Verspätungen und den Ereignisschwellenwert enthalten.
[item, ...] Objekt

Einen Sensortyp und gegebenenfalls die zugehörigen Verspätungen und den Ereignisgrenzwert.
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 über Ultraschallerkennung.
PHYSICAL_CONTACT
Das Gerät unterstützt die Anwesenheitserkennung durch Körperkontakterkennung.
occupiedToUnoccupiedDelaySec Ganzzahl

Stellt die Zeitverzögerung in Sekunden dar, nach der sich die gemeldete Belegung nach dem letzten erkannten Ereignis in einen nicht belegten Status wechselt.
unoccupiedToOccupiedDelaySec Ganzzahl

Stellt die Zeitverzögerung in Sekunden dar, nach der sich die gemeldete Belegung nach dem letzten erkannten Ereignis in einen Belegungsstatus ändert. 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 Belegungsstatus ä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ät STATES

Entitäten mit diesem Trait können die folgenden Zustände als Teil des QUERY-Vorgangs melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Auftragsausführung.

Bundesstaaten Typ Beschreibung
occupancy String

Erforderlich.

Gibt an, ob das Gerät Anwesenheit erkennt.

Unterstützte Werte:

OCCUPIED
Das Gerät erkennt Anwesenheit.
UNOCCUPIED
Das Gerät erkennt keine Anwesenheit.
UNKNOWN_OCCUPANCY_STATE
Der aktuelle Anwesenheitsstatus, der vom Gerät erkannt wird, ist unbekannt.

Beispiele

Erkennt der Sensor Ihre Anwesenheit im Büro?

{
  "occupancy": "OCCUPIED"
}

BEFEHLE auf Gerät

Keine.

Gerät ERRORS

Sehen Sie sich die vollständige Liste der Fehler und Ausnahmen an.