Schemat funkcji wykrywania obecności w inteligentnym 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.

Urządzenie ATTRIBUTES

Urządzenia z tą cechą mogą zgłaszać poniższe atrybuty w ramach operacji SYNC. Więcej informacji o obsłudze intencji SYNC znajdziesz w artykule o realizacji intencji.

Atrybuty Typ Opis
occupancySensorConfiguration Tablica

Lista obiektów, z których każdy zawiera typ czujnika oraz powiązane z nim opóźnienia i próg zdarzenia.

[item, ...] Obiekt

Typ czujnika oraz powiązane z nim opóźnienia i próg zdarzenia (w stosownych przypadkach).

occupancySensorType String

Wymagane.

Obsługiwane wartości:

PIR
Urządzenie obsługuje wykrywanie obecności za pomocą pasywnego wykrywania podczerwieni (PIR).
ULTRASONIC
Urządzenie obsługuje wykrywanie obecności za pomocą wykrywania ultradźwięków.
PHYSICAL_CONTACT
Urządzenie umożliwia wykrywanie obecności osób w domu przez wykrywanie kontaktu fizycznego.
occupiedToUnoccupiedDelaySec Liczba całkowita

Odzwierciedla czas (w sekundach), jaki upływa między zgłoszonym a zarejestrowanym zdarzeniem, aż zajęte miejsce zmieni się w nieobecność po ostatnim wykrytym zdarzeniu.

unoccupiedToOccupiedDelaySec Liczba całkowita

Odzwierciedla czas (w sekundach), jaki upłynął między zgłoszonym a obecnym zdarzeniem po ostatnim wykrytym zdarzeniu w stanie obecności. Wymagane, jeśli ustawiono occupiedToUnoccupiedDelaySec.

unoccupiedToOccupiedEventThreshold Liczba całkowita

Określa liczbę zdarzeń wykrywania, które muszą wystąpić w okresie unoccupiedToOccupiedDelaySec, zanim zarejestrowana obecność zmieni się w stanie obecności. Wymagane, jeśli ustawiono unoccupiedToOccupiedDelaySec.

Przykłady

Czujnik obecności obsługujący wykrywanie PIR i wykrywania ultradźwięków.

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

Urządzenie STATES

Encje z tą cechą mogą zgłaszać poniższe stany w ramach operacji QUERY. Więcej informacji o obsłudze intencji QUERY znajdziesz w artykule o realizacji intencji.

Stany Typ Opis
occupancy String

Wymagane.

Wskazuje, czy urządzenie wykrywa obecność.

Obsługiwane wartości:

OCCUPIED
Urządzenie wykryło obłożenie.
UNOCCUPIED
Urządzenie nie wykrywa obecności.
UNKNOWN_OCCUPANCY_STATE
Obecny stan obłożenia wykryty przez urządzenie jest nieznany.

Przykłady

Czy czujnik wykrywa obecność w biurze?

{
  "occupancy": "OCCUPIED"
}

CommandS na urządzeniu

Brak.

Urządzenie ERRORS

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