1. Wprowadzenie
Ten przewodnik przeprowadzi Cię przez proces integracji kamery SONOFF z Home Assistant za pomocą protokołu ONVIF . Dzięki tej konfiguracji będziesz mógł:
- Oglądaj wideo w czasie rzeczywistym w Home Assistant
- Odbieraj zdarzenia związane z wykrywaniem ruchu i osób
- Skonfiguruj automatyzację (np. wyzwalanie nagrywania po wykryciu ruchu)
Przed rozpoczęciem upewnij się, że oprogramowanie układowe urządzenia i wersja aplikacji spełniają wymagania obsługi ONVIF.
|
*W tym samouczku jako przykład wykorzystano kamerę SONOFF CAM-PT2.
2. Czego będziesz potrzebować
Aby ukończyć integrację, upewnij się, że masz następujące elementy:
Sprzęt i oprogramowanie
- Urządzenie z uruchomionym Home Assistant (np. Raspberry Pi 4+, PC lub Docker)
- Zarówno kamera, jak i Asystent Domowy znajdują się w tej samej sieci lokalnej
Informacje o koncie i dostęp
- Twoja kamera SONOFF została dodana do aplikacji eWeLink
- Funkcja ONVIF/RTSP włączona poprzez:
Ustawienia urządzenia → Więcej ustawień → ONVIF/RTSP
Zapisz następujące informacje:
- Adres IP kamery
- Port ONVIF
- Nazwa użytkownika i hasło (możliwość modyfikacji)
3. Połącz z Home Assistant
Krok 1: Zainstaluj integrację ONVIF
- Przejdź do głównego pulpitu Home Assistant.
- Przejdź do: Ustawienia → Urządzenia i usługi → Dodaj integrację
- Wyszukaj ONVIF i wybierz go
- Kliknij Prześlij
Krok 2: Dodaj kamerę
- Po wykryciu CAM-PT2 wybierz go i kliknij Prześlij
- Wprowadź nazwę użytkownika i hasło ONVIF
- Kliknij Pomiń i Zakończ
Teraz zobaczysz swoją kamerę na pulpicie Home Assistant w zakładce Przegląd .
4. Co możesz zrobić
4.1 Przesyłanie strumieniowe w czasie rzeczywistym
- Oglądaj transmisję wideo na żywo bezpośrednio w Home Assistant
- Włącz/wyłącz dźwięk
4.2 Stan wykrywania ruchu i obecności człowieka
- Wykrywanie ruchu/osób jako wyzwalaczy automatyki
4.3 Sterowanie PTZ
- Utwórz nowy pulpit nawigacyjny
- Edytuj pulpit nawigacyjny
- Utwórz nową sekcję
- W panelu „ Według jednostki ” zaznacz pola wyboru czujników wykrywania ruchu/osób kamery oraz jednostki strumienia
MainStream
. Następnie kliknij „ Dodaj do pulpitu ”, aby uwzględnić je w układzie.
- W nowo utworzonej sekcji kliknij ikonę edycji (⋮) w prawym górnym rogu i wybierz z menu opcję „ Edytuj w YAML ”.
- Zidentyfikuj tekst po lewej stronie „_mainstream”. Ten tekst reprezentuje nazwę Twojej kamery. Na przykład, jeśli ciąg znaków kamery to „cam_pt2_test_mainstream”, to nazwa kamery to „cam_pt2_test”.
type: grid
square: false
columns: 1
cards:
- type: entities
entities:
- binary_sensor.<camera_name>_cell_motion_detection
- binary_sensor.<camera_name>_motion_alarm
- binary_sensor.<camera_name>_person_detection
- type: picture-glance
entities:
- entity: camera.<camera_name>_mainstream
tap_action:
action: call-service
service: onvif.ptz
service_data:
entity_id: camera.<camera_name>_mainstream
pan: LEFT
speed: 1
distance: 0.3
move_mode: ContinuousMove
name: Pan Left
show_state: false
icon: mdi:arrow-left
show_icon: true
- entity: camera.<camera_name>_mainstream
tap_action:
action: call-service
service: onvif.ptz
service_data:
entity_id: camera.<camera_name>_mainstream
tilt: UP
speed: 1
distance: 0.3
move_mode: ContinuousMove
name: Tilt Up
icon: mdi:arrow-up
- entity: camera.<camera_name>_mainstream
tap_action:
action: call-service
service: onvif.ptz
service_data:
entity_id: camera.<camera_name>_mainstream
tilt: DOWN
speed: 1
distance: 0.3
move_mode: ContinuousMove
name: Tilt Down
icon: mdi:arrow-down
- entity: camera.<camera_name>_mainstream
tap_action:
action: call-service
service: onvif.ptz
service_data:
entity_id: camera.<camera_name>_mainstream
pan: RIGHT
speed: 1
distance: 0.3
move_mode: ContinuousMove
name: Pan Right
icon: mdi:arrow-right
show_icon: true
camera_image: camera.<camera_name>_mainstream
camera_view: live
Na przykład:
type: grid
square: false
columns: 1
cards:
- type: entities
entities:
- binary_sensor.cam_pt2_test_cell_motion_detection
- binary_sensor.cam_pt2_test_motion_alarm
- binary_sensor.cam_pt2_test_person_detection
- type: picture-glance
entities:
- entity: camera.cam_pt2_test_mainstream
tap_action:
action: call-service
service: onvif.ptz
service_data:
entity_id: camera.cam_pt2_test_mainstream
pan: LEFT
speed: 1
distance: 0.3
move_mode: ContinuousMove
name: Pan Left
show_state: false
icon: mdi:arrow-left
show_icon: true
- entity: camera.cam_pt2_test_mainstream
tap_action:
action: call-service
service: onvif.ptz
service_data:
entity_id: camera.cam_pt2_test_mainstream
tilt: UP
speed: 1
distance: 0.3
move_mode: ContinuousMove
name: Tilt Up
icon: mdi:arrow-up
- entity: camera.cam_pt2_test_mainstream
tap_action:
action: call-service
service: onvif.ptz
service_data:
entity_id: camera.cam_pt2_test_mainstream
tilt: DOWN
speed: 1
distance: 0.3
move_mode: ContinuousMove
name: Tilt Down
icon: mdi:arrow-down
- entity: camera.cam_pt2_test_mainstream
tap_action:
action: call-service
service: onvif.ptz
service_data:
entity_id: camera.cam_pt2_test_mainstream
pan: RIGHT
speed: 1
distance: 0.3
move_mode: ContinuousMove
name: Pan Right
icon: mdi:arrow-right
show_icon: true
camera_image: camera.cam_pt2_test_mainstream
camera_view: live
- Po wymianie Wpisz nazwę swojego aparatu i zastąp oryginalny kod zmodyfikowaną wersją. Następnie kliknij ZAPISZ i GOTOWE, aby zastosować zmiany.
- W tym momencie możesz zobaczyć obraz na żywo z kamery oraz przyciski sterowania PTZ. Za pomocą tych przycisków możesz obracać kamerę w górę, w dół, w lewo i w prawo.
4.4 Automatyzacje
Twórz automatyzacje, wykorzystując zdarzenia kamery jako wyzwalacze. Przykład:
W przypadku wykrycia ruchu:
- Przejdź do Informacji o urządzeniu → + Dodaj automatyzację → Użyj urządzenia jako wyzwalacza
- Wybierz „Rozpoczęto wykrywanie ruchu”
- Wybierz akcję:
Kamera → Nagrywanie , ustaw ścieżkę do pliku w następujący sposób:
/media/{{ now().strftime('%Y%m%d-%H%M%S') }}.mp4
- Konfiguruj czas trwania i przegląd wsteczny
- Kliknij Zapisz
Nagrania znajdziesz w zakładce Media → Moje multimedia .
5. Przegląd funkcji
Kamera SONOFF obsługuje standardy ONVIF i RTSP, co umożliwia łatwą integrację z Home Assistant. Aby ułatwić Ci zrozumienie różnic, poniżej znajduje się krótki przegląd funkcji.
CAM-PT2
Funkcja |
ONVIF |
RTSP |
Wykrywanie urządzeń |
√ |
× |
Podgląd na żywo |
√ |
√ |
Sterowanie PTZ |
√ Wymagana jest ręczna konfiguracja za pomocą skryptu. |
× |
Powiadomienie o zdarzeniu |
√ Automatyzacja wyzwalaczy (ruch, człowiek) |
× |
KAMKA-S2
Funkcja |
ONVIF |
RTSP |
Wykrywanie urządzeń |
√ |
× |
Podgląd na żywo |
√ |
√ |
Powiadomienie o zdarzeniu |
√ Automatyzacja wyzwalaczy (ruch, człowiek) |
× |