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 zu einer bestimmten Ansicht öffnen, indem Sie die Agent DVR-URL aufrufen mit (Groß- und Kleinschreibung beachten):

• ?start=Live&viewIndex=3 (Live-Ansicht auf Ansicht 3)
• ?start=TimeMachine (Timemachine-Ansicht)
• ?start=Timeline (Timeline-Ansicht)
• ?start=Photos (Fotos-Ansicht)
• ?start=Recordings (Aufnahmen-Ansicht)
• ?start=Floorplans&planIndex=2 (Grundrisse-Ansicht auf Plan 2)
• ?start=VR (Virtual Reality)

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

Sie können einen gespeicherten Filter über einen Filterparameter anwenden - z. B.: ?start=Recordings&filter=intruder. Sie können auch eine Start- und Endzeit für den Filter mit JavaScript-Ticks angeben. z. B. ?start=timeline&from=1657841514949&to=1657852514949.

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

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

Audio automatisch wiedergeben beim Laden (kann auch eine Änderung der Browsereinstellungen erfordern):

• ?playaudio=true

In minimierter Ansicht starten (obere und untere UI-Leisten ausgeblendet):

• ?mini=true

Geben Sie den lokalen Benutzernamen und das Passwort für die automatische Anmeldung an (Vorsicht - dadurch werden Ihre Anmeldedaten im Netzwerk freigegeben):

• ?un=username&pwd=password

Um auf Befehle in Agent DVR zuzugreifen, klicken Sie auf das Server-Symbol oben links in der Agent-Oberfläche und wählen Sie "Befehle" unter System aus. Eine schnelle Abkürzung ist die Taste "Alt - C".

Agent DVR enthält mehrere vorgefertigte Befehle, mit denen mehrere Geräte gleichzeitig gesteuert werden können. Diese Befehle nutzen die API, um verschiedene Aufgaben auszuführen. Sie haben die Flexibilität, eigene benutzerdefinierte Befehle hinzuzufügen, um die API aufzurufen oder Software auf Ihrem Computer auszuführen.

Aufrufen einer Skriptdatei

Um eine generische Skriptdatei auszuführen, fügen Sie einfach eine .bat-Datei (oder .sh-Datei unter Linux/macOS) in das Befehlsverzeichnis ein. Der Dateiname des Skripts (ohne Erweiterung) wird in der Befehlsliste angezeigt und kann angeklickt werden, um es 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 installiert ist. Die erste Zeile sollte lauten:

REM ispy-internal

Die folgenden Zeilen werden als Befehle für die API von Agent interpretiert. Zum Beispiel:

 REM ispy-internal

 switchon&group=external

 switchoff&group=internal

 record&group=external

 broadcast 'externe Kameras sind eingeschaltet und zeichnen auf'

Diese Befehle werden an API-Aufrufe im Format /command.cgi?cmd=... angehängt. Sie können also jeden Befehl verwenden, der in der API verfügbar ist.

Die obigen Beispielsbefehle aktivieren alle Geräte mit der Bezeichnung "external", deaktivieren alle "internal"-Geräte, starten die Aufnahme auf "external"-Geräten und senden eine Broadcast-Nachricht an alle verbundenen Clients.

Siehe die Schaltfläche readme für Beispiele und die API-Dokumentation für eine Liste der verfügbaren 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 Standort 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 ist vollständig in Home Assistant integriert, sodass Sie Agent DVR in Ihre Home Assistant-Konfiguration einfügen können. Betten Sie das Agent DVR-Panel in die Lovelace-Benutzeroberfläche ein oder wählen Sie einzelne Kameras aus. Es enthält auch eine Steuerung für das Haupt-Sicherheitspanel. Weitere Informationen finden Sie unter dem Home Assistant-Link unter Server - Integrationen.

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.