Schema der Smart-Home-Belegung

action.devices.traits.OccupancySensing: Diese Eigenschaft gehört zu Geräten, die Anwesenheit erkennen können, sei es durch PIR-, Ultraschall- oder Körperkontakterkennung.

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 Verzögerungen und den Ereignisschwellenwert enthalten.
[item, ...] Objekt

Ein 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 ermöglicht die Anwesenheitserkennung durch Körperkontakterkennung.
occupiedToUnoccupiedDelaySec Ganzzahl

Zeigt die Zeitverzögerung in Sekunden an, nach der sich die gemeldete Anwesenheit nach dem letzten erkannten Ereignis in einen nicht belegten Status wechselt.
unoccupiedToOccupiedDelaySec Ganzzahl

Zeigt die Zeitverzögerung in Sekunden an, nach der sich die gemeldete Anwesenheit nach dem letzten erkannten Ereignis in einen Status „Belegt“ ändert. Erforderlich, wenn occupiedToUnoccupiedDelaySec festgelegt ist.
unoccupiedToOccupiedEventThreshold Ganzzahl

Gibt die Anzahl der Erkennungsereignisse an, die im unoccupiedToOccupiedDelaySec-Zeitraum auftreten müssen, bevor die gemeldete Belegung zu „Belegt“ wechselt. 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 Status im Rahmen 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 eine 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 wurde, ist unbekannt.

Beispiele

Erkennt der Sensor Ihre Anwesenheit im Büro?

{
  "occupancy": "OCCUPIED"
}

BEFEHLUNGEN auf dem Gerät

Keine.

Gerät ERRORS

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