Konfiguration: Aktionen

Über

Aktionen in Agent DVR sind Reaktionen auf spezifische Ereignisse, wie Kamera-/KI-Alarme oder Gerätetrennungen. Verwenden Sie sie, um automatisch zu reagieren, beispielsweise einen Alarm auszulösen, Lichter über eine intelligente Steckdose zu aktivieren oder die Aufnahme auf einer anderen Kamera auszulösen. Um auf Aktionen zuzugreifen und sie zu konfigurieren, bearbeiten Sie ein Gerät und navigieren Sie zum Abschnitt Aktionen im Menü.

Klicken Sie auf "Hinzufügen", um eine neue Aktion zu erstellen. Ihnen wird ein Konfigurationsbildschirm ähnlich den folgenden Bildern angezeigt:

KI-Aktionen-Schnittstelle
KI-Aufgaben-Schnittstelle

Es gibt eine breite Palette von Ereignissen, die Aktionen auslösen können. Mehrere Aktionen können jedem Ereignis zugeordnet werden, und Sie können verschiedene Tags in diesen Aktionen verwenden, um dynamische Reaktionen zu erstellen.

Konfigurieren einer Aktion

  • Aktiv: Schalten Sie dies um, um die Aktion zu aktivieren oder zu deaktivieren. Alternativ können Sie den Zeitplan und die API mit Befehlen wie actionOn, actionOff und actionRun verwenden, wobei Sie die oben angezeigte ID nutzen.
  • Name: Ein optionaler Name für die Aktion.
  • Wenn: Wählen Sie ein verfügbares Ereignis (siehe unten).
  • Mit Tag: (KI-Ereignisse). Dies wird hauptsächlich mit KI-Ereignissen verwendet. Wenn Sie beispielsweise KI: Objekt gefunden auswählen und hier Katze eingeben, wird die Aktion nur ausgelöst, wenn eine Katze erkannt wird. Beachten Sie, dass der Tag-Abgleich auf der in den Server-Einstellungen - Allgemein ausgewählten Sprache basiert.
  • Regel: Wählen Sie, ob mehrere Tags alle übereinstimmen müssen (UND) oder eines zutreffen kann (ODER).
  • In Zonen: (KI-Ereignisse). Geben Sie Bewegungszonen (auf der Registerkarte "Bewegungserkennung") an, um die erkannten Objekte zu filtern. Wenn Sie beispielsweise Zone 1 und Katze als Tag auswählen, wird die Aktion nur ausgelöst, wenn eine Katze in Zone 1 erkannt wird. Lassen Sie das Feld leer, um alle Zonen einzubeziehen.
  • Wiederholungs-Timeout: Dies unterdrückt das Ereignis, wenn es in diesem Intervall ausgelöst wurde, und setzt den Timer auch zurück. Bei "Fahrzeug erkannt" als Auslöser und einem Timeout von 30 Sekunden wird beispielsweise eine Benachrichtigung einmal gesendet, wobei nachfolgende Benachrichtigungen angehalten werden, bis es eine 30-sekündige Lücke im erkannten Verkehr gibt.
  • Aufgabe hinzufügen: Klicken Sie, um eine Aufgabe hinzuzufügen. Sie können einer Aktion mehrere Aufgaben zuweisen (v4.5.5.0+).

Verfügbare Aktionen

Aktionen können auf eine Vielzahl von System-, Geräte- und KI-Ereignissen reagieren. Die Ereignisse, für die Sie Aktionen einrichten können, sind:

  • KI-Server offline (Der KI-Server hat einen Fehler zurückgegeben - das Ereignis wird ausgelöst, nachdem Anfragen 3-mal fehlgeschlagen sind, und tritt erst wieder auf, wenn der Server wieder online ist)
  • KI-Server aktiv (Der KI-Server hat den Fehlerzustand verlassen)
  • KI: Ask AI Positives Ergebnis (Es wurde ein gesuchtes Objekt gefunden)
  • KI: Ask AI Ergebnis (wird bei jeder Ask AI-Antwort ausgelöst, egal ob positiv oder nicht)
  • KI: Beschreibungsantwort erhalten (Ein Bild wurde von der KI beschrieben - die Beschreibung befindet sich in den {MESSAGE} und {AIJSON} Tags)
  • KI: Gesicht erkannt
  • KI: Gesicht nicht erkannt
  • KI: Kennzeichen erkannt
  • KI: Kennzeichen nicht erkannt
  • KI: Herumlungern erkannt
  • KI: Objekt gefunden
  • KI: Objekt nicht gefunden
  • KI: Ton erkannt (nur Mikrofone)
  • Alarm
  • Alarm beendet
  • URL-Aufruf: Antwort erhalten - Dies wird durch die Antwort ausgelöst, die Sie erhalten, wenn eine Aufgabe "URL aufrufen" ausgeführt wird. So können Sie darauf mit anderen Aufgaben reagieren.
  • Manueller Alarm
  • Bewegung erkannt
  • Bewegung beendet
  • Keine - verwenden Sie diese Option, wenn Sie die Aktion selbst mit dem Befehl "Aktion: Ausführen" im Zeitplan auslösen möchten
  • ONVIF-Ereignis EIN - verwenden Sie diese Option beispielsweise, um die Aufnahme basierend auf ONVIF-Statusaktualisierungen zu starten und zu stoppen (erfordert, dass der Bewegungserkennungstyp auf ONVIF eingestellt ist)
  • ONVIF-Ereignis AUS
  • ONVIF-Ereignis empfangen (wird bei jedem ONVIF-Ereignis von der Kamera ausgelöst)
  • Foto aufgenommen
  • PTZ-Preset angewendet
  • Wiederverbindung fehlgeschlagen
  • Aufnahme fehlgeschlagen
  • Aufnahme beendet
  • Aufnahme gestartet
  • Quelle getrennt
  • Quelle wieder verbunden
  • Quelle abgedeckt/manipuliert
  • Gerät ausschalten
  • Gerät einschalten
  • System: Bewaffnet
  • System: Entwaffnet
  • System: Keine UI verbunden - wenn die letzte UI-Sitzung geschlossen wird
  • System: Profil angewendet
  • System: UI verbunden - wenn jemand einen Browser öffnet, um Ihr System anzuzeigen
  • System: UI getrennt - wenn die Sitzung beendet wird (geschieht etwa eine Minute, nachdem der Browser getrennt wird)
  • Zeitraffer gestartet
  • Zeitraffer gestoppt

Alle Plugin-Ereignisse und benutzerdefinierten Aufgaben, die Sie hinzugefügt haben, werden ebenfalls am Ende dieser Liste angezeigt.

Erkennung von Herumlungern

Um das Herumlungern zu erkennen (Personen oder Objekte, die sich für einen bestimmten Zeitraum an einer Stelle aufhalten), müssen Sie Folgendes konfigurieren:

  • Richten Sie einen KI-Server in den Server-Einstellungen ein
  • Fügen Sie eine Aktion für KI: Herumlungern erkannt hinzu
  • Legen Sie das Tag fest, das Sie suchen - normalerweise wäre dies Person, aber Sie könnten auch Auto verwenden, um Autos zu erkennen, die zu lange in einem Bereich geparkt sind, oder Koffer für verlorenes Gepäck oder eine Katze, die auf Ihrem Sofa sitzt. Sie können hier mehrere Tags verwenden, beispielsweise Auto,Bus,LKW. Eine Liste der verfügbaren Objekte zum Suchen finden Sie in der Klassenliste in der Objekterkennung, wenn Sie die Kamera bearbeiten.
  • Geben Sie die Zonen an, in denen Sie nach dem Objekt suchen möchten. Verwenden Sie die Reiter Detektor, um Bewegungszonen zu zeichnen.
  • Geben Sie die Anzahl der Sekunden an, für die Sie tolerieren, dass sich das erkannte Objekt in der Zone befindet.
  • Fügen Sie Aufgaben hinzu, die ausgeführt werden sollen, wenn die Bedingungen erfüllt sind.

Hinweis: Der Herumlungern-Detektor verwendet die Einstellungen aus den Objekterkennungseinstellungen wie Ecken prüfen und Überlagerung

Benutzerdefinierte Ereignisse hinzufügen

Über die voreingestellten Ereignisse hinaus können Sie benutzerdefinierte Ereignisse erstellen, indem Sie Aufgaben hinzufügen. Sobald eine Aufgabe erstellt ist, wird sie in der Ereignisse-Liste angezeigt. Sie können dann eine Aktion einrichten, um auf diese Aufgabe zu reagieren. Aufgaben können von der Live-Seite in der Benutzeroberfläche ausgelöst werden (durch Auswahl einer Kamera und anschließendes Klicken auf das Aufgaben-Symbol unten links) oder über den Aktion: AUSFÜHREN-Befehl im Zeitplan.

Benutzerdefinierte Aufgaben

Aufgaben sind Befehle, die Sie an Geräte anhängen können, um manuell Aktionen auszulösen. Aktionen können APIs von Drittanbietern aufrufen, um Aufgaben wie das Öffnen von Türen, das Einschalten von Lichtern, das Abspielen von Sounds usw. auszuführen. Um Aufgaben hinzuzufügen, zu löschen und auszuführen, wählen Sie ein Gerät auf der Live-Seite aus und klicken Sie auf das Aufgabensymbol .

Aufgabe einrichten:

  • Geben Sie einen Text ein, um die Aufgabe zu beschreiben, z. B. "Lichter einschalten", und klicken Sie auf die Schaltfläche +. Klicken Sie auf OK
  • Klicken Sie, um das Gerät mithilfe des Bearbeitungssymbols zu bearbeiten. Wählen Sie das Register "Aktionen" im Editor über das Menü oben rechts aus.
  • Fügen Sie eine Aktion hinzu. Wählen Sie die Bedingung "Wenn" als die gerade erstellte Aufgabe aus (Aufgaben werden am Ende der Liste der verfügbaren Aktionen angezeigt) und konfigurieren Sie dann, was die Aufgabe tun soll.
  • Klicken Sie auf OK
  • Sie können diese Aktion jetzt aus der Live-Ansicht auslösen, indem Sie auf die Schaltfläche "Aufgaben" klicken und den Pfeil "Ausführen" neben der Aufgabe klicken.

Sie können Aufgaben auch über die Agent DVR-API auslösen.

Verfügbare Aufgaben

Aufgaben sind das, was eine Aktion ausführt, wenn das dazugehörige Ereignis ausgelöst wird - vom Versenden einer E-Mail-Benachrichtigung oder Push-Benachrichtigung bis zur Steuerung der Aufnahme auf anderen Geräten. Die Liste der verfügbaren Aufgaben, die Sie durchführen können (unter Dann), umfasst:

  • Alarm - löst einen Alarm auf dem Gerät aus
  • Piepton - spielt einen Piepton über den Lautsprecher des Agent DVR-Computers ab
  • URL aufrufen - ruft jede beliebige URL mit einem optionalen Authentifizierungstoken auf. Sie können hier die Agent DVR API aufrufen oder Benachrichtigungen an Discord, Slack, ntfy und ähnliche Dienste senden (siehe Webhooks). Wenn Sie API schützen in den Server-Einstellungen aktiviert haben, müssen Sie einen Autorisierungs-Header angeben. Dazu müssen Sie ein Benutzerkonto über Server-Einstellungen hinzufügen und einen Basic Auth Header-Wert eingeben:
BASIC YWRtaW46YWRtaW4=
  • Befehl ausführen
Siehe auch Befehle
Um Ihre eigenen Befehle/Skripte hinzuzufügen, können Sie .bat- oder .sh-Dateien in das Verzeichnis Befehle einfügen. Sie können dann Parameter an die Batch-Datei übergeben. Um beispielsweise alle Fotos auf das Stammverzeichnis des D-Laufwerks zu kopieren:

Erstellen Sie eine einfache Textdatei mit folgendem Inhalt:

copy %1 D:\

Speichern Sie sie als copyPhoto.bat (unter Linux als .sh - Sie müssen diese Datei ausführbar machen mit chmod +x) in Agent/Commands
Fügen Sie dann eine Aktion hinzu:
wenn: "Foto aufgenommen"
dann: "Befehl ausführen"
Datei: copyPhoto
Parameter: "{FILENAME}"

  • Aktuelle Aufnahme in die Cloud hochladen - lädt die aktuelle Aufnahme zum Cloud-Anbieter des Geräts hoch
  • Verzögerung - Pausierung vor Ausführung der nächsten Aufgabe
  • Ask AI aktivieren / deaktivieren
  • Gesichtserkennung aktivieren / deaktivieren
  • LPR aktivieren / deaktivieren
  • Objekterkennung aktivieren / deaktivieren
  • Patrouille aktivieren / deaktivieren (PTZ-Patrouille auf einem Gerät)
  • Tonerkennung aktivieren / deaktivieren
  • Aktuelle Aufnahme per FTP hochladen - lädt die aktuelle Aufnahme zum FTP-Server des Geräts hoch
  • Protokoll - schreibt eine Nachricht in das Agent DVR-Protokoll
  • MQTT - sendet eine MQTT-Nachricht
  • MQTT-Bild - sendet ein Raw-Livebild in JPEG-Bytes an ein Thema
  • Netzwerkbenachrichtigung
  • PTZ-Befehl - bewegt die Kamera zu einer Voreinstellung oder führt einen PTZ-Befehl aus
  • E-Mail senden (mit optionalen Bildanhängen)
  • E-Mail mit Video senden (Dauer angeben - dies beinhaltet einen Puffer des Ereignisses). v4.9.8.0+
  • Push-Benachrichtigung senden
  • SMS senden
  • Bewegungserkennungsbereich festlegen (wählen Sie den Bereich, den Sie auf dem Detektor definiert haben)
  • Nachricht anzeigen - zeigt eine Nachricht in angesehenen Webbrowsern an
  • Ton (auf Agent DVR-Computer)
  • Ton (über Kamera)
  • Ton (über Webbrowser)
Aufgrund von Browsersicherheit erfordert dies eine Interaktion mit der Webseite (z. B. Klicken auf etwas). Um dies in Chrome zu umgehen, navigieren Sie zu chrome://settings/content/sound und fügen Sie die Adresse Ihres Servers (oder unsere Website, wenn Sie das Remote-Portal verwenden) zur Liste Erlaubt hinzu.
  • Aufnahme starten bei (einigen Gerät) - wird aufgenommen, bis es gestoppt wird.
  • RTMP-Streaming starten
  • Zeitraffer starten bei (einigen Gerät)
  • Aufnahme stoppen bei (einigen Gerät)
  • RTMP-Streaming stoppen
  • Zeitraffer stoppen bei (einigen Gerät)
  • Gerät einschalten
  • Gerät ausschalten
  • System: Profil anwenden - wechselt das Profil
  • System: Scharfschalten
  • System: Unscharf schalten
  • Aufnahme taggen - fügt ein Tag zur aktuellen Aufnahme hinzu
  • Foto aufnehmen bei (einigen Gerät)
  • Text-zu-Sprache (auf Agent DVR-Computer - erfordert ein iSpyConnect.com-Konto, da Text über Webservice-Aufrufe gerendert wird)
  • Text-zu-Sprache (über Webbrowser)
Aufgrund von Browsersicherheit erfordert dies eine Interaktion mit der Webseite (z. B. Klicken auf etwas)
  • Text-zu-Sprache (über Kamera)
  • Adaptive Kodierung auslösen bei (anderem Gerät)
  • Alarm auslösen bei (anderem Gerät)
  • Ask AI auslösen (anderem Gerät)
  • Audioerkennung auslösen (anderem Gerät)
  • Trigger Detect On (anderes Gerät)
  • Trigger Face Recognition (anderes Gerät)
  • Trigger LPR (anderes Gerät)
  • Trigger Object Recognition (anderes Gerät)
  • Trigger Recording (with timeout) (anderes Gerät). Dies zeichnet bis zur Einstellung des Aufnahmezeitüberschreitungs-Zeitlimits auf der Registerkarte Aufnahme auf. Dieses Zeitlimit wird bei jedem Aufruf einer Aufnahmezeitauslöseaktion zurückgesetzt.
  • UI: Change View - verbundene Benutzeroberflächen zu einer anderen Ansicht wechseln

Verwenden von Markierungen

Tags in the Dann-Feldern von Agent DVR-Aktionen ermöglichen Ihnen, dynamische Antworten zu erstellen. Es ist wichtig zu beachten, dass einige Tags kontextabhängig sind. Beispielsweise ist {FILENAME} für Alarm-Ereignisse nicht verfügbar, und {AI} ist nicht verfügbar, wenn das Ereignis nicht von einem KI-Server generiert wurde.

  • {ID}: Die Objekt-ID, sichtbar oben links im Editor beim Bearbeiten einer Kamera oder eines Mikrofons in Agent.
  • {OT}: Die Objekttyp-ID. 1 für Mikrofon, 2 für Kamera.
  • {FILENAME}: Der Dateiname. Anwendbar auf Ereignisse wie Aufnahme gestartet, Aufnahme beendet und Snapshot aufgenommen. Es ist der vollständige lokale Pfad zur Datei.
  • {CURRENT_RECORDING}: Der Dateiname der aktuellen Aufnahme. Vollständiger lokaler Pfad zur Datei. (v5.0.6.0+)
  • {MESSAGE}: Der Name des Ereignisses, das die Aktion ausgelöst hat, z.B. "Manueller Alarm".
  • {EVENT}: Der Ereignistyp.
  • {NAME}: Der Name des Geräts (auf der Registerkarte "Allgemein" zu finden).
  • {GROUPS}: Die Gruppen, zu denen das Gerät gehört (auf der Registerkarte "Allgemein" zu finden).
  • {SERVER}: Der Servername (aus den Server-Einstellungen).
  • {ALERTID}: Die ID des Alarms (-1, wenn kein zugehöriger Alarm vorhanden ist).
  • {ALERTCOUNT}: Die Alarm-Anzahl des Geräts.
  • {TIME} und {DATE}: Die aktuelle Uhrzeit und das aktuelle Datum auf dem Server.
  • {RECORDED}: "REC", wenn das Gerät aufnimmt, andernfalls leer.
  • {TAGS}: Die dem Ereignis zugeordneten Tags.
  • {PLUGIN}: Die Nachricht aus einem Plugin-Ereignis.
  • {LOCATION}: Der Standort der Kamera (auf der Registerkarte "Allgemein" zu finden).
  • {LEVEL} und {DB}: Der Bewegungs- oder Audiopegel. {DB} ist der Dezibel-Wert für Audiogeräte. Gemessen, wenn die Aktion ausgeführt wird. (v4.3.7.0+)
  • {AI}: Eine kommagetrennte Liste erkannter Objekte von KI, Kennzeichen von LPR oder erkannter Gesichter von Gesichtserkennung.
  • {AIJSON}: JSON-Daten von KI oder LPR zurückgegeben.
  • {ZONE}: Die Zone, die die Aktion ausgelöst hat (leer, wenn KI nicht verwendet wird oder eine CSV-Liste für mehrere Zonen wie 1,2,3).
  • {BASE64IMAGE}: Live-Bilddaten-URL. Es sind die unverarbeiteten base64-kodierten Bytes, daher nach Bedarf formatieren, z.B.
    p=data:image/jpeg;base64,{BASE64IMAGE}
    (Verfügbar v4.5.9.0+). Live-Bild auf 640px Breite vergrößert.
  • {BASE64IMAGE-LG}: Live-Bilddaten-URL. Es sind die unverarbeiteten base64-kodierten Bytes, daher nach Bedarf formatieren, z.B.
    p=data:image/jpeg;base64,{BASE64IMAGE-LG}
    (Verfügbar v6.0.8.0+). Live-Bild auf 1280px Breite vergrößert.
  • {BASE64IMAGE-NATIVE}: Live-Bilddaten-URL. Es sind die unverarbeiteten base64-kodierten Bytes, daher nach Bedarf formatieren, z.B.
    p=data:image/jpeg;base64,{BASE64IMAGE-NATIVE}
    (Verfügbar v6.0.8.0+). Natives Live-Bild.
  • {TRIPCOUNT}, {TRIPCOUNTLEFT} und {TRIPCOUNTRIGHT}: Die Stolperdraht-Überquerungszähler (Gesamt, Links und Rechts), summiert über alle Stolperdrähte auf der Kamera. 0, wenn die Kamera den Stolperdraht-Detektor nicht verwendet. (v7.7.4.0+)
  • {TRIPJSON}: Die Stolperdraht-Zähler als JSON mit einer Aufschlüsselung pro Draht, z. B.
    {"left":3,"right":2,"total":5,"wires":[{"wire":1,"left":3,"right":2,"total":5}]}
    (v7.7.4.0+)

Beispielsweise mit einem Ereignis KI: Gesicht erkannt und einer Dann-Aufgabe Text-zu-Sprache mit dem Text

Hallo {AI}
werden erkannte Personen namentlich begrüßt.

Hinweis: Wenn Sie {BASE64IMAGE}-Tags mit einem dateibezogenen Ereignis wie "Foto aufgenommen" verwenden, wird das Bild in voller Größe aus der Datei verwendet. Andernfalls wird das aktuelle Live-Ansichtsbild vergrößert.

Seien Sie vorsichtig mit Trigger-Alarmen bei Aktionen, um zirkuläre Routen zu vermeiden, beispielsweise wenn ein Alarm auf Kamera 1 einen Alarm auf Kamera 2 auslöst, was wiederum einen Alarm auf Kamera 1 auslöst.

Nach dem Hinzufügen einer Aktion zeigt die Tabellensteuerung eine Zusammenfassung Ihrer Aktionen an. Ein grünes Häkchen zeigt eine aktive Aktion an.

Example Action Table

Sie können den Zeitplaner verwenden, um Aktionen zu aktivieren/deaktivieren oder eine Aktion auszulösen. Sie könnten beispielsweise eine Aktion planen, um eine E-Mail mit zwei Bildern zu einem bestimmten Zeitpunkt zu versenden.

Schedule Actions

In diesem Beispiel wurde eine Aktion zum Versenden einer E-Mail mit 2 Bildern hinzugefügt, eingestellt auf das Ereignis Keine. Anschließend wurde ein Zeitplaneintrag erstellt, um diese Aktion um 8 Uhr morgens am Sonntag und Samstag auszuführen.