Integrazioni

Le nostre app mobili ti consentono di connetterti tramite la tua LAN o tramite i nostri servizi remoti. Sono disponibili per dispositivi Android e iOS.

Scarica l'App Android Agent DVR Remote .

Scarica l'App IOS Agent DVR Remote .

C'è un wrapper Python per la funzionalità di base dell'interfaccia utente qui: agent-py .

Puoi aprire Agent DVR con una visualizzazione specifica chiamando l'URL di Agent DVR con (maiuscole/minuscole)::

• ?start=Live&viewIndex=3 (visualizzazione live sulla vista 3)
• ?start=Live&viewIndex=3&ot=2&oid=2&max=true (visualizzazione live sulla vista 3, fotocamera id 2 massimizzata). "oid" è l'object id del dispositivo (visibile in alto nella finestra di dialogo quando modifichi la fotocamera), "ot" è il tipo di oggetto - 1 = microfono, 2 = fotocamera.
• ?start=TimeMachine (visualizzazione timemachine)
• ?start=Timeline (visualizzazione timeline)
• ?start=Photos (visualizzazione foto)
• ?start=Recordings (visualizzazione registrazioni)
• ?start=Floorplans&planIndex=2 (visualizzazione floorplans sul piano 2)
• ?start=VR (realtà virtuale)

Puoi aprire Agent DVR con una lingua specifica (bypassando la selezione della lingua). Basta passare il codice lingua a 2 lettere: ?lang=fr

Puoi passare il nome di un filtro salvato da applicare utilizzando un parametro filter - ad esempio: ?start=Recordings&filter=intruder. Puoi anche passare un'ora di inizio e di fine per il filtro utilizzando i tick javascript. ad esempio ?start=timeline&from=1657841514949&to=1657852514949.

Imposta le opzioni del tema predefinito (le opzioni del tema sono disponibili nel menu account - impostazioni tema):

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

Riproduci automaticamente l'audio al caricamento (potrebbe richiedere anche la modifica delle impostazioni del browser):

• ?playaudio=true

Avvia in modalità minimizzata (barre dell'interfaccia utente superiore e inferiore nascoste):

• ?mini=true

Passa il nome utente e la password locale per l'accesso automatico (attenzione - questo esporrà le tue credenziali alla rete):

• ?un=username&pwd=password

Apri un avviso specifico per alert id (nel json dell'avviso):

• ?alertid=xxx

Per accedere a Comandi in Agent DVR, fai clic sull'icona Server in alto a destra dell'interfaccia utente di Agent DVR e seleziona "Comandi" sotto Sistema. Un collegamento rapido è premere "Alt-C".

Agent DVR include diversi comandi precostruiti che possono controllare più dispositivi contemporaneamente. Questi comandi utilizzano l'API per eseguire varie attività. Hai la flessibilità di aggiungere i tuoi comandi personalizzati per chiamare l'API o eseguire software sul tuo computer.

Chiamata a un file di script

Per eseguire un file di script generico, aggiungi semplicemente un file .bat (o file .sh su Linux/macOS) alla directory dei comandi. Il nome del file dello script (senza l'estensione) apparirà nell'elenco Comandi e può essere cliccato per eseguire. Nota: potrebbe essere necessario ricaricare l'interfaccia utente affinché compaia.

Chiamata all'API

Crea un nuovo file .bat nella cartella Comandi in cui Agent DVR è installato. La prima riga deve essere:

REM ispy-internal

Le righe successive vengono interpretate come comandi per l'API di Agent DVR. Ad esempio:

 REM ispy-internal

 switchon&group=external

 switchoff&group=internal

 record&group=external

 broadcast 'external cameras are on and recording'

Questi comandi vengono aggiunti alle chiamate API nel formato /command.cgi?cmd=.... Quindi, puoi utilizzare qualsiasi comando disponibile nell'API.

I comandi di esempio sopra attiveranno tutti i dispositivi etichettati come "external", disattiveranno tutti i dispositivi "internal", avvieranno la registrazione sui dispositivi "external" e invieranno un messaggio broadcast a tutti i client connessi.

Fai riferimento al pulsante comando readme per esempi e alla documentazione API per un elenco dei comandi disponibili.

Dopo aver ricaricato l'interfaccia utente e premuto "Alt-C", il tuo nuovo comando dovrebbe essere visibile nell'elenco. Fai clic su di esso per eseguire.

Dalla versione 3.8.1.0+, puoi utilizzare nomi di posizione nei comandi (ad esempio, switchon&location=home). Assegna semplicemente una posizione ai tuoi dispositivi per primo!

Dalla versione 2.9.5.0, Agent DVR offre l'integrazione con Amazon Alexa. Questa funzionalità ti consente di controllare Agent DVR utilizzando comandi vocali tramite dispositivi abilitati ad Alexa. Puoi armare o disarmare il sistema o visualizzare i feed video in diretta sui dispositivi Alexa Show.

Per configurarlo, seleziona 'Alexa' sotto Integrazioni nel menu Server di Agent DVR. Questo ti reindirizzerà ad Amazon per collegare i tuoi account.

Dopo aver collegato, avvia il processo di scoperta di Alexa. Dovrebbe trovare due dispositivi: il pannello di sicurezza e il controllo della telecamera.

Ora puoi utilizzare comandi vocali come:

• "Alexa, arma Agent in modalità casa"
• "Alexa, mostra la telecamera di Agent"

Imposta il tuo codice di sicurezza nelle Impostazioni di Agent per le operazioni che richiedono autenticazione. Il codice predefinito è 1234.

I profili di Alexa (Casa / Assente / Notte) corrispondono a quelli di Agent DVR. Configurali in Server - Profili.

Per server multipli, imposta un nome server nelle impostazioni e utilizzalo nei comandi vocali.

Agent DVR si integra completamente con Home Assistant, permettendoti di aggiungere Agent DVR alla tua configurazione Home Assistant. Incorpora il pannello Agent DVR nell'interfaccia lovelace o seleziona singole fotocamere. Include anche un controllo per il pannello di sicurezza principale. Per ulteriori informazioni, consulta il collegamento Home Assistant in Server - Integrazioni.

Agent DVR può anche pubblicare i suoi dispositivi su Home Assistant come sensori e switch tramite MQTT: consulta Rilevamento MQTT Home Assistant.

IFTTT ti consente di impostare azioni e trigger con dispositivi IoT. Inizia collegando il tuo account IFTTT con iSpyConnect.com, accessibile sotto Server - Integrazioni.

La configurazione delle notifiche push mobili è dettagliata su Configurazione delle notifiche push.

Collega Agent DVR al chatbot di Telegram per il controllo e le notifiche di avviso in tempo reale. Abilita le notifiche Push nelle impostazioni del dispositivo per gli avvisi in tempo reale. Inizia selezionando il pulsante Telegram sotto l'icona del Server nell'interfaccia web remota.

Agent DVR può inviare avvisi a qualsiasi servizio che accetti webhook in entrata, tra cui Discord, Slack, Mattermost, Google Chat, Microsoft Teams e ntfy. Non serve collegare account: crei un URL webhook nel servizio di destinazione e Agent DVR vi pubblica direttamente gli avvisi, quindi funziona anche su server senza accesso remoto.

La configurazione generale è la stessa per tutti i servizi. Modifica la tua telecamera o il tuo microfono, apri la scheda Azioni e aggiungi un'azione:

• Se: Avviso (o qualsiasi altro evento)
• Allora: Chiama URL
• URL: l'URL webhook del servizio
• Metodo: POST
• Corpo: il messaggio, nel formato mostrato per ciascun servizio qui sotto

Puoi usare i tag come {NAME}, {MESSAGE}, {AI} e {ZONE} nel campo Corpo per costruire il messaggio dinamicamente.

Content-Type: application/json

Discord

In Discord, apri le impostazioni del canale (icona a ingranaggio) e scegli Integrazioni - Webhook - Nuovo webhook, poi Copia URL webhook. Nell'azione di Agent DVR usa:

• URL: l'URL webhook copiato
• Corpo:

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

Per allegare istantanee al messaggio Discord, imposta il cursore Carica immagine su 1 o più (v7.8.7.0+). Ogni immagine successiva viene catturata a mezzo secondo di distanza.

Slack

Crea un'app Slack su api.slack.com/apps, abilita Incoming Webhooks, fai clic su Add New Webhook to Workspace, scegli un canale e copia l'URL (inizia con hooks.slack.com). Nell'azione di Agent DVR usa:

• URL: l'URL webhook copiato
• Corpo:

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

I webhook in entrata di Slack sono solo testuali, quindi lascia Carica immagine a 0.

Mattermost

In Mattermost, vai su Menu principale - Integrazioni - Webhook in entrata - Aggiungi webhook in entrata, scegli un canale e copia l'URL. Usa lo stesso formato di Corpo di Slack:

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

Google Chat

In uno spazio Google Chat (account Workspace), fai clic sul nome dello spazio e scegli App e integrazioni - Webhook - Aggiungi webhook, poi copia l'URL. Usa lo stesso formato di Corpo di Slack:

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

Microsoft Teams

In Teams, fai clic sui tre puntini accanto a un canale, scegli Flussi di lavoro e aggiungi il modello Pubblica in un canale quando viene ricevuta una richiesta webhook, poi copia l'URL fornito. Teams richiede il messaggio come Adaptive Card:

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

ntfy

ntfy invia notifiche push al tuo telefono senza bisogno di account e può anche essere ospitato in proprio. Scegli un nome di argomento difficile da indovinare (chiunque lo conosca può iscriversi), poi:

• URL: https://ntfy.sh/il-tuo-argomento
• Corpo: testo semplice (niente JSON), ad es.

  {MESSAGE}: {NAME} su {SERVER}

• Intestazioni (facoltativo, una per riga):

  Title: Agent DVR
  Tags: rotating_light
  Priority: high

Installa l'app ntfy sul tuo telefono e iscriviti al tuo argomento per ricevere gli avvisi.

Altri servizi

Tutto ciò che accetta un HTTP POST funziona allo stesso modo, ad esempio i trigger webhook di Home Assistant (http://homeassistant.local:8123/api/webhook/il-tuo-id - anche se l'integrazione MQTT è più completa). Agent DVR invia i corpi JSON come application/json e tutto il resto con codifica form. Puoi aggiungere intestazioni extra (ad esempio chiavi API) nel campo Intestazioni, una per riga come Nome: Valore.