Integrationen

Unsere mobilen Apps ermöglichen es Ihnen, über Ihr LAN oder über unsere Remote-Dienste eine Verbindung herzustellen. Sie sind sowohl für Android- als auch für iOS-Geräte verfügbar.

Laden Sie die Agent DVR Remote Android App herunter.

Laden Sie die Agent DVR Remote IOS App herunter.

Hier gibt es eine Python-Schnittstelle für grundlegende UI-Funktionen: agent-py .

Sie können Agent DVR durch Aufrufen der Agent DVR URL mit den folgenden Parametern (Groß- und Kleinschreibung beachten) zu einer bestimmten Ansicht öffnen:

• ?start=Live&viewIndex=3 (Live-Ansicht in Ansicht 3)
• ?start=Live&viewIndex=3&ot=2&oid=2&max=true (Live-Ansicht in Ansicht 3, Kamera-ID 2 maximiert). "oid" ist die Objekt-ID des Geräts (sichtbar oben im Dialog beim Bearbeiten der Kamera), "ot" ist der Objekttyp - 1 = Mikrofon, 2 = Kamera.
• ?start=TimeMachine (TimeMachine-Ansicht)
• ?start=Timeline (Timeline-Ansicht)
• ?start=Photos (Fotos-Ansicht)
• ?start=Recordings (Aufzeichnungen-Ansicht)
• ?start=Floorplans&planIndex=2 (Grundrisse-Ansicht für Plan 2)
• ?start=VR (Virtual Reality)

Sie können Agent DVR mit einer bestimmten Sprache öffnen (unter Umgehung der Sprachauswahl). Geben Sie einfach den 2-stelligen Sprachcode ein: ?lang=fr

Sie können den Namen eines gespeicherten Filters mit dem Filter-Parameter übergeben - z.B.: ?start=Recordings&filter=intruder. Sie können auch eine Start- und Endzeit für den Filter mit JavaScript-Ticks übergeben, z.B. ?start=timeline&from=1657841514949&to=1657852514949.

Legen Sie Standard-Designoptionen fest (Designoptionen sind im Kontomenü unter Designeinstellungen verfügbar):

• ?theme=darkly&variant=dark&large=false
• ?theme=sketchy&variant=primary&large=true

Audio beim Laden automatisch abspielen (möglicherweise müssen auch Browsereinstellungen geändert werden):

• ?playaudio=true

Im minimierten Modus starten (obere und untere UI-Leisten verborgen):

• ?mini=true

Lokalen Benutzernamen und Kennwort für automatische Anmeldung übergeben (Vorsicht - dies macht Ihre Anmeldedaten im Netzwerk sichtbar):

• ?un=username&pwd=password

Eine bestimmte Benachrichtigung anhand der Benachrichtigungs-ID öffnen (in der Benachrichtigungs-JSON):

• ?alertid=xxx

Um auf Befehle in Agent DVR zuzugreifen, klicken Sie auf das Serversymbol oben rechts in der Agent DVR-Benutzeroberfläche und wählen Sie "Commands" unter System. Eine schnelle Tastenkombination ist "Alt+C".

Agent DVR enthält mehrere vordefinierte Befehle, die mehrere Geräte gleichzeitig steuern können. Diese Befehle nutzen die API, um verschiedene Aufgaben auszuführen. Sie haben die Flexibilität, Ihre eigenen benutzerdefinierten Befehle zum Aufrufen der API oder zum Ausführen von Software auf Ihrem Computer hinzuzufügen.

Aufrufen einer Skriptdatei

Um eine generische Skriptdatei auszuführen, fügen Sie einfach eine .bat-Datei (oder .sh-Datei unter Linux/macOS) zum Befehlsverzeichnis hinzu. Der Dateiname des Skripts (ohne Erweiterung) wird in der Befehlsliste angezeigt und kann angeklickt werden, um ihn auszuführen. Hinweis: Möglicherweise müssen Sie die Benutzeroberfläche neu laden, damit sie angezeigt wird.

Aufrufen der API

Erstellen Sie eine neue .bat-Datei im Befehlsordner, in dem Agent DVR installiert ist. Die erste Zeile sollte lauten:

REM ispy-internal

Die nachfolgenden Zeilen werden als Befehle für die Agent DVR-API interpretiert. Zum Beispiel:

 REM ispy-internal

 switchon&group=external

 switchoff&group=internal

 record&group=external

 broadcast 'external cameras are on and recording'

Diese Befehle werden an API-Aufrufe im Format /command.cgi?cmd=... angefügt. Daher können Sie jeden in der API verfügbaren Befehl verwenden.

Die obigen Beispielbefehle aktivieren alle Geräte mit dem Label "external", deaktivieren alle "internal"-Geräte, starten die Aufzeichnung auf "external"-Geräten und senden eine Broadcast-Nachricht an alle verbundenen Clients.

Lesen Sie den Befehlsbutton readme für Beispiele und die API-Dokumentation für eine Liste verfügbarer Befehle.

Nach dem Neuladen der Benutzeroberfläche und dem Drücken von "Alt+C" sollte Ihr neuer Befehl in der Liste sichtbar sein. Klicken Sie darauf, um ihn auszuführen.

Ab Version 3.8.1.0+ können Sie Ortsnamen in Befehlen verwenden (z. B. switchon&location=home). Weisen Sie Ihren Geräten einfach zuerst einen Ort zu!

Ab Version 2.9.5.0 bietet Agent DVR eine Integration mit Amazon Alexa. Mit dieser Funktion können Sie Agent DVR über Sprachbefehle über Alexa-fähige Geräte steuern. Sie können das System aktivieren oder deaktivieren oder Live-Videofeeds auf Alexa Show-Geräten anzeigen.

Um es einzurichten, wählen Sie 'Alexa' unter Integrationen im Server-Menü von Agent DVR. Dies leitet Sie zu Amazon weiter, um Ihre Konten zu verknüpfen.

Sobald die Verknüpfung hergestellt ist, führen Sie den Erkennungsprozess von Alexa durch. Es sollten zwei Geräte gefunden werden: das Sicherheitspanel und die Kamerasteuerung.

Nun können Sie Sprachbefehle wie folgt verwenden:

• "Alexa, aktiviere Agent im Heimmodus"
• "Alexa, zeige Agent Kamera"

Legen Sie Ihren Sicherheitscode in den Agent-Einstellungen für Operationen fest, die eine Authentifizierung erfordern. Der Standardcode ist 1234.

Die Alexa-Profile (Zuhause / Abwesend / Nacht) entsprechen denen in Agent DVR. Konfigurieren Sie sie im Server - Profile.

Für mehrere Server legen Sie einen Servernamen in den Einstellungen fest und verwenden Sie ihn in Sprachbefehlen.

Agent DVR lässt sich vollständig in Home Assistant integrieren, sodass Sie Agent DVR in Ihr Home Assistant-Setup einbinden können. Betten Sie das Agent DVR-Panel in die Lovelace-UI ein oder wählen Sie einzelne Kameras aus. Es enthält auch eine Steuerung für das Hauptsicherheitspanel. Weitere Informationen finden Sie unter Server - Integrations im Home Assistant-Link.

Agent DVR kann seine Geräte auch über MQTT als Sensoren und Schalter in Home Assistant veröffentlichen: siehe Home Assistant MQTT-Erkennung.

IFTTT ermöglicht es Ihnen, Aktionen und Auslöser mit IoT-Geräten einzurichten. Beginnen Sie damit, Ihr IFTTT-Konto mit iSpyConnect.com zu verknüpfen, das unter Server - Integrationen erreichbar ist.

Die Einrichtung von mobilen Push-Benachrichtigungen wird unter Einrichten von Push-Benachrichtigungen detailliert beschrieben.

Verbinden Sie Agent DVR mit dem Telegram-Chatbot für Steuerung und Live-Alarmbenachrichtigungen. Aktivieren Sie Push-Benachrichtigungen in den Geräteeinstellungen für Live-Alarme. Beginnen Sie, indem Sie die Telegram-Schaltfläche unter dem Server-Symbol in der Remote-Web-Oberfläche auswählen.

Agent DVR kann Alarme an jeden Dienst senden, der eingehende Webhooks akzeptiert, darunter Discord, Slack, Mattermost, Google Chat, Microsoft Teams und ntfy. Eine Kontoverknüpfung ist nicht nötig: Sie erstellen eine Webhook-URL im Zieldienst und Agent DVR sendet die Alarme direkt dorthin. Das funktioniert auch auf Servern ohne Fernzugriff.

Die Einrichtung ist bei allen Diensten gleich. Bearbeiten Sie Ihre Kamera oder Ihr Mikrofon, öffnen Sie den Tab Aktionen und fügen Sie eine Aktion hinzu:

• Wenn: Alarm (oder ein beliebiges anderes Ereignis)
• Dann: URL aufrufen
• URL: die Webhook-URL des Dienstes
• Methode: POST
• Körper: die Nachricht, formatiert wie unten je Dienst gezeigt

Sie können Tags wie {NAME}, {MESSAGE}, {AI} und {ZONE} im Körper-Feld verwenden, um die Nachricht dynamisch aufzubauen.

Content-Type: application/json

Discord

Öffnen Sie in Discord die Kanaleinstellungen (Zahnrad-Symbol) und wählen Sie Integrationen - Webhooks - Neuer Webhook, dann Webhook-URL kopieren. In der Agent DVR Aktion verwenden Sie:

• URL: die kopierte Webhook-URL
• Körper:

  {"content":"{MESSAGE}: {NAME} auf {SERVER} {AI}"}

Um Schnappschüsse an die Discord-Nachricht anzuhängen, stellen Sie den Regler Bild hochladen auf 1 oder mehr (v7.8.7.0+). Jedes weitere Bild wird im Abstand von einer halben Sekunde aufgenommen.

Slack

Erstellen Sie eine Slack-App unter api.slack.com/apps, aktivieren Sie Incoming Webhooks, klicken Sie auf Add New Webhook to Workspace, wählen Sie einen Kanal und kopieren Sie die URL (sie beginnt mit hooks.slack.com). In der Agent DVR Aktion verwenden Sie:

• URL: die kopierte Webhook-URL
• Körper:

  {"text":"{MESSAGE}: {NAME} auf {SERVER} {AI}"}

Slack Incoming Webhooks unterstützen nur Text, lassen Sie Bild hochladen also auf 0.

Mattermost

Gehen Sie in Mattermost zu Hauptmenü - Integrationen - Eingehende Webhooks - Eingehenden Webhook hinzufügen, wählen Sie einen Kanal und kopieren Sie die URL. Verwenden Sie das gleiche Körper-Format wie bei Slack:

{"text":"{MESSAGE}: {NAME} auf {SERVER}"}

Google Chat

Klicken Sie in einem Google Chat-Bereich (Workspace-Konten) auf den Namen des Bereichs und wählen Sie Apps & Integrationen - Webhooks - Webhook hinzufügen, dann kopieren Sie die URL. Verwenden Sie das gleiche Körper-Format wie bei Slack:

{"text":"{MESSAGE}: {NAME} auf {SERVER}"}

Microsoft Teams

Klicken Sie in Teams auf die drei Punkte neben einem Kanal, wählen Sie Workflows und fügen Sie die Vorlage In einem Kanal posten, wenn eine Webhookanforderung empfangen wird hinzu, dann kopieren Sie die erhaltene URL. Teams erfordert die Nachricht als Adaptive Card:

{"type":"message","attachments":[{"contentType":"application/vnd.microsoft.card.adaptive","content":{"type":"AdaptiveCard","version":"1.4","body":[{"type":"TextBlock","text":"{MESSAGE}: {NAME} auf {SERVER}","wrap":true}]}}]}

ntfy

ntfy sendet Push-Benachrichtigungen an Ihr Telefon ohne Konto und kann auch selbst gehostet werden. Wählen Sie einen schwer zu erratenden Themennamen (jeder, der ihn kennt, kann ihn abonnieren), dann:

• URL: https://ntfy.sh/ihr-themenname
• Körper: einfacher Text (kein JSON), z.B.

  {MESSAGE}: {NAME} auf {SERVER}

• Header (optional, einer pro Zeile):

  Title: Agent DVR
  Tags: rotating_light
  Priority: high

Installieren Sie die ntfy-App auf Ihrem Telefon und abonnieren Sie Ihr Thema, um die Alarme zu erhalten.

Andere Dienste

Alles, was einen HTTP POST akzeptiert, funktioniert auf die gleiche Weise, zum Beispiel Home Assistant Webhook-Trigger (http://homeassistant.local:8123/api/webhook/ihre-id - die MQTT-Integration ist allerdings umfangreicher). Agent DVR sendet JSON-Körper als application/json und alles andere formularkodiert. Zusätzliche Header (zum Beispiel API-Schlüssel) können Sie im Feld Header hinzufügen, einer pro Zeile als Name: Wert.