Manuale utente Ajax Video SDK

Ajax Video SDK è un toolkit progettato per integrare la videosorveglianza Ajax in software di terze parti. Consente agli sviluppatori di trasmettere i flussi video in diretta e registrati dai dispositivi video Ajax e di gestire i flussi video all'interno delle proprie interfacce.

Questo toolkit è destinato agli sviluppatori software che hanno bisogno di integrare video Ajax nelle loro app e garantire una trasmissione video stabile.

Panoramica

Ajax Video SDK consente agli sviluppatori di trasmettere i flussi in diretta e registrati dai dispositivi video Ajax. Utilizza un'architettura a due livelli:

• REST API: utilizzata per autenticare e recuperare risorse (spazi, dispositivi video, canali e token video).

• gRPC SDK: usata per avviare e controllare i flussi video con token ottenuti dalla REST API.

Ajax Video SDK avvia un servizio gRPC locale che gestisce la trasmissione video. L'app si connette al servizio per avviare e controllare i flussi video e riceve un URL RTSP che può essere utilizzato per riprodurre il video in un lettore compatibile.

Caratteristiche principali

Ajax Video SDK fornisce le seguenti funzionalità:

1. Trasmissione in diretta tramite RTSP.

2. Riproduzione dell'archivio tramite RTSP.

3. Controllo dell'archivio:

   • selezione di un intervallo di tempo,

   • navigazione verso una data e un'ora specifiche,

   • navigazione in un archivio tramite un calendario (l’utente naviga l’archivio tramite calendario senza ricaricare la pagina),

   • recupero dei metadati per l'intervallo selezionato, inclusa una timeline e i rilevamenti.

4. Selezione della qualità della trasmissione (MAIN/SUB).

Struttura di Ajax Video SDK

L'archivio Ajax Video SDK include la libreria SDK, i file .proto che definiscono gRPC API e app demo C++ con codice sorgente che possono essere utilizzate per testare le funzionalità dell'SDK e fungere da esempio pratico del suo utilizzo.

Requisiti del sistema

Ajax Video SDK è implementato in C/C++ e può essere integrato direttamente nelle app C++.

Il toolkit può essere utilizzato anche con qualsiasi linguaggio di programmazione che supporti gRPC: è necessario eseguire l'SDK come servizio locale e connettersi ad esso tramite gRPC.

Flusso di integrazione

Per accedere ad Ajax Video SDK, si prega di compilare il modulo di richiesta. Il team di Ajax vi contatterà e vi fornirà un archivio contenente i file SDK per il vostro sistema operativo.

Per iniziare a utilizzare Ajax Video SDK:

1. Autenticarsi utilizzando uno dei metodi supportatis

2. Trovare lo spazio richiesto.

3. Utilizzare l’API Ajax per ottenere gli identificativi richiesti dei nodi (edge) e dei canali. È possibile richiedere l'elenco di tutti i dispositivi presenti nello spazio e identificare il canale tramite il suo nome.

4. Assicurarsi che il vostro account disponga delle autorizzazioni necessarie per accedere al canale selezionato. La trasmissione video è disponibile solo per i canali a cui l'utente o l'azienda ha accesso.

5. Generare un token di accesso per il lettore video utilizzando gli identificativi richiesti dei nodi (edge) e dei canali.

6. Inizializzare l'SDK per avviare un server gRPC locale.

7. Aprire un flusso gRPC (LiveStreaming o ArchiveStreaming) utilizzando il token video generato.

8. Ottenere un URL RTSP dall'SDK e utilizzarlo per riprodurre video in un lettore compatibile.

9. Mantenere la sessione aggiornando i token di sessione e video prima che scadano.

Metodi di autenticazione

Ajax Video SDK supporta due metodi di autenticazione:

• Autenticazione utente: richiede l'accesso e fornisce un token di sessione e un token di aggiornamento.

• Token aziendale: consente l'accesso senza effettuare il login utilizzando un token preassegnato.

L'accesso ai flussi video dipende dai permessi associati all'utente o all'azienda autenticati. I permessi vengono convalidati da Ajax Cloud. Se l'utente o l'azienda non ha accesso a un canale specifico, non è possibile recuperare il flusso video.

Il metodo di autenticazione definisce come le richieste API sono autorizzate e quali endpoint vengono utilizzati.

Gestione dei token

I token utilizzati in Ajax Video SDK hanno una durata limitata e devono essere aggiornati:

• Token di sessione: deve essere aggiornato periodicamente (circa ogni 30 minuti).

• Token video: deve essere aggiornato durante una trasmissione attiva tramite la connessione gRPC.

La mancata attivazione dei token potrebbe causare interruzioni nella trasmissione video.

Trasmissione video

Il processo di trasmissione video è il seguente:

App → REST API → SDK (gRPC) → RTSP → Lettore video.

Ajax Video SDK gestisce la comunicazione con i Servizi Ajax e fornisce un endpoint di trasmissione locale, mentre l'app si occupa della riproduzione.

Il numero di flussi video simultanei è limitato: fino a 16 flussi per utente e fino a 2 flussi per telecamera.