Guida per l'utente: Configurazione Sorgenti video

I tipi di sorgente per le tue telecamere sono configurati nella scheda Generale, accessibile durante la modifica delle telecamere. Questa sezione è dove stabilisci e configuri le impostazioni di connessione per ciascuna delle tue telecamere. È un passaggio essenziale per garantire che Agent possa comunicare e interagire con successo con i tuoi dispositivi di telecamera.

Il tipo di origine Clone offre un modo diretto per replicare una telecamera, compresi i suoi flussi video e audio, in un nuovo dispositivo. Questa funzionalità ti consente di applicare diversi processi di movimento, regole di registrazione e avvisi sul dispositivo appena creato senza influire sulle impostazioni della telecamera originale. È importante notare che se la telecamera originale è disattivata, il dispositivo clonato perderà la sua connessione video.

• Telecamera: Seleziona il dispositivo che desideri clonare.

Le fonti video del desktop possono essere utilizzate su tutte le piattaforme tranne quando si esegue Agent come servizio Windows. Se è necessaria la cattura del desktop su Windows, è necessario eseguire Agent come applicazione console locale anziché come servizio. Per istruzioni su come passare a un'applicazione console locale, consultare Risoluzione dei problemi.

• Schermo: Scegli quale schermo registrare.
• Cattura del mouse: Abilita questa opzione per includere il puntatore del mouse nella cattura video.
• Area: Definisci un'area specifica dello schermo da catturare cliccando e trascinando (questa funzione è disponibile solo su Windows).

I dispositivi dummy forniscono un'opzione per utilizzare sia un colore solido che un'immagine come sfondo. Questo può essere utile per scopi di test, combinando video da altri dispositivi utilizzando la funzione Picture in Picture o lo streaming RTMP di telecamere multiple.

• Larghezza: Imposta la larghezza in pixel della telecamera dummy, ad esempio, 640.
• Altezza: Specifica l'altezza in pixel della telecamera dummy, ad esempio, 480.
• Frequenza fotogrammi: Definisci la frequenza fotogrammi della telecamera, come ad esempio 10 fps.
• Colore di sfondo: Scegli il colore per lo sfondo video.
• Immagine: Fornisci un percorso a un'immagine sul tuo disco locale. Questa immagine sovrascriverà il colore di sfondo.

La funzione DVR in Agent fornisce un modo per connettersi a dispositivi DVR comunemente utilizzati che non dispongono di endpoint video RTSP o HTTP standard.

• Modello: Seleziona da un elenco di modelli DVR supportati.
• Host: Inserisci l'indirizzo IP del tuo DVR all'interno della tua rete. Includi anche la porta su cui è in funzione, o lascia vuoto il campo porta per impostare la porta predefinita per il modello selezionato.
• Nome utente: Inserisci il nome utente utilizzato per accedere al tuo DVR.
• Password: Fornisci la password associata alle credenziali di accesso al tuo DVR.
• Canale: Specifica il numero di canale della telecamera sul tuo DVR. Ad esempio, se un DVR gestisce 4 telecamere, dovresti aggiungere ciascuna telecamera utilizzando i canali da 1 a 4 (o eventualmente da 0 a 3, a seconda della configurazione dei canali del DVR).

Il tipo di origine file in Agent ti consente di utilizzare un video pre-registrato e riprodurlo come se fosse un feed di telecamera live.

• Percorso File: Fornisci il percorso locale del file video che desideri utilizzare.
• Ciclo: Abilita questa opzione per riprodurre automaticamente il file una volta raggiunta la fine.

Il tipo di sorgente della telecamera di rete è progettato per connettersi a telecamere di rete (IP), utilizzando FFmpeg per la connessione. Se FFmpeg non riesce a stabilire una connessione, è possibile utilizzare VLC come alternativa installandolo e selezionandolo come decoder.

• Nome utente: Il tuo nome utente di accesso alla telecamera (diverso dal tuo nome utente iSpyConnect).
• Password: La password per accedere alla tua telecamera (non la password iSpyConnect).
• URL in diretta: L'URL per lo streaming video in diretta dalla tua telecamera. Se la tua telecamera fornisce uno streaming a bassa risoluzione, utilizza questo URL qui. Utilizza il pulsante "..." per avviare una procedura guidata che aiuta a scoprire le connessioni disponibili.
• URL di registrazione: L'URL per lo streaming video principale (di registrazione) dalla tua telecamera. Se la tua telecamera offre uno streaming ad alta risoluzione, utilizza questo URL qui. Il pulsante "..." avvia una procedura guidata per trovare connessioni disponibili.

Il tipo di origine JPEG/Immagine è progettato per connettersi a fonti JPEG o basate su altre immagini.

• Nome utente: Inserisci il nome utente della telecamera (non il tuo nome utente iSpyConnect).
• Password: Inserisci la password della telecamera (non la tua password iSpyConnect).
• URL/Percorso: Specifica l'URL di connessione per il feed di immagini in tempo reale dalla tua telecamera. Il pulsante "..." avvia una procedura guidata per aiutarti a trovare connessioni disponibili.
• Intervallo di Ricarica: Per immagini statiche (come GIF meteorologiche che cambiano solo occasionalmente), imposta un intervallo di ricarica per controllare periodicamente nuove immagini. Per feed JPEG e video, questo intervallo dovrebbe essere impostato su 0.

Collegati alle telecamere USB o ad altre sorgenti video hardware locali utilizzando questa opzione.

• Dispositivo: Seleziona dalla lista dei dispositivi video locali rilevati.
• Risoluzione Video: Scegli la risoluzione video desiderata.
• Audio: Opzionalmente, seleziona un dispositivo audio da abbinare al dispositivo video.

Su Linux, le opzioni del dispositivo potrebbero essere vuote, spesso a causa di problemi di autorizzazioni. Per risolvere questo problema, aggiungi il tuo utente al gruppo di autorizzazioni video con i seguenti comandi: sudo adduser TUO_USERNAME video
sudo usermod -a -G video TUO_USERNAME
...Poi riavvia il computer.

Se il tuo dispositivo viene rilevato ma non sono disponibili opzioni di risoluzione video, puoi aggiungere manualmente l'impostazione della risoluzione nelle impostazioni ffmpeg sotto Opzioni, ad esempio:

video_size=720x576

Collegarsi alle fonti MJPEG. Mentre l'opzione della telecamera IP è tipicamente preferita, l'opzione MJPEG funge da backup nei casi in cui alcune telecamere sono incompatibili con la configurazione standard della telecamera IP.

• Nome utente: Inserisci il tuo nome utente di accesso per la telecamera (nota: questo è diverso dal tuo nome utente iSpyConnect).
• Password: Fornisci la password per la tua telecamera (non la password iSpyConnect).
• URL Live: Specifica l'URL per lo streaming video in diretta dalla tua telecamera. Utilizza il pulsante "..." per accedere a un assistente che ti aiuta a trovare le connessioni disponibili.
• URL Registrazione: Inserisci l'URL per lo streaming di registrazione dalla tua telecamera. Di nuovo, il pulsante "..." può aiutarti a scoprire le connessioni disponibili.
• Usa Decoder Interno: Il decoder FFmpeg utilizzato da Agent potrebbe incontrare difficoltà con alcuni flussi che hanno marcatori di confine non standard. Abilita questa opzione per passare al decoder interno di Agent. Nota: Utilizzare il decoder interno significa che l'URL di registrazione non verrà utilizzato.

Accedi alle fonti dell'Interfaccia Dispositivo di Rete (NDI) per lo streaming video senza interruzioni su una rete. Per dettagli completi su come lavorare con le fonti NDI, consulta ulteriori informazioni su NDI.

• Fonte: Seleziona dalla lista delle fonti NDI rilevate. È importante scegliere una fonte dalla lista rilevata piuttosto che digitarla manualmente. Consulta le impostazioni NDI per includere endpoint per rilevare le fonti remote.
• Livello Audio: Regola il livello audio proveniente dalla fonte NDI selezionata.

Questa opzione fornisce supporto all'integrazione per le telecamere Nest o DropCam. Per abilitare l'accesso di Agent a queste telecamere, sarà necessario rendere le telecamere accessibili pubblicamente.

• URL Pubblico: Inserisci l'URL dove la tua telecamera può essere accessibile pubblicamente.
• Ottieni URL Video: Clicca su questo pulsante e Agent troverà il link diretto allo streaming video della tua telecamera.
• URL Video: Questo campo verrà automaticamente compilato dopo aver cliccato sul pulsante 'Ottieni URL Video'.

Il tipo di sorgente Web Browser rende un browser web come una sorgente video all'interno di Agent. Se non è già disponibile, scaricherà e installerà automaticamente una versione headless di Chromium per facilitare questa funzione.

• Nome utente: Inserisci il nome utente per accedere alla pagina web se richiesto.
• Password: Inserisci la password per accedere alla pagina web se richiesto.
• Larghezza: La larghezza della finestra del browser.
• Altezza: L'altezza della finestra del browser.
• URL: Inserisci l'URL da caricare (ad esempio, https://www.esempio.com).
• Intervallo di ricarica: Determina con quale frequenza la pagina dovrebbe essere ricaricata.

Per forzare il ricaricamento di una pagina, puoi abilitare l'opzione Prevenire la cache JPEG trovata nelle impostazioni avanzate.

Per impostare i cookie per il browser, utilizza l'opzione Cookie nelle impostazioni avanzate. Ad esempio, per impostare un cookie chiamato 'mycookie' con il valore 'myvalue', inserisci 'mycookie=myvalue' nel campo Cookie. (v5550+)

Agent offre supporto integrato per quasi tutte le telecamere compatibili con ONVIF. Se riscontri problemi di connessione con i tuoi dispositivi ONVIF, controlla i log su /logs.html per eventuali errori.

• Nome utente: Inserisci il nome utente della tua telecamera (non il nome utente di iSpyConnect).
• Password: Fornisci la password della tua telecamera (non la password di iSpyConnect).
• URL del servizio: Questo è l'URL per la definizione del servizio della tua telecamera. Agent di solito può rilevarli automaticamente. Per le versioni precedenti alla v4, inizia a digitare "http" per vedere gli indirizzi scoperti. Per le versioni dalla 4 in poi, fai clic sui dispositivi rilevati per popolare l'URL del servizio. Se il tuo dispositivo non viene trovato automaticamente, puoi aggiungerlo manualmente. Dovrebbe assomigliare a 'http://INDIRIZZOIP:PORTA/onvif/device_service'.
• Sovrascrivi porta RTSP: Sovrascrivi la porta RTSP della tua telecamera se necessario, ad esempio quando fai il port forwarding su una rete diversa con una diversa porta RTSP. In genere, lascia questo valore come 0. Questa porta è utilizzata per lo streaming video e audio in diretta dalla tua telecamera.
• Sovrascrivi porta HTTP: Sovrascrivi la porta HTTP della tua telecamera se fai il port forwarding su un'altra rete con una diversa porta HTTP. Di solito, questo valore dovrebbe essere lasciato come 0. Questa porta serve per ottenere immagini JPEG dalla tua telecamera.
• Timeout: Imposta la durata per cui Agent proverà a connettersi alla tua telecamera prima di scadere il tempo limite.
• Scopri: Clicca su questo pulsante per consentire ad Agent di connettersi alla tua telecamera utilizzando le credenziali fornite e recuperare le opzioni di connessione video, popolando gli URL sottostanti.
• URL in diretta: Dopo la scoperta, seleziona uno streaming video a bassa risoluzione per la visualizzazione in diretta e il rilevamento dei movimenti.
• URL sovrascritto: Opzionalmente, aggiungi un URL sovrascritto per l'URL in diretta se lo preferisci rispetto alle opzioni scoperte.
• URL di registrazione: Dopo la scoperta, scegli uno streaming video ad alta risoluzione per la registrazione grezza.
• URL sovrascritto: Opzionalmente, aggiungi un URL sovrascritto per l'URL di registrazione se lo preferisci rispetto alle opzioni scoperte.
• Usa URI dello snapshot per le foto: Opta per scaricare le foto direttamente dalla telecamera anziché generare immagini dallo streaming video in diretta.
• Ricarica forzata: Se la tua telecamera aggiunge un token univoco agli URL dello streaming video validi solo per una sessione, abilita questa opzione per ottenere un nuovo URL video per ogni tentativo di connessione, il che può aiutare con i problemi di riconnessione.

Le opzioni avanzate in Agent offrono strumenti aggiuntivi per una connettività potenziata con i tuoi dispositivi. Per accedere a queste opzioni, vai su Modifica Telecamera, seleziona la scheda Generale, clicca per configurare la fonte video e poi scegli Avanzate nel menu a discesa.

• Decodifica GPU: Se hai più dispositivi GPU, specifica quale indice GPU utilizzare per decodificare lo stream video.
• Decodificatore: Le opzioni includono CPU, GPU, VLC (se installato) o NONE (disponibile dalla versione v3.9.8.0+). VLC può decodificare flussi che FFmpeg (usato da Agent) potrebbe non riuscire a decodificare. Cambiare il decodificatore richiede di disabilitare/abilitare la telecamera. Per le opzioni del decodificatore GPU, vedi Impostazioni avanzate della fonte video. None è disponibile solo per i tipi di fonte IP Camera e salta la decodifica video, richiedendo quindi la modalità di registrazione grezza. Nota: Con NONE selezionato, la rilevazione del movimento e il filtraggio degli avvisi AI non funzioneranno.
  Se FFmpeg non riesce a decodificare alcuni flussi RTSP da determinati modelli di telecamera, generando errori come "Dati non validi trovati durante l'elaborazione dell'input", prova a passare il decodificatore a VLC (Installa VLC da qui e riavvia Agent per la rilevazione).
• Decodificatore GPU: Seleziona il decodificatore GPU hardware specifico da utilizzare. Scegli predefinito per utilizzare l'impostazione predefinita.
• Cookies: Aggiungi eventuali cookie necessari per accedere allo stream video della tua telecamera.
• Autenticazione di base: Attiva o disattiva l'Autenticazione di base per il login alla telecamera.
• Usa HTTP 1.0: Forza l'uso di HTTP 1.0 per la compatibilità con le telecamere più vecchie.
• Intestazioni: Includi eventuali intestazioni aggiuntive richieste per accedere allo stream video della tua telecamera.
• User Agent: Imposta l'User Agent per la connessione se specificato dalla tua telecamera.
• Timeout Connessione: Imposta il tempo massimo di attesa per una risposta dalla telecamera prima del timeout.
• Intervallo Riconnessione: Configura un intervallo periodico per chiudere e riaprire la connessione alla telecamera.
• Strategia Riconnessione: Scegli l'orario per i tentativi di riconnessione se la connessione alla telecamera viene persa. Le opzioni includono un orario elastico (2, 5, 10, 30 secondi) o riconnessione immediata.
• Usa registrazione stream quando massimizzato: Abilita la visualizzazione dello stream di registrazione ad alta definizione in live view quando massimizzato nella live viewer.
  Dipende da Generale - Decodificatore non impostato su VLC e Registrazione - Codificatore impostato su Registra Stream Grezzo. Nella v5+ questa opzione è stata spostata nella scheda Fonte Video.
• Opzioni VLC: Specifica eventuali opzioni aggiuntive da passare a VLC quando ti colleghi alla tua telecamera.

Queste sono impostazioni generali di FFmpeg che ti permettono di ottimizzare come Agent interagisce con le tue telecamere. Per accedere a queste impostazioni, vai su Modifica Telecamera, seleziona la scheda Generale, clicca per configurare la sorgente video e scegli FFmpeg dal menu a discesa.

• Buffer: Questa impostazione determina la dimensione del buffer in tempo reale utilizzata da FFmpeg per memorizzare e elaborare il video. Una dimensione del buffer più piccola porta a un video più in tempo reale ma aumenta il rischio di errori. L'impostazione consigliata è 2000kb, anche se flussi ad alta risoluzione potrebbero richiedere un buffer più grande.
• Modalità RTSP: Impostando questa opzione su Auto permette a FFmpeg di selezionare la modalità di trasporto. Se si riscontrano errori, prova a passare a TCP. Per connessioni cablate stabili, UDP è preferito a causa di un minor overhead di elaborazione.
• Modalità di Ridimensionamento: Seleziona una modalità di ridimensionamento per FFmpeg. La modalità predefinita è Fast Bilinear.
• Trova il Miglior Flusso: Abilita questa opzione per permettere a FFmpeg di scegliere automaticamente i migliori flussi video e audio dalla connessione.
• Indice Flusso Video: Se 'Trova il Miglior Flusso' non è selezionato, puoi selezionare manualmente l'indice del flusso video.
• Indice Flusso Audio: Simile all'indice del flusso video, permette la selezione manuale del flusso audio quando 'Trova il Miglior Flusso' è disabilitato.
• Preferisci TCP: Abilitando questa opzione, FFmpeg preferirà le connessioni TCP alla tua telecamera, fornendo correzione degli errori a discapito di un aumento dell'utilizzo della CPU e del traffico di rete.
• Durata di Analisi: Specifica la durata (in secondi) per cui FFmpeg analizzerà i flussi per determinare i codec e selezionare i migliori flussi. 0 indica una determinazione automatica.
• Dimensione Sonda: La dimensione (in kilobyte) per la sonda iniziale di rilevamento del formato da parte di FFmpeg. 0 per il rilevamento automatico.
• Ritardo Massimo: Questa impostazione è applicabile ai flussi RTSP e RTMP, e indica la tolleranza al ritardo per i pacchetti fuori sequenza. Valori più alti riducono gli errori ma possono aumentare la latenza. 0 per impostazioni automatiche. Nota: Se impostato su 0, 'Dimensione Coda Riordinamento' sarà ignorata.
• Dimensione Coda Riordinamento: Determina il numero di pacchetti memorizzati in memoria. Dimensioni più grandi possono ridurre la corruzione del flusso ma aumentare l'utilizzo della memoria.
• Conteggio Thread: Imposta il numero di thread per la decodifica del flusso. 0 = automatico. Meno thread possono ridurre il ritardo.
• Opzioni: Spazio per inserire eventuali opzioni aggiuntive di FFmpeg che desideri applicare.

Risoluzione dei Problemi di FFmpeg