Przewodnik użytkownika: Agent DVR Wtyczki

Instalowanie wtyczek

Najłatwiejszym sposobem instalacji wtyczek jest korzystanie z zdalnego portalu internetowego. Po połączeniu kliknij ikonę Serwera w lewym górnym rogu i przejdź do 'Wtyczki' w sekcji System. Tutaj możesz wybrać wtyczkę, którą chcesz użyć z menu rozwijanego w prawym górnym rogu i kliknąć 'Zainstaluj', aby rozpocząć.

Wolisz zainstalować ręcznie? Bez problemu! Możesz skompilować wtyczki ze źródeł , a następnie skopiować skompilowany wynik do Agent/Plugins/PLUGINNAME. Ta metoda daje Ci większą kontrolę nad procesem instalacji.

Dostępne Wtyczki

Agent DVR jest wyposażony w zaawansowane funkcje przetwarzania wideo, takie jak integracja z CodeProject AI, a także zaawansowane śledzenie obiektów, rozpoznawanie dźwięku i detektory liczenia. Aby dalej ulepszyć swoje doświadczenie, oferujemy szereg wtyczek, które możesz używać w AgentDVR, aby rozszerzyć jego funkcjonalność.

Lista wtyczek

Kody kreskowe
Skanuj praktycznie każdy kod kreskowy z kamery (tylko Windows).

Wywołane zdarzenia: Rozpoznany kod kreskowy
Obsługuje: Wideo

zrzut ekranu
Wzmocnienie
Zastosuj żywe filtry pasmowe na dźwięk pochodzący z urządzeń audio.

Wywołane zdarzenia: Brak
Obsługuje: Audio

zrzut ekranu
Opóźnienie na żywo
Dodaje opóźnienie do dźwięku i wideo na żywo (przydatne do analizy sportowej).

Wywołane zdarzenia: Brak
Obsługuje: Wideo, Audio

zrzut ekranu
Pogoda
Dodaje nakładkę ze stanem pogody do wideo na żywo na podstawie Twojej lokalizacji. Wywołuje zdarzenia, jeśli pogoda się zmienia - na przykład gdy nadchodzi burza lub gdy podmuchy wiatru lub limity temperatury są przekroczone. Możesz dostosować układ i tryb wyświetlania danych pogodowych od samej ikony do pełnych szczegółów.
Konfiguracja pogody przyjmuje ciąg formatujący do układu informacji. Oto kilka przykładowych ciągów formatujących, które możesz użyć:

Pełne informacje:

{icon}{main}: {description} 
 Wiatr: {wind} Podmuch: {gust} 
 Temp: {temp} Odczuwalna temp: {feelsLike} 
 Wilgotność: {humidity} UVI: {uvi}

Tylko ikona:

{icon}

Jedna linia:

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

Wywołane zdarzenia: Wysoka temp., Podmuch, Status
Obsługuje: Wideo

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

Konfigurowanie wtyczek

Gotowy do wykorzystania mocy wtyczek? Po prostu dodaj urządzenie (kamerę i/lub mikrofon) i przejdź do jego ustawień edycji. Znajdź zakładkę Wtyczki w rozwijanym menu w prawym górnym rogu. Tutaj możesz wybrać żądaną wtyczkę i kliknąć przycisk "..." aby ją skonfigurować według swoich potrzeb.

Niektóre wtyczki generują zdarzenia, do których możesz przypisać akcje. Na przykład wtyczka Pogoda generuje zdarzenie Poryw, gdy porywiste wiatry przekroczą określoną wartość (konfigurowalną w wtyczce). Edytując kamerę i przechodząc do zakładki Akcje, masz możliwość odpowiedniego reagowania na to zdarzenie - na przykład uruchomienie alarmu lub rozpoczęcie nagrywania. Po prostu wybierz nazwę wtyczki: zdarzenie - np. Pogoda: Poryw w polu Jeśli i przypisz akcję.

Utwórz własny dodatek.

Wtyczki to dynamiczne moduły, które można dodać do Agent w celu zwiększenia jego możliwości przetwarzania audio i wideo. Dzięki wtyczkom można stosować efekty w czasie rzeczywistym, nakładki, wywoływać zdarzenia i wyzwalacze alarmów w Agent, umożliwiając zaawansowane działania niestandardowe.

Aby zacząć tworzyć wtyczki dla Agent DVR, powinny być one rozwijane jako projekty .Net Standard 2.0, kompatybilne ze wszystkimi platformami. Zacznij od sklonowania naszych wtyczek typu open-source pod adresem https://github.com/ispysoftware/AgentDVR-Plugins. Będziesz potrzebować najnowszej wersji Visual Studio do ich budowania.

Zalecamy rozpoczęcie od wtyczki demonstracyjnej jako bazy. Upewnij się, że masz zainstalowaną najnowszą wersję Agent. Po zbudowaniu wtyczki demonstracyjnej, skopiuj wszystkie pliki z Demo\bin\Debug\netstandard2.0 do Agent\Plugins\Demo\. Uruchom ponownie Agent, 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 z wieloma platformami i prezentuje rozległe funkcjonalności, które można zbudować za pomocą wtyczek. Zawiera efekty wideo na żywo, nakładki graficzne, kontrolę głośności na żywo oraz integrację z podsystemem Zdarzeń Agent. Menu wtyczki zapewnia wgląd w to, jak działają różne elementy wejściowe.

Notatki dotyczące wtyczek dla programistów:

Konfiguracja: Agent łączy XML, XSD i JSON do przechowywania i renderowania ustawień. Aby edytować plik config.xsd, użyj Edytora XML (Tekstowego) Visual Studio z kodowaniem. Po dodaniu niezbędnych pól, wygeneruj plik klasy C# za pomocą polecenia C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.8 Tools\xsd.exe /c config.xsd w katalogu pliku xsd.

Renderowanie konfiguracji Agenta i aktualizacje XML opierają się na plikach .json. Edytuj plik config_en.json w katalogu json dla wyświetlania interfejsu użytkownika, gdzie można dodać wiele sekcji renderowanych jako karty. Klucze 'bindto' w json łączą się z polami XML konfiguracji. Agent automatyzuje renderowanie kontroli, przechowywanie ustawień i aktualizacje.

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

Obsługa Mediów: Wybierz przetwarzanie "wideo", "audio" lub obu. Pole 'Supports' w Main.cs może być wpisane na stałe.

Ciągłe Przetwarzanie: Każda klatka wideo i audio z urządzenia jest przesyłana do wtyczki w celu analizy lub przetwarzania, jak pokazano w wtyczce demonstracyjnej.

Przetwarzanie Ruchu/Alarmów: Przetwarzaj klatki podczas ruchu lub alarmów, wykorzystując metodę 'ProcessEvent' w wtyczce demonstracyjnej. Pozwala to na przetwarzanie klatek 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 Akcjach w liście 'Jeśli' interfejsu Agenta. Wywołaj te zdarzenia za pomocą elementu 'Result', określając nazwę działania oraz opcjonalne MSG, Tag, Filename i AIJSON.

Alarm, Wykrywanie i Tagowanie: Wyzwalaj alarmy lub wykrywaj zdarzenia, dodając Result z nazwą zdarzenia "alert" lub "detect". Oznaczaj trwające nagrania za pomocą zdarzenia 'tag' i ustawiaj Tagi według potrzeb.

Wywołania API: Agent inicjuje wtyczki informacjami o urządzeniu i porcie serwera lokalnego, co jest przydatne do poleceń API dla urządzenia. Właściwości AppDataPath i AppPath są również ustawione do wyświetlania lub zapisywania plików.

Dystrybucja: Stworzyłeś/-aś fajną lub użyteczną wtyczkę? Podziel się nią z nami i przyczynij się do społeczności!

Agent DVR Przewodnik użytkownika
Filtr zastosowany