Agente DVR: Plugin

Installazione dei Plugin

I plugin sono moduli aggiuntivi facoltativi che estendono Agent DVR con funzionalità extra di elaborazione audio e video, come la scansione di codici a barre, sovrapposizioni meteo e filtri audio.

Il modo più semplice per installare i plugin è attraverso il portale web remoto. Una volta connesso, fai clic sull'icona Server in alto a destra e accedi a 'Plugins' sotto System. Qui puoi selezionare il plugin che desideri utilizzare dal menu a discesa in alto a destra e fare clic su 'Install' per iniziare.

Preferisci installare manualmente? Nessun problema! Puoi compilare i plugin dal codice sorgente e quindi copiare l'output compilato in Agent/Plugins/PLUGINNAME. Questo metodo ti dà più controllo sul processo di installazione.

Plugin Disponibili

Agent DVR è ricco di funzionalità avanzate di elaborazione video come l'integrazione con CodeProject AI, insieme al rilevamento degli oggetti avanzato, al riconoscimento audio e ai rilevatori di conteggio. Per migliorare ulteriormente la tua esperienza, offriamo una gamma di plugin che puoi utilizzare in AgentDVR per estenderne la funzionalità.

Elenco dei plugin

Codici a barre

Scansiona praticamente qualsiasi codice a barre da una fotocamera (solo Windows).

Eventi generati: Codice a barre riconosciuto
Supporta: Video

screenshot

Guadagno

Applica filtri banda live all'audio proveniente da dispositivi audio.

Eventi generati: Nessuno
Supporta: Audio

screenshot

Ritardo live

Aggiunge un ritardo all'audio e al video live (utile per l'analisi sportiva).

Eventi generati: Nessuno
Supporta: Video, Audio

screenshot

Meteo

Aggiunge una sovrapposizione dello stato meteo al video live in base alla tua posizione. Genera eventi se le condizioni meteo cambiano, ad esempio se sta arrivando un temporale o se le raffiche di vento o i limiti di temperatura vengono superati. Puoi personalizzare il layout e la modalità di visualizzazione dei dati meteo da una semplice icona a dettagli completi.

La configurazione del meteo utilizza una stringa di formato per organizzare le informazioni. Ecco alcuni esempi di stringhe di formato che puoi utilizzare:

Informazioni complete:

{icon}{main}: {description} 
 Vento: {wind} Raffica: {gust} 
 Temp: {temp} Sente come: {feelsLike} 
 Umidità: {humidity} UVI: {uvi}

Solo icona:

{icon}

Una riga:

{main} {wind} {temp} {humidity} UVI: {uvi}

Eventi generati: Temperatura alta, Raffica, Stato
Supporta: Video

screenshot
Se stai utilizzando un plugin audio come Listen su una fotocamera, dovrai modificare la fotocamera, selezionare la scheda Audio e fare clic per configurare il microfono. Da lì puoi accedere alla scheda Plugin per i dispositivi audio. In alternativa, puoi fare clic sull'icona del server, Modifica dispositivi e modificare il microfono da quell'elenco.

Configurazione dei Plugin

Pronto a sfruttare la potenza dei plugin? Aggiungi semplicemente un dispositivo (fotocamera e/o microfono) e accedi alle relative impostazioni di modifica. Cerca la scheda Plugins nel menu a discesa in alto a destra. Qui puoi selezionare il plugin desiderato e fare clic sul pulsante "..." per configurarlo secondo le tue esigenze.

Alcuni plugin generano eventi ai quali è possibile allegare azioni. Il plugin Weather, ad esempio, genera un evento Gust quando le raffiche di vento superano un valore specificato (configurabile nel plugin). Modificando la fotocamera e accedendo alla scheda Actions hai a disposizione opzioni per rispondere a questo evento - ad esempio attivare un allarme o avviare una registrazione. Seleziona semplicemente il nome del plugin: evento (ad es. Weather: Gust) nella casella di selezione If e assegna un'azione.

Crea il tuo Plugin

I plugin sono moduli dinamici che puoi aggiungere ad Agent DVR per migliorare le capacità di elaborazione audio e video. Con i plugin, applica effetti in tempo reale, overlay, genera eventi e attiva avvisi in Agent DVR, permettendo azioni personalizzate avanzate.

Per iniziare a creare plugin per Agent DVR, inizia clonando i nostri plugin open-source da https://github.com/ispysoftware/AgentDVR-Plugins. Avrai bisogno di una versione recente di Visual Studio per compilarli.

Consigliamo di iniziare con il plugin demo come base. Assicurati di avere installata l'ultima versione di Agent. Dopo aver compilato il plugin demo, copia tutti i file dalla cartella di output a Agent\Plugins\Demo\. Riavvia Agent DVR, modifica una telecamera e vai alla scheda Plugins. Abilita il plugin, seleziona Demo dal menu a discesa e fai clic sul pulsante "..." per configurarlo.

Il plugin Demo è completamente compatibile multipiattaforma e dimostra le funzionalità estese che puoi costruire con i plugin. Include effetti video in tempo reale, overlay grafici, controllo del volume in tempo reale e integrazione con il sottosistema Events di Agent DVR. Il menu del plugin fornisce approfondimenti su come funzionano vari controlli di input.


Note sui Plugin per gli Sviluppatori:

Configurazione: Agent DVR utilizza JSON e un file di classe per l'archiviazione delle impostazioni. Per configurare le impostazioni modifica il file config.cs.

Il rendering della configurazione di Agent DVR si basa su file .json. Modifica config_en.json nella directory json per la visualizzazione dell'interfaccia utente, dove puoi aggiungere più sezioni renderizzate come schede. I campi chiave 'bindto' in json si collegano ai campi di configurazione. Agent DVR automatizza il rendering dei controlli, l'archiviazione delle impostazioni e gli aggiornamenti.

L'aggiunta di "live": true alle voci json abilita gli aggiornamenti immediati senza attendere il clic del pulsante OK, ideale per l'ottimizzazione in tempo reale. Il campo 'converter' utilizza 'PopulateResponse' in Utils.cs per la formattazione dei valori.

Supporto Media: Scegli di elaborare "video", "audio" o entrambi. Il campo 'Supports' in Main.cs può essere codificato.

Elaborazione Continua: Ogni frame video e audio dal dispositivo viene inviato al plugin per l'analisi o l'elaborazione, come dimostrato nel demo.

Elaborazione di Motion/Alert: Elabora i frame su motion o avvisi utilizzando il metodo 'ProcessEvent' nel plugin demo. Questo consente l'elaborazione dei frame solo durante questi eventi.

Eventi Personalizzati: Il metodo 'GetCustomEvents' nel tuo plugin dovrebbe restituire un elenco di eventi personalizzati che genera. Questi eventi vengono quindi visualizzati in Actions nell'elenco 'If' dell'interfaccia utente di Agent DVR. Attiva questi eventi con un elemento 'Result', specificando il nome dell'azione e facoltativamente MSG, Tag, Filename e AIJSON.

Alert, Detect e Tag: Genera avvisi o rileva eventi aggiungendo un Result con "alert" o "detect" come eventName. Etichetta le registrazioni in corso con un 'tag' eventName e imposta i Tag secondo le necessità.

Chiamate API: Agent DVR inizializza i plugin con le informazioni del dispositivo e la porta del server locale, utile per i comandi API del dispositivo. Anche le proprietà AppDataPath e AppPath vengono impostate per le posizioni di visualizzazione o salvataggio dei file.

Distribuzione: Hai creato un plugin interessante o utile? Condividilo con noi e contribuisci alla comunità!