Schema für die Eigenschaft „Smart-Home-Anwesenheitserkennung“

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

Geräte-ATTRIBUTES

Auf Geräten mit diesem Trait kann Folgendes gemeldet werden im Rahmen des SYNC-Vorgangs verwenden. Weitere Informationen Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Absichtliche Umsetzung.

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 über einen passiven Infrarotsensor (PIR).
ULTRASONIC
Das Gerät unterstützt die Anwesenheitserkennung über Ultraschallerkennung.
PHYSICAL_CONTACT
Das Gerät erkennt Anwesenheit über die physische Kontakterkennung.
occupiedToUnoccupiedDelaySec Ganzzahl

Gibt die Zeitverzögerung in Sekunden an, nach der sich die gemeldete Belegung nach dem letzten erkannten Ereignis in den Status „Nicht belegt“ ändert.
unoccupiedToOccupiedDelaySec Ganzzahl

Gibt die Zeitverzögerung in Sekunden an, 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 Merkmal melden möglicherweise Folgendes: QUERY-Bundesstaaten. Weitere Informationen Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Absichtliche Umsetzung.

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 Anwesenheit im Büro?

{
  "occupancy": "OCCUPIED"
}

Gerät "COMMANDS"

Keine.

Gerätefehler

Vollständige Liste der Fehler und Ausnahmen.