Italia
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.
Per accedere ad Ajax Video SDK, si prega di compilare il modulo di richiesta.
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à:
Trasmissione in diretta tramite RTSP.
Riproduzione dell'archivio tramite RTSP.
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.
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
OS | Versione minima |
|---|---|
Windows (64-bit) | Windows 10 |
macOS | macOS 11 |
Linux | Ubuntu 24.04 |
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.
Le istruzioni dettagliate per l'integrazione sono incluse nel file README fornito con l'SDK.
Per iniziare a utilizzare Ajax Video SDK:
Autenticarsi utilizzando uno dei metodi supportatis
Trovare lo spazio richiesto.
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.
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.
Generare un token di accesso per il lettore video utilizzando gli identificativi richiesti dei nodi (edge) e dei canali.
Inizializzare l'SDK per avviare un server gRPC locale.
Aprire un flusso gRPC (LiveStreaming o ArchiveStreaming) utilizzando il token video generato.
Ottenere un URL RTSP dall'SDK e utilizzarlo per riprodurre video in un lettore compatibile.
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.
