Installieren von Plugins
Plugins sind optionale Zusatzmodule, die Agent DVR um zusätzliche Audio- und Videoverarbeitungsfunktionen erweitern, wie Barcodeerkennung, Wetter-Overlays und Audio-Filter.
Die einfachste Möglichkeit, Plugins zu installieren, ist über das Webportal zur Fernbedienung. Nachdem Sie verbunden sind, klicken Sie auf das Symbol oben rechts und navigieren Sie zu "Plugins" unter System. Dort können Sie das gewünschte Plugin aus dem Dropdown-Menü oben rechts auswählen und auf "Installieren" klicken, um zu beginnen.
Bevorzugen Sie eine manuelle Installation? Kein Problem! Sie können die Plugins aus dem Quellcode erstellen und dann die erstellte Ausgabe in Agent/Plugins/PLUGINNAME kopieren. Diese Methode gibt Ihnen mehr Kontrolle über den Installationsprozess.
Verfügbare Plugins
Agent DVR ist mit erweiterten Videoverarbeitungsfunktionen wie CodeProject AI-Integration ausgestattet, zusammen mit erweiterte Objektverfolgung, Audiererkennung und Zähldetektoren. Um Ihr Erlebnis weiter zu verbessern, bieten wir eine Reihe von Plugins an, die Sie in AgentDVR verwenden können, um seine Funktionalität zu erweitern.
Plugin-Liste
Strichcodes
Scannen Sie praktisch jeden Strichcode von einer Kamera (nur Windows).
Ausgelöste Ereignisse: Strichcode erkannt
Unterstützt: Video
Verstärkung
Wenden Sie Live-Bandfilter auf Audio von Audiogeräten an.
Ausgelöste Ereignisse: Keine
Unterstützt: Audio
Live-Verzögerung
Fügt eine Verzögerung zu Live-Audio und Live-Video hinzu (nützlich für Sportanalysen).
Ausgelöste Ereignisse: Keine
Unterstützt: Video, Audio
Wetter
Fügt eine Wetterstatusüberlagerung zum Live-Video basierend auf Ihrem Standort hinzu. Lösen Sie Ereignisse aus, wenn sich das Wetter ändert - z. B. wenn ein Sturm kommt oder wenn Windböen oder Temperaturgrenzen überschritten werden. Sie können das Layout und die Anzeigemodus der Wetterdaten von nur einem Symbol bis zur vollständigen Detailansicht anpassen.
Vollständige Informationen:
{icon}{main}: {description}
Wind: {wind} Böe: {gust}
Temp: {temp} Gefühlte Temperatur: {feelsLike}
Luftfeuchtigkeit: {humidity} UVI: {uvi}
Nur Symbol:
{icon}
Eine Zeile:
{main} {wind} {temp} {humidity} UVI: {uvi}
Ausgelöste Ereignisse: Hohe Temperatur, Böe, Status
Unterstützt: Video
Konfigurieren von Plug-ins
Bereit, die Leistung von Plugins zu nutzen? Fügen Sie einfach ein Gerät (Kamera und/oder Mikrofon) hinzu und öffnen Sie dessen Bearbeitungseinstellungen. Suchen Sie nach der Plugins-Registerkarte in der Dropdown-Liste oben rechts. Hier können Sie das gewünschte Plugin auswählen und auf die Schaltfläche "..." klicken, um es nach Ihren Anforderungen zu konfigurieren.
Einige Plugins lösen Ereignisse aus, denen Sie Aktionen zuweisen können. Das Weather-Plugin löst beispielsweise ein Gust-Ereignis aus, wenn die Windböen einen angegebenen Wert überschreiten (konfigurierbar im Plugin). Wenn Sie die Kamera bearbeiten und zur Registerkarte "Aktionen" navigieren, erhalten Sie Optionen, um darauf zu reagieren - beispielsweise einen Alarm auszulösen oder eine Aufnahme zu starten. Wählen Sie einfach den Plugin-Namen: Ereignis (z. B. Weather: Gust) im Feld "Wenn" aus und weisen Sie eine Aktion zu.
Erstellen Sie Ihr eigenes Plugin
Plugins sind dynamische Module, die Sie Agent DVR hinzufügen können, um seine Audio- und Videoverarbeitungsfunktionen zu erweitern. Mit Plugins können Sie Echtzeiteffekte und Überlagerungen anwenden, Ereignisse auslösen und Alarme in Agent DVR aktivieren, was erweiterte benutzerdefinierte Aktionen ermöglicht.
Um mit der Erstellung von Plugins für Agent DVR zu beginnen, klonen Sie zunächst unsere Open-Source-Plugins unter https://github.com/ispysoftware/AgentDVR-Plugins. Sie benötigen eine aktuelle Version von Visual Studio, um diese zu erstellen.
Wir empfehlen, mit dem Demo-Plugin als Grundlage zu beginnen. Stellen Sie sicher, dass die neueste Version von Agent installiert ist. Kopieren Sie nach der Erstellung des Demo-Plugins alle Dateien aus dem Ausgabeverzeichnis nach Agent\Plugins\Demo\. Starten Sie Agent DVR neu, bearbeiten Sie eine Kamera, und navigieren Sie zur Registerkarte Plugins. Aktivieren Sie das Plugin, wählen Sie Demo aus der Dropdown-Liste, und klicken Sie auf die Schaltfläche „...", um es zu konfigurieren.
Das Demo-Plugin ist vollständig plattformübergreifend kompatibel und zeigt die umfangreiche Funktionalität, die Sie mit Plugins aufbauen können. Es umfasst Live-Videoeffekte, grafische Überlagerungen, Live-Lautstärkeregelung und Integration mit dem Events-Subsystem von Agent DVR. Das Plugin-Menü bietet Einblicke in die Funktionsweise verschiedener Eingabesteuerelement.
Plugin-Hinweise für Entwickler:
Konfiguration: Agent DVR verwendet JSON und eine Klassendatei zur Speicherung von Einstellungen. Um Einstellungen zu konfigurieren, bearbeiten Sie die Datei config.cs.
Das Konfigurationsrendering von Agent DVR basiert auf .json-Dateien. Bearbeiten Sie config_en.json im json-Verzeichnis für die UI-Anzeige, wo Sie mehrere Abschnitte hinzufügen können, die als Registerkarten angezeigt werden. Die Schlüsselfelder „bindto" in json werden mit den Konfigurationsfeldern verknüpft. Agent DVR automatisiert das Steuerelemente-Rendering, die Speicherung von Einstellungen und Aktualisierungen.
Das Hinzufügen von "live": true zu json-Einträgen ermöglicht sofortige Aktualisierungen, ohne auf einen Klick der OK-Schaltfläche zu warten, was sich hervorragend für die Live-Optimierung eignet. Das Feld „converter" nutzt „PopulateResponse" in Utils.cs für die Wertformatierung.
Medienunterstützung: Wählen Sie aus, ob Sie „video", „audio" oder beides verarbeiten. Das Feld „Supports" in Main.cs kann hartcodiert werden.
Kontinuierliche Verarbeitung: Jeder Video- und Audio-Frame vom Gerät wird zur Analyse oder Verarbeitung an das Plugin gesendet, wie im Demo-Plugin demonstriert.
Bewegungs-/Alarm-Verarbeitung: Verarbeiten Sie Frames bei Bewegung oder Alarmen, indem Sie die Methode „ProcessEvent" im Demo-Plugin nutzen. Dies ermöglicht die Frame-Verarbeitung nur während dieser Ereignisse.
Benutzerdefinierte Ereignisse: Die Methode „GetCustomEvents" in Ihrem Plugin sollte eine Liste der benutzerdefinierten Ereignisse zurückgeben, die es erzeugt. Diese Ereignisse werden dann unter Aktionen in der Liste „Wenn" der Agent DVR-Benutzeroberfläche angezeigt. Lösen Sie diese Ereignisse mit einem „Result"-Element aus, das den Aktionsnamen und optional MSG, Tag, Dateiname und AIJSON angibt.
Alarm, Erkennung und Tag: Lösen Sie Alarme aus oder erkennen Sie Ereignisse, indem Sie ein Result mit dem eventName „alert" oder „detect" hinzufügen. Taggen Sie laufende Aufnahmen mit einem eventName „tag" und legen Sie die Tags nach Bedarf fest.
API-Aufrufe: Agent DVR initialisiert Plugins mit Geräteinformationen und dem Port des lokalen Servers, was für API-Befehle des Geräts nützlich ist. Die Eigenschaften AppDataPath und AppPath sind ebenfalls für Anzeigeorte oder Dateispeicherorte festgelegt.
Verteilung: Haben Sie ein cooles oder nützliches Plugin erstellt? Teilen Sie es mit uns und tragen Sie zur Community bei!