Agent DVR: Wtyczki

Instalowanie Wtyczek

Wtyczki to opcjonalne moduły dodatkowe, które rozszerzają Agent DVR o dodatkowe funkcje przetwarzania audio i wideo, takie jak skanowanie kodów kreskowych, nakładki pogodowe i filtry audio.

Najłatwiejszy sposób zainstalowania wtyczek to portal internetowy zdalny. Po połączeniu kliknij ikonę Serwera w górze, prawo i przejdź do wtyczki „Wtyczki" w sekcji System. Tutaj możesz wybrać wtyczkę, którą chcesz użyć, z menu rozwijanego w górze, prawo i kliknij „Instaluj", aby rozpocząć.

Wolisz instalować ręcznie? Żaden problem! Możesz zbudować wtyczki ze źródła , a następnie skopiować zbudowane dane wyjściowe do Agent/Plugins/PLUGINNAME. Ta metoda daje ci większą kontrolę nad procesem instalacji.

Dostępne wtyczki

Agent DVR zawiera zaawansowane funkcje przetwarzania wideo, takie jak integracja CodeProject AI, wraz z zaawansowanym śledzeniem obiektów, rozpoznawaniem audio i detektorami liczącymi. Aby jeszcze bardziej ulepszyć twoje doświadczenie, oferujemy szereg wtyczek, które możesz używać w AgentDVR, aby rozszerzyć jej funkcjonalność.

Lista wtyczek

Kody kreskowe

Skanuj praktycznie dowolny kod kreskowy z kamery (tylko Windows).

Wznowione zdarzenia: Kod kreskowy rozpoznany
Obsługuje: Wideo

zrzut ekranu

Wzmocnienie

Zastosuj filtry pasma na żywo na dźwięk pochodzący z urządzeń audio.

Wznowione zdarzenia: Brak
Obsługuje: Audio

zrzut ekranu

Opóźnienie na żywo

Dodaje opóźnienie do audio i wideo na żywo (przydatne do analizy sportowej).

Wznowione zdarzenia: Brak
Obsługuje: Wideo, Audio

zrzut ekranu

Pogoda

Dodaje nakładkę stanu pogody do wideo na żywo na podstawie Twojej lokalizacji. Wznawia zdarzenia, jeśli pogoda się zmieni - na przykład, jeśli zbliża się burza lub jeśli przekroczone są limity porywów wiatru lub temperatury. Możesz dostosować układ i tryb wyświetlania danych pogodowych, od samej ikony do pełnych szczegółów.

Konfiguracja pogody przyjmuje ciąg znaków formatu do układania informacji. Oto kilka przykładowych ciągów znaków formatu, które możesz użyć:

Pełne informacje:

{icon}{main}: {description} 
 Wiatr: {wind} Poryw: {gust} 
 Temp: {temp} Temperatura odczuwalna: {feelsLike} 
 Wilgotność: {humidity} UVI: {uvi}

Tylko ikona:

{icon}

Jeden wiersz:

{main} {wind} {temp} {humidity} UVI: {uvi}

Wznowione zdarzenia: Wysoka temperatura, Poryw, Status
Obsługuje: Wideo

zrzut ekranu
Jeśli używasz wtyczki audio, takiej jak Listen na kamerze, będziesz musiał edytować kamerę, wybrać kartę Audio i kliknąć, aby skonfigurować mikrofon. Stamtąd możesz uzyskać dostęp do karty Wtyczki dla urządzeń audio. Alternatywnie możesz kliknąć ikonę Serwera, wybrać Edytuj urządzenia i edytować mikrofon z tej listy.

Konfigurowanie Wtyczek

Gotowy, aby wykorzystać moc wtyczek? Po prostu dodaj urządzenie (kamerę i/lub mikrofon) i przejdź do jego ustawień edycji. Wyszukaj kartę Wtyczki w menu rozwijanym w górze, prawo. Tutaj możesz wybrać żądaną wtyczkę i kliknij przycisk "...", aby ją skonfigurować do swoich potrzeb.

Niektóre wtyczki zgłaszają zdarzenia, do których możesz dołączyć akcje. Na przykład wtyczka Pogoda zgłasza zdarzenie Poryw, gdy prędkość wiatru przekroczy określoną wartość (konfigurowalną w wtyczce). Edytowanie kamery i przejście do karty Akcje daje ti opcje reagowania na to - uruchomienie alarmu lub rozpoczęcie nagrywania na przykład. Po prostu wybierz nazwę wtyczki: zdarzenie (np. Pogoda: Poryw) w polu wyboru Jeśli i przypisz akcję.

Utwórz własną wtyczkę

Wtyczki to moduły dynamiczne, które możesz dodać do Agent DVR, aby ulepszyć jego możliwości przetwarzania audio i wideo. Dzięki wtyczkom możesz zastosować efekty w czasie rzeczywistym, nakładki, podnieść zdarzenia i wyzwolić alerty w Agent DVR, umożliwiając zaawansowane niestandardowe akcje.

Aby rozpocząć tworzenie wtyczek dla Agent DVR, zacznij od sklonowania naszych wtyczek o otwartym kodzie źródłowym pod adresem https://github.com/ispysoftware/AgentDVR-Plugins. Będziesz potrzebować najnowszej wersji Visual Studio, aby je skompilować.

Zalecamy rozpoczęcie od wtyczki demonstracyjnej jako podstawy. Upewnij się, że masz zainstalowaną najnowszą wersję Agent. Po skompilowaniu wtyczki demonstracyjnej skopiuj wszystkie pliki z folderu wyjściowego do Agent\Plugins\Demo\. Restartuj Agent DVR, edytuj kamerę i przejdź do karty Wtyczki. Włącz wtyczkę, wybierz Demo z listy rozwijanej i kliknij przycisk "...", aby ją skonfigurować.

Wtyczka Demo jest w pełni kompatybilna między platformami i pokazuje rozbudowaną funkcjonalność, którą możesz zbudować za pomocą wtyczek. Obejmuje efekty wideo na żywo, nakładki graficzne, kontrolę głośności na żywo i integrację z podsystemem zdarzeń Agent DVR. Menu wtyczki daje wgląd w to, jak działają różne kontrolki wejściowe.

Uwagi dotyczące wtyczek dla programistów:

Konfiguracja: Agent DVR używa JSON i pliku klasy do przechowywania ustawień. Aby konfigurować ustawienia, edytuj plik config.cs.

Renderowanie konfiguracji Agent DVR opiera się na plikach .json. Edytuj config_en.json w katalogu json dla wyświetlania interfejsu użytkownika, gdzie możesz dodać wiele sekcji renderowanych jako karty. Pola klucza 'bindto' w json łączą się z polami konfiguracji. Agent DVR automatyzuje renderowanie sterowania, przechowywanie ustawień i aktualizacje.

Dodanie "live": true do wpisów json umożliwia natychmiastowe aktualizacje bez czekania na kliknięcie przycisku OK, co jest świetne do strojenia na żywo. Pole 'converter' wykorzystuje 'PopulateResponse' w Utils.cs do formatowania wartości.

Obsługa mediów: Wybierz opcję przetwarzania "wideo", "audio" lub obu. Pole 'Supports' w Main.cs może być zakodowane na stałe.

Przetwarzanie ciągłe: Każda ramka wideo i audio z urządzenia jest wysyłana do wtyczki w celu analizy lub przetworzenia, jak pokazano w demonstracji.

Przetwarzanie ruchu/alertów: Przetwarzaj ramki przy ruchu lub alertach, korzystając z metody 'ProcessEvent' w wtyczce demonstracyjnej. Umożliwia to przetwarzanie ramek tylko podczas tych zdarzeń.

Zdarzenia niestandardowe: Metoda 'GetCustomEvents' w twojej wtyczce powinna zwracać listę niestandardowych zdarzeń, które generuje. Te zdarzenia pojawią się następnie w sekcji Akcje na liście 'Jeśli' w interfejsie Agent DVR. Wyzwalaj te zdarzenia za pomocą elementu 'Wynik', określając nazwę akcji i opcjonalnie MSG, Tag, Nazwę pliku i AIJSON.

Alerty, wykrywanie i tagi: Podnieś alerty lub wykryj zdarzenia, dodając wynik z "alert" lub "detect" eventName. Oznacz bieżące nagrania za pomocą 'tag' eventName i ustaw tagi zgodnie z potrzebami.

Wywołania API: Agent DVR inicjalizuje wtyczki z informacjami o urządzeniu i portem serwera lokalnego, przydatnymi do poleceń API dla urządzenia. Właściwości AppDataPath i AppPath są również ustawiane dla lokalizacji wyświetlania lub zapisywania plików.

Dystrybucja: Stworzyłeś fajną lub przydatną wtyczkę? Podziel się nią z nami i wnieś wkład w społeczność!