Schemat cech inteligentnego wykrywania obłożenia domu

action.devices.traits.OccupancySensing – ta cecha należy do urządzeń, które wykrywają obecność – za pomocą PIR, ultradźwięków lub wykrywania kontaktu fizycznego.

ATTRIBUTES urządzenia

W ramach operacji SYNC urządzenia z tą cechą mogą zgłaszać wymienione poniżej atrybuty. Więcej informacji o obsłudze intencji SYNC znajdziesz w sekcji Realizacja intencji.

Atrybuty Typ Opis
occupancySensorConfiguration Tablica

Lista obiektów zawierających dane o typach czujników, powiązane z nimi opóźnienia oraz wartości progowe zdarzeń.
[item, ...] Obiekt

Typ czujnika wraz z powiązanymi opóźnieniami i odpowiednim progiem zdarzenia (w stosownych przypadkach).
occupancySensorType String

Wymagane.

Obsługiwane wartości:

PIR
Urządzenie obsługuje wykrywanie obecności przez wykrywanie pasywnego ruchu w podczerwieni (PIR).
ULTRASONIC
Urządzenie obsługuje wykrywanie obłożenia za pomocą wykrywania ultradźwiękowego.
PHYSICAL_CONTACT
Urządzenie obsługuje wykrywanie obłożenia dzięki wykrywaniu kontaktu fizycznego.
occupiedToUnoccupiedDelaySec Liczba całkowita

Odzwierciedla czas w sekundach przed zgłoszeniem obłożenia zmienił się na nikogo nieobecny po ostatnim wykrytym zdarzeniu.
unoccupiedToOccupiedDelaySec Liczba całkowita

Odzwierciedla czas w sekundach przed zgłoszeniem obłożenia, po którym ostatnio wystąpiło zdarzenie. Wymagane, jeśli ustawiono occupiedToUnoccupiedDelaySec.
unoccupiedToOccupiedEventThreshold Liczba całkowita

Określa liczbę zdarzeń wykrywania, które muszą wystąpić w okresie unoccupiedToOccupiedDelaySec, zanim zarejestrowana liczba osób zmieni się na zajęty. Wymagane, jeśli ustawiono unoccupiedToOccupiedDelaySec.

Przykłady

Czujnik obecności, który obsługuje funkcję PIR i wykrywanie ultradźwiękowe.

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

Urządzenie STATES

W ramach operacji QUERY encje z tą cechą mogą zgłaszać wymienione poniżej stany. Więcej informacji o obsłudze intencji QUERY znajdziesz w sekcji Realizacja intencji.

Stany Typ Opis
occupancy String

Wymagane.

Wskazuje, czy urządzenie wykrywa obecność.

Obsługiwane wartości:

OCCUPIED
Urządzenie wykrywa obecność.
UNOCCUPIED
Urządzenie nie wykrywa obecności.
UNKNOWN_OCCUPANCY_STATE
Bieżący stan obłożenia wykryty przez urządzenie jest nieznany.

Przykłady

Czy czujnik wykrywa obecność w biurze?

{
  "occupancy": "OCCUPIED"
}

Urządzenie CommandS

Brak.

Urządzenie ERRORS

Zobacz pełną listę błędów i wyjątków.