Nederland
Ajax Video SDK is een toolkit waarmee u Ajax-videobewaking kunt integreren in software van derden. Hiermee kunnen ontwikkelaars live en opgenomen video streamen vanaf Ajax-videoapparaten en videostreams beheren in hun eigen interfaces.
Deze toolkit is bedoeld voor softwareontwikkelaars die Ajax-video's in hun apps willen integreren en een stabiele videostreaming moeten kunnen garanderen.
Vul alstublieft het aanvraagformulier in om toegang te krijgen tot de Ajax Video SDK.
Overzicht
Met Ajax Video SDK kunnen ontwikkelaars live en opgenomen video's streamen van Ajax-videoapparaten. Het maakt gebruik van een tweelaagse architectuur:
REST API: wordt gebruikt om te authenticeren en bronnen op te halen (spaces, videoapparaten, kanalen en videotokens).
gRPC SDK: wordt gebruikt om videostreams te starten en te beheren met tokens die verkregen zijn via de REST API.
Ajax Video SDK start een lokale gRPC-service die het videostreamen beheert. De app maakt verbinding met de service om videostreams te starten en te beheren en ontvangt een RTSP-URL die kan worden gebruikt om video af te spelen in een compatibele speler.
Belangrijkste kenmerken
Ajax Video SDK biedt de volgende functies:
Live streaming via RTSP.
Archiefweergave via RTSP.
Archiefbeheer:
selecteer een tijdbereik,
navigeer naar een specifieke datum en tijd,
navigeer door een archief met een kalender (navigatie aan clientzijde),
metadata ophalen voor het geselecteerde bereik, inclusief een tijdlijn en detecties.
Selecteer de streamkwaliteit (MAIN/SUB).
Structuur van de Ajax Video SDK
Het Ajax Video SDK-archief bevat de SDK-bibliotheek, .proto-bestanden die de gRPC-API definiëren, en C++ demo-apps met broncode die kunnen worden gebruikt om de SDK te testen en die gebruikt kunnen worden als een praktisch voorbeeld hoe de SDK te gebruiken.
Systeemvereisten
OS | Minimale versie |
|---|---|
Windows (64-bit) | Windows 10 |
macOS | macOS 11 |
Linux | Ubuntu 24.04 |
De Ajax Video SDK is geïmplementeerd in C/C++ en kan direct in C++-applicaties worden geïntegreerd.
De toolkit kan ook worden gebruikt met elke programmeertaal die gRPC ondersteunt: het is vereist om de SDK als een lokale service uit te voeren en er via gRPC verbinding mee te maken.
Integratiestroom
Vul het aanvraagformulier in om toegang te krijgen tot Ajax Video SDK. Het Ajax-team zal contact met u opnemen en een archief met SDK-bestanden voor uw besturingssysteem leveren.
De stapsgewijze integratie-instructies zijn te vinden in het README-bestand dat bij de SDK wordt geleverd.
Om de Ajax Video SDK te gebruiken:
Authenticeer met behulp van een van de ondersteunde methoden.
Vind de gewenste space.
Haal de benodigde ID's van edge en het kanaal op via de Ajax API. U kunt de lijst van alle apparaten in de space opvragen en het kanaal identificeren via de naam.
Zorg ervoor dat uw account de vereiste rechten heeft om toegang te krijgen tot het geselecteerde kanaal. Videostreamen is alleen beschikbaar voor kanalen waarvoor de gebruiker of het bedrijf toegang heeft.
Genereer een toegangstoken voor de videospeler via de vereiste ID van edge en van het kanaal.
Start de SDK om een lokale gRPC-server te starten.
Open een gRPC-stream (LiveStreaming of ArchiveStreaming) via de gegenereerde videotoken.
Krijg een RTSP-URL van de SDK en gebruik deze om video's af te spelen in een compatibele speler.
Onderhoud de sessie door de sessie- en videotokens te vernieuwen voordat ze verlopen.
Verificatiemethoden
De Ajax Video SDK ondersteunt twee authenticatiemethoden:
Gebruikersauthenticatie: vereist dat u inlogt en levert een sessietoken en een vernieuwingstoken op.
Bedrijfstoken: geeft toegang zonder in te loggen via een vooraf afgegeven token.
De toegang tot videostreams is afhankelijk van de rechten die zijn gekoppeld aan de geauthenticeerde gebruiker of het bedrijf. Rechten worden gevalideerd aan de zijde van Ajax Cloud. Als de gebruiker of het bedrijf geen toegang heeft tot een specifiek kanaal, kan de stream niet worden opgevraagd.
De authenticatiemethode bepaalt hoe API-verzoeken worden geautoriseerd en welke eindpunten worden gebruikt.
Tokenbeheer
Tokens die worden gebruikt in de Ajax Video SDK hebben een beperkte levensduur en moeten worden vernieuwd:
Sessietoken: moet regelmatig worden vernieuwd (ongeveer elke 30 minuten).
Video-token: moet tijdens een actieve stream via de gRPC-verbinding worden vernieuwd.
Als de tokens niet worden vernieuwd, kan de videostreaming worden onderbroken.
Videostreaming
Het proces voor videostreaming verloopt als volgt:
App → REST API → SDK (gRPC) → RTSP → Videospeler.
Ajax Video SDK handelt de communicatie met Ajax Services af en biedt een lokaal eindpunt voor streaming, terwijl de app verantwoordelijk is voor de weergave.
Het aantal gelijktijdige videostreams is beperkt: tot 16 streams per gebruiker en tot 2 streams per camera.
