LW IT Solutions logo LW IT Solutions logo LW IT Solutions
« Przegląd bloga /CCTV / Przesyłanie alarmów ruchu z kamer do Home...
Ten artykuł w innych językach:

Przesyłanie alarmów ruchu z kamer do Home Assistant: opóźnienia ONVIF

Przesyłanie alarmów ruchu z kamer do Home Assistant: opóźnienia ONVIFPrzesyłanie alarmów ruchu z kamer do Home Assistant: opóźnienia ONVIF

Management Summary

Powiadomienia o ruchu łączą aktywność wykrytą przez kamerę z działaniami w Home Assistant. ONVIF to standard komunikacji umożliwiający obsługującym go kamerom przekazywanie takich zdarzeń. Otrzymanie komunikatu może być szybsze niż wielokrotne pytanie kamery o ruch. Poprawia to reakcję automatyki domowej, ale zależy od obsługi urządzenia i działającej sieci. Niezawodne działanie wymaga również rozpoznania końca alarmu oraz wznowienia odbioru po przerwaniu połączenia.

Spis treści
  1. Pull-Point: zapytanie, które czeka
  2. Znaczenie interwału pięciu sekund
  3. Rzeczywiste działanie Home Assistant
  4. Drogi sieciowe i przerwy w odbiorze
  5. Diagnoza przed przypisaniem winy oprogramowaniu kamery
  6. Praktyczna kontrola automatyzacji
  7. Pytania i odpowiedzi
  8. Źródła

Zdarzenia ONVIF mogą dostarczać alarmy ruchu do Home Assistant szybciej niż sprawdzanie stanu w stałych odstępach. Korzyść wynika z oczekującego już zapytania Pull-Point albo z powiadomienia kamery wysłanego na webhook. Wykrywanie, transport sieciowy i przetwarzanie nadal wymagają czasu. Nie powstaje gwarancja dostarczania bez opóźnień ani bez utraty zdarzeń.

Poniższe szczegóły implementacji dotyczą Home Assistant Core 2026.10.4 oraz zależności onvif-zeep-async 4.3.0. Opis protokołu opiera się na ONVIF Core Specification 26.06.

Pull-Point: zapytanie, które czeka

CreatePullPointSubscription tworzy subskrypcję i zwraca adres końcowy. Następnie PullMessages pobiera dostępne powiadomienia. Jeśli wiadomości już czekają, kamera odpowiada od razu, do wskazanego limitu. W przeciwnym razie zapytanie oczekuje na zdarzenie albo upływ limitu czasu. To długie odpytywanie, a nie praca bez zapytań.

Przy Basic Notification polecenie Subscribe rejestruje adres odbiorczy. Kamera nawiązuje połączenie z tym adresem i przesyła wiadomości Notify. Home Assistant wykorzystuje w tym celu webhook: adres odbiorczy, na który kamera wysyła powiadomienia. Dla obu metod istotne są czas ważności i odnowienie subskrypcji; rzeczywista obsługa oraz niezawodność zależą od urządzenia.

Znaczenie interwału pięciu sekund

Przy interfejsie zwracającym wyłącznie aktualny stan alarmu od wykrycia do kolejnego sprawdzenia może upłynąć niemal cały interwał. Takt pięciu sekund dodaje zatem do około pięciu sekund oczekiwania. Krótki alarm między sprawdzeniami może zostać pominięty, o ile interfejs nie przechowuje stanu alarmu ani historii zdarzeń.

Średnia równa połowie interwału zakłada równomierny rozkład zdarzeń w czasie oraz regularne wykonywanie zapytań. Przy tych założeniach takt pięciu sekund dodaje średnio 2,5 sekundy. To obliczenie, a nie pomiar opóźnienia całego toru: wykrywanie, transport, kolejki i wykonanie automatyzacji dodają dalszy czas.

Rzeczywiste działanie Home Assistant

Sprawdzona integracja najpierw próbuje Pull-Point. Przy domyślnie aktywnej opcji „Enable Webhooks” podejmuje też próbę uruchomienia webhooka. Poprawnie przetworzone powiadomienie webhook wstrzymuje pobieranie Pull-Point. Wstrzymane zostają również odnowienia Pull-Point, więc stara subskrypcja może wygasnąć. Nie ma zatem gwarancji stale aktywnego równoległego toru odbioru.

Zapytania Pull-Point wskazują limit czasu 60 sekund i najwyżej 100 wiadomości. Integracja zwykle odczekuje 0,75 sekundy między zapytaniami. Niektóre błędy powodują dłuższe przerwy przed ponowieniem. Zdarzenia powstałe w takich przerwach wymagają późniejszego pobrania; oczekujące zapytanie nie usuwa każdego źródła opóźnienia.

Żądana ważność subskrypcji wynosi dziesięć minut. Biblioteka planuje jednak odnowienie po 80 procentach czasu ważności zgłoszonego przez kamerę; przy braku informacji czasowych korzysta z żądanego okresu. Osiem minut pasuje więc do przyznanych dziesięciu minut, ale nie jest uniwersalnym interwałem dla wszystkich kamer. Przed pomnożeniem przez 0,8 obliczenie przyjmuje co najmniej 60 sekund ważności; nietypowo krótkie okresy wymagają więc szczególnej kontroli.

Dostarczanie zdarzeń ONVIF: stałe odpytywanie, Pull-Point, webhook i ograniczenia odnowienia.
Dostarczanie zdarzeń ONVIF: stałe odpytywanie, Pull-Point, webhook i ograniczenia odnowienia.

Drogi sieciowe i przerwy w odbiorze

Pull-Point rozpoczyna połączenie od Home Assistant do punktu końcowego ONVIF kamery. Zapora śledząca stan połączeń musi przepuszczać odpowiedzi. Sam transport zdarzeń nie wymaga dostępu do internetu. Webhook potrzebuje dodatkowo drogi od kamery do faktycznie zarejestrowanego adresu i portu Home Assistant.

Webhook zablokowany od początku może pozostać niezauważony, gdy działa Pull-Point. Późniejsza cicha awaria po przełączeniu na webhook jest trudniejsza do wykrycia. Udane odnowienie subskrypcji nie dowodzi docierania powiadomień do odbiorcy. Ważne są więc próbne wywołanie ruchu i rzeczywiste zmiany sensorów. Zablokowana droga powrotna nie gwarantuje braku utraty zdarzeń.

Limity bezczynności zapory, serwera pośredniczącego i routera powinny uwzględniać 60-sekundowy timeout Pull-Point oraz odpowiedni zapas. Sama wartość minimalnie powyżej 60 sekund nie gwarantuje nieprzerwanej pracy.

Diagnoza przed przypisaniem winy oprogramowaniu kamery

HTTP 500 może przenosić zwykłą odpowiedź SOAP fault. Znaczenie mają treść błędu i operacja. Początkowe kontrole obejmują uprawnienia ONVIF, zegar kamery, włączone wykrywanie, obsługiwane tematy, adresy końcowe oraz drogi sieciowe. Następnie warto sprawdzić limity subskrypcji, błędy odnowienia i wersję oprogramowania.

Integracja oraz biblioteka obsługują różne błędy przez ponowienia lub nowe subskrypcje. Wiele komunikatów pojawia się na poziomie debug; nieznane lub nieczytelne zdarzenia mogą też generować ostrzeżenia. Dzienniki zawężają przyczyny, ale same nie dowodzą wady urządzenia. NVR z własnym wykrywaniem w strumieniu RTSP stanowi możliwą alternatywę i wymaga odpowiedniego oprogramowania oraz zasobów obliczeniowych.

Praktyczna kontrola automatyzacji

Znane typy zdarzeń, które rzeczywiście docierają, mogą tworzyć odpowiednie encje Home Assistant, na przykład binarne sensory ruchu. Kamera musi wykryć zdarzenie, a Home Assistant przypisać zgłoszoną kategorię zdarzenia do odpowiedniego sensora. Przydatny test obejmuje początek alarmu, zakończenie alarmu, restart oraz celowo przerwane połączenie. Przywrócona łączność powinna ponownie powodować obserwowalne zmiany stanu.

Pytania i odpowiedzi

Ile zapytań powstaje bez zdarzeń?

Idealizowany cykl Pull-Point z oczekiwaniem 60 sekund i przerwą 0,75 sekundy daje długoterminowo około 59 pobrań na godzinę. Przyznana ważność dziesięciu minut dodaje około 7,5 odnowienia, łącznie około 67 zapytań. Nie obejmuje to konfiguracji, synchronizacji, zdarzeń, innych zapytań Home Assistant ani ponowień. Odpytywanie co pięć sekund daje 720 zapytań na godzinę, a co sekundę 3600.

Czy nieudana subskrypcja uruchamia odpytywanie stanu w stałym takcie?

Sprawdzony menedżer zdarzeń nie ma takiego mechanizmu zastępczego. Ponowienia i ewentualne przełączenia między webhookiem a Pull-Point nadal należą do obsługi zdarzeń. Nieobsługiwane lub utracone zdarzenia nie zostają automatycznie odtworzone.

Jak sprawdzić konkretnie Pull-Point?

Wyłączenie opcji „Enable Webhooks” powoduje próbę użycia Pull-Point, pod warunkiem rzeczywistej obsługi tej usługi przez urządzenie. Test powinien obejmować faktyczne zmiany stanu oraz działanie po przerwie w połączeniu.

Lukas Wójcik

Lukas Wójcik

Systems architect and technology enthusiast specializing in scalable tracking solutions, GMP Stack (GA4 & GTM), and robust backend architectures. Advocate for clean code and privacy-first design.

Kontakt

Masz pytanie lub pomysł na projekt internetowy? Napisz krótko, o co chodzi. Formularz korzysta z reCAPTCHA i formconfirmed do ochrony przed spamem.

Napisanie komentarza

Doświadczenia z innymi kamerami, obiektywami lub rejestratorami oraz pytania o konfigurację są tu mile widziane.

Adres e-mail nie jest publikowany. Pola obowiązkowe oznaczono gwiazdką.

LUKASWOJCIK.COM · NEWSLETTER

Nowe pomysły w skrzynce

Nowe artykuły, praktyczne narzędzia i informacje o projektach.

Wybierz tematy (opcjonalnie)
Bez wyboru: wszystkie tematy.

Zapis wymaga potwierdzenia e-mailem. · Prywatność

Prywatność · Newsletter

Adres e-mail, język, wybrane tematy oraz daty zapisu i potwierdzenia są przechowywane w celu wysyłki newslettera. Wymagane jest potwierdzenie zapisu. Każda wiadomość zawiera link do natychmiastowej rezygnacji. Formconfirmed chroni formularz przed spamem. Brak śledzenia otwarć i kliknięć.

Pełna polityka prywatności ↗