Configurazione: Azioni

Le azioni in Agent DVR sono risposte a eventi specifici, come avvisi della fotocamera/IA o disconnessioni di dispositivi. Usale per rispondere automaticamente, ad esempio attivando un allarme, accendendo le luci tramite un URL di una presa intelligente o attivando la registrazione su un'altra fotocamera. Per accedere e configurare le azioni, modifica un dispositivo e vai alla sezione Azioni nel menu.

Fai clic su 'Aggiungi' per creare una nuova azione. Ti verrà presentata una schermata di configurazione simile alle immagini sottostanti:

Esiste un'ampia gamma di eventi che possono attivare azioni. È possibile associare più azioni a ogni evento e incorporare vari tag all'interno di queste azioni per creare risposte dinamiche.

Configurazione di un'Azione

• Attivo: Attiva o disattiva l'azione. In alternativa, puoi utilizzare la Pianificazione e l'API con comandi come actionOn, actionOff e actionRun, utilizzando l'ID mostrato sopra.
• Nome: Un nome facoltativo per l'azione.
• Se: Seleziona un evento disponibile (vedi sotto).
• Con tag: (Eventi IA). Viene utilizzato principalmente con eventi IA. Ad esempio, se selezioni IA: Oggetto trovato e inserisci gatto qui, l'azione si attiverà solo quando viene rilevato un gatto. Nota che il tag corrisponde in base alla lingua selezionata in Impostazioni Server - Generale.
• Regola: Scegli se più tag devono corrispondere tutti (AND) o se uno qualsiasi può corrispondere (OR).
• In Zone: (Eventi IA). Specifica le zone di movimento (dalla scheda rilevamento movimento) per filtrare gli oggetti rilevati. Ad esempio, selezionando la zona 1 e gatto come tag, l'azione si attiverà solo quando viene rilevato un gatto nella zona 1. Lascia vuoto per includere tutte le zone.
• Timeout Ripetizione: Sopprime l'evento se è stato generato entro questo intervallo e azzera anche il timer. Ad esempio, con 'Veicolo rilevato' come trigger e un timeout di 30 secondi, un avviso verrà inviato una volta, con gli avvisi successivi in pausa fino a quando non vi sarà un intervallo di 30 secondi nel traffico rilevato.
• Aggiungi Attività: Fai clic per aggiungere un'attività. È possibile assegnare più attività a un'azione (v4.5.5.0+).

Le azioni possono rispondere a un'ampia gamma di eventi di sistema, dispositivo e AI. Gli eventi per cui puoi configurare azioni sono:

• AI Server Down (AI Server ha restituito un errore - l'evento si attiva dopo che le richieste hanno fallito 3 volte e non si ripete finché il server non è di nuovo online)
• AI Server Up (AI Server ha abbandonato lo stato di errore)
• AI: Ask AI Positive Result (Ha trovato un oggetto che stavi cercando)
• AI: Ask AI Result (si attiva su qualsiasi risposta Ask AI, positiva o negativa)
• AI: Describe Response Received (Un'immagine è stata descritta da AI - la descrizione è nei tag {MESSAGE} e {AIJSON})
• AI: Face Recognized
• AI: Face Not Recognized
• AI: License Plate Recognized
• AI: License Plate Not Recognized
• AI: Loiter Detected
• AI: Object Found
• AI: Object Not Found
• AI: Sound Recognized (solo microfoni)
• Alert
• Alert Finished
• Call URL Response Received - Questo viene attivato dalla risposta che ricevi quando un'attività "Call URL" viene eseguita, permettendoti di rispondere con altre attività.
• Manual Alert
• Motion Detected
• Motion Finished
• None - usa questo se desideri attivare l'azione tu stesso con il comando "Action: Run" sulla schedule
• ONVIF Event ON - usalo ad esempio per avviare e interrompere la registrazione in base agli aggiornamenti dello stato logico ONVIF (richiede che il tipo di rilevamento movimento sia impostato su ONVIF)
• ONVIF Event OFF
• ONVIF Event Received (si attiva su qualsiasi evento ONVIF dalla telecamera)
• Photo Taken
• PTZ Preset Applied
• Reconnect Failed
• Recording Failed
• Recording Finished
• Recording Started
• Source Disconnected
• Source Reconnected
• Source Covered/ Tampered
• Switch Device Off
• Switch Device On
• System: Armed
• System: Disarmed
• System: No UI Connected - quando l'ultima sessione UI si chiude
• System: Profile Applied
• System: UI Connected - quando qualcuno apre un browser per visualizzare il tuo sistema
• System: UI Disconnected - quando la sessione viene chiusa (accade circa un minuto dopo che il browser si disconnette)
• Timelapse Started
• Timelapse Stopped

Eventuali eventi di plugin e attività personalizzate che hai aggiunto compaiono anche alla fine di questo elenco.

Per rilevare il loitering (persone o oggetti che rimangono nello stesso posto per un certo periodo di tempo) devi configurare quanto segue:

• Configura un server AI nelle impostazioni del server
• Aggiungi un Action per AI: Loiter Detected
• Imposta il tag che stai cercando - solitamente sarebbe person ma potresti usare car per rilevare automobili parcheggiate in un'area troppo a lungo o suitcase per bagagli abbandonati o un cat seduto sul tuo divano. Puoi usare più tag qui, ad esempio car,bus,truck. Per un elenco degli oggetti disponibili da trovare vedi l'elenco delle classi nel riconoscimento oggetti quando modifichi la telecamera.
• Specifica le zone in cui desideri cercare l'oggetto. Usa la scheda detector per disegnare le zone di movimento.
• Specifica il numero di secondi che tollerai per l'oggetto rilevato nella zona.
• Aggiungi Task da eseguire quando le condizioni sono soddisfatte.

Nota: Il detector loiter utilizza le impostazioni dal riconoscimento oggetti come check corners e overlay

Oltre agli eventi preimpostati, puoi creare eventi personalizzati aggiungendo Compiti. Una volta creato un compito, comparirà nell'elenco Eventi. Puoi quindi configurare un'Azione per rispondere a questo compito. I compiti possono essere attivati dalla pagina Live nell'interfaccia utente (selezionando una telecamera e cliccando sull'icona del compito in basso a sinistra) o tramite il comando Azione: Esegui trovato nella Pianificazione.

I compiti sono comandi che puoi allegare ai dispositivi per attivare manualmente Azioni. Le Azioni possono chiamare API di terze parti per eseguire compiti come aprire porte, accendere luci, riprodurre suoni, ecc. Per aggiungere, eliminare ed eseguire compiti, seleziona un dispositivo nella pagina Live e fai clic sull'icona del compito .

Configurazione di un compito:

• Inserisci del testo per descrivere il compito, ad esempio "Accendi Luci" e fai clic sul pulsante +. Fai clic su OK
• Fai clic per modificare il dispositivo utilizzando l'icona di modifica . Seleziona il pannello Azioni nell'editor utilizzando il menu in alto a destra.
• Aggiungi un'azione. Seleziona la condizione "Se" per essere il compito appena creato (i compiti sono mostrati in fondo all'elenco delle azioni disponibili) e quindi configura ciò che desideri che il compito faccia.
• Fai clic su OK
• Ora puoi attivare manualmente questa azione dalla visualizzazione live facendo clic sul pulsante dei compiti e cliccando sulla freccia Avanti accanto al compito.

Puoi anche attivare compiti tramite l'API di Agent DVR.

Le attività sono ciò che un'azione esegue quando si verifica il suo evento, dall'invio di un avviso email o notifica push al controllo della registrazione su altri dispositivi. L'elenco delle attività disponibili che è possibile eseguire (sotto Then) è:

• Alert - attiva un avviso sul dispositivo
• Beep - riproduce un bip attraverso l'altoparlante del computer Agent DVR
• Call URL - chiama qualsiasi URL con un token Auth opzionale. Puoi chiamare l'API Agent DVR qui, o inviare avvisi a Discord, Slack, ntfy e servizi simili (vedi Webhooks). Se hai Protect API selezionato nelle impostazioni del server dovrai fornire un'intestazione di autorizzazione. Per fare ciò dovrai aggiungere un Account Utente tramite Server Settings e inserire un valore Basic Auth Header:
  Generate

• Execute Command

copy %1 D:\

• Cloud upload current recording - carica la registrazione corrente al provider cloud del dispositivo
• Delay - pausa prima di eseguire l'attività successiva
• Enable / Disable Ask AI
• Enable / Disable Facial Recognition
• Enable / Disable LPR
• Enable / Disable Object Recognition
• Enable / Disable Patrol On (pattugliamento PTZ su un dispositivo)
• Enable / Disable Sound Recognition
• FTP upload current recording - carica la registrazione corrente al server FTP del dispositivo
• Log - scrivi un messaggio nel log di Agent DVR
• MQTT - invia un messaggio MQTT
• MQTT Image - invia un'immagine live grezzo in byte jpeg a un topic
• Network Message
• PTZ Command - sposta la fotocamera a un preset o esegui un comando PTZ
• Send Email (con allegati immagine opzionali)
• Send Email with Video (specifica durata - include un buffer dell'evento). v4.9.8.0+
• Send Push Notification
• Send SMS
• Set Motion Detector Area (seleziona l'Area che hai definito nel Detector)
• Show Message - visualizza messaggio sui browser web in visualizzazione
• Sound (on Agent DVR computer)
• Sound (through camera)
• Sound (through web browser)

• Start Recording On (some device) - registrerà fino all'arresto.
• Start RTMP Streaming
• Start Timelapse On (some device)
• Stop Recording On (some device)
• Stop RTMP Streaming
• Stop Timelapse On (some device)
• Switch Device On
• Switch Device Off
• System: Apply Profile - cambia Profile
• System: Arm
• System: Disarm
• Tag Recording - aggiungi un tag alla registrazione corrente
• Take Photo On (some device)
• Text to Speech (on Agent DVR computer - richiede un account iSpyConnect.com poiché il testo viene reso tramite chiamate webservice)
• Text to Speech (through web browser)

• Text to Speech (through camera)
• Trigger Adaptive Encode On (another device)
• Trigger Alert On (another device)
• Trigger Ask AI (another device)
• Trigger Audio Recognition (another device)
• Attiva Rilevamento (altro dispositivo)
• Attiva Riconoscimento Volti (altro dispositivo)
• Attiva LPR (altro dispositivo)
• Attiva Riconoscimento Oggetti (altro dispositivo)
• Attiva Registrazione (con timeout) (altro dispositivo). Questo registrerà fino all'impostazione del timeout della registrazione attivata nella scheda Registrazione. Questo timeout si ripristina ad ogni chiamata di azione di registrazione attivata.
• UI: Cambia Vista - passa le UI connesse a una vista diversa

I tag nei campi Quindi delle azioni di Agent DVR ti consentono di creare risposte dinamiche. È importante notare che alcuni tag sono specifici del contesto. Ad esempio, {FILENAME} non è disponibile per gli Alert Events, e {AI} non è disponibile se l'evento non è stato generato da un server AI.

• {ID}: L'ID dell'oggetto, visibile in alto a sinistra dell'editor quando modifichi una telecamera o un microfono in Agent.
• {OT}: L'ID del tipo di oggetto. 1 per Microfono, 2 per Telecamera.
• {FILENAME}: Il nome del file. Applicabile a eventi come Recording Started, Recording Finished e Snapshot Taken. È il percorso locale completo del file.
• {CURRENT_RECORDING}: Il nome del file della registrazione corrente. Percorso locale completo del file. (v5.0.6.0+)
• {MESSAGE}: Il nome dell'evento che ha attivato l'azione, ad es. "Manual Alert".
• {EVENT}: Il tipo di evento.
• {NAME}: Il nome del dispositivo (disponibile nella scheda Generale).
• {GROUPS}: I gruppi a cui appartiene il dispositivo (disponibili nella scheda Generale).
• {SERVER}: Il nome del server (da Impostazioni Server).
• {ALERTID}: L'ID dell'avviso (-1 se non c'è un avviso associato).
• {ALERTCOUNT}: Il conteggio degli avvisi del dispositivo.
• {TIME} e {DATE}: L'ora e la data attuali sul server.
• {RECORDED}: "REC" se il dispositivo è in registrazione, altrimenti vuoto.
• {TAGS}: I tag associati all'evento.
• {PLUGIN}: Il messaggio da un evento di plugin.

• {LOCATION}: La posizione della telecamera (disponibile nella scheda Generale).
• {LEVEL} e {DB}: Il livello di movimento o audio. {DB} è il livello in decibel per i dispositivi audio. Misurato quando l'azione viene eseguita. (v4.3.7.0+)
• {AI}: Un elenco separato da virgole di oggetti rilevati da AI, targhe da LPR, o volti rilevati da Riconoscimento Facciale.
• {AIJSON}: Dati JSON restituiti da AI o LPR.
• {ZONE}: La zona che ha attivato l'azione (vuota se non si utilizza AI o un elenco CSV per più zone come 1,2,3).
• {BASE64IMAGE}: URL dei dati dell'immagine in diretta. È il byte grezzo codificato in base64, quindi formatta come necessario ad es.

  p=data:image/jpeg;base64,{BASE64IMAGE}

  (Disponibile v4.5.9.0+). Immagine in diretta ridimensionata a 640px di larghezza.
• {BASE64IMAGE-LG}: URL dei dati dell'immagine in diretta. È il byte grezzo codificato in base64, quindi formatta come necessario ad es.

  p=data:image/jpeg;base64,{BASE64IMAGE-LG}

  (Disponibile v6.0.8.0+). Immagine in diretta ridimensionata a 1280px di larghezza.
• {BASE64IMAGE-NATIVE}: URL dei dati dell'immagine in diretta. È il byte grezzo codificato in base64, quindi formatta come necessario ad es.

  p=data:image/jpeg;base64,{BASE64IMAGE-NATIVE}

  (Disponibile v6.0.8.0+). Immagine in diretta nativa.

Ad esempio, con un evento AI: Face Recognized, un'attività Quindi Text to Speech con il testo

Hello {AI}

Nota: Se utilizzi i tag {BASE64IMAGE} con un evento correlato ai file come "Photo Taken" utilizzerà l'immagine a dimensione intera dal file. Altrimenti ridimensionerà l'immagine della vista in diretta corrente.

Una volta aggiunta un'azione, il controllo della tabella visualizza un riepilogo delle tue azioni. Un segno di spunta verde indica un'azione attiva.

Puoi utilizzare lo scheduler per abilitare/disabilitare azioni o attivare un'azione. Ad esempio, potresti pianificare un'azione per inviare un'email con due immagini a un'ora specifica.

In questo esempio, un'azione è stata aggiunta per inviare un'email con 2 immagini, impostata su nessun evento. Quindi è stata creata una voce di pianificazione per eseguire quella azione alle 8 del mattino di domenica e sabato.