España
Ajax Video SDK es un kit de herramientas diseñado para integrar la videovigilancia Ajax en software de terceros. Permite a los desarrolladores transmitir vídeo en directo y grabado desde dispositivos de vídeo Ajax y gestionar flujos de vídeo dentro de sus propias interfaces.
Este kit de herramientas está destinado a desarrolladores de software que necesitan integrar vídeo Ajax en sus apps y garantizar una transmisión de vídeo estable.
Para acceder a Ajax Video SDK, rellene el formulario de solicitud.
Descripción general
Ajax Video SDK permite a los desarrolladores transmitir vídeo en directo y grabado desde dispositivos de vídeo Ajax. Utiliza una arquitectura de dos niveles:
REST API: se utiliza para autenticar y recuperar recursos (espacios, dispositivos de vídeo, canales y tokens de vídeo).
gRPC SDK: se utiliza para iniciar y controlar flujos de vídeo con tokens obtenidos de la REST API.
Ajax Video SDK lanza un servicio local gRPC que gestiona la transmisión de vídeo. La app se conecta al servicio para iniciar y controlar flujos de vídeo y recibe una URL RTSP que puede utilizarse para reproducir vídeo en un reproductor compatible.
Características clave
Ajax Video SDK ofrece las siguientes funciones:
Transmisión en directo vía RTSP.
Reproducción del repositorio vía RTSP.
Control del repositorio:
selección de un intervalo de tiempo,
navegación a una fecha y hora concretas,
navegación por el repositorio mediante un calendario (navegación del lado del cliente),
recuperación de metadatos para el intervalo seleccionado, incluyendo una línea de tiempo y detecciones.
Selección de la calidad del flujo (Flujo principal/Subflujo).
Estructura del Ajax Video SDK
El repositorio de Ajax Video SDK incluye la biblioteca SDK, archivos .proto que definen la API gRPC y apps de demostración en C++ con código fuente que pueden utilizarse para probar la funcionalidad del SDK y servir como ejemplo práctico de su uso.
Requisitos del sistema
Sistema operativo | Versión mínima |
|---|---|
Windows (64-bit) | Windows 10 |
macOS | macOS 11 |
Linux | Ubuntu 24.04 |
Ajax Video SDK está implementado en C/C++ y puede integrarse directamente en apps C++.
El kit de herramientas también puede utilizarse con cualquier lenguaje de programación que admita gRPC: es necesario ejecutar el SDK como un servicio local y conectarse a él mediante gRPC.
Proceso de integración
Para acceder a Ajax Video SDK, rellene el formulario de solicitud. El equipo de Ajax se pondrá en contacto con usted para enviarle un paquete que contiene los archivos SDK para su sistema operativo.
Las instrucciones de integración paso a paso se incluyen en el archivo README que acompaña al SDK.
Para empezar a utilizar Ajax Video SDK:
Autentíquese utilizando uno de los métodos soportados.
Busque el espacio necesario.
Recupere los ID de edge y de canal necesarios a través de la API de Ajax. Puede solicitar la lista de todos los dispositivos del espacio e identificar el canal por su nombre.
Asegúrese de que su cuenta tiene los permisos necesarios para acceder al canal seleccionado. La transmisión de vídeo solo está disponible para los canales a los que el usuario o la empresa tienen acceso.
Genere un token de acceso al reproductor de vídeo utilizando los ID de edge y de canal necesarios.
Inicialice el SDK para iniciar un servidor gRPC local.
Abra un flujo gRPC (LiveStreaming o ArchiveStreaming) utilizando el token de vídeo generado.
Obtenga una URL RTSP del SDK y utilícela para reproducir el vídeo en un reproductor compatible.
Mantenga la sesión actualizando los tokens de sesión y de vídeo antes de que caduquen.
Métodos de autenticación
Ajax Video SDK admite dos métodos de autenticación:
Autenticación de usuario: requiere iniciar sesión y proporciona un token de sesión y un token de actualización.
Token de empresa: permite el acceso sin iniciar sesión mediante un token emitido previamente.
El acceso a los flujos de vídeo depende de los permisos asociados al usuario o a la empresa autenticados. Los permisos se validan en el lado de Ajax Cloud. Si el usuario o la empresa no tienen acceso a un canal específico, no se puede recuperar el flujo.
El método de autenticación define cómo se autorizan las solicitudes de API y qué puntos finales se utilizan.
Gestión de tokens
Los tokens utilizados en Ajax Video SDK tienen una vida útil limitada y deben actualizarse:
Token de sesión: debe actualizarse periódicamente (aproximadamente cada 30 minutos).
Token de vídeo: debe actualizarse durante una transmisión activa a través de la conexión gRPC.
Si no se actualizan los tokens, la transmisión de vídeo podría interrumpirse.
Proceso de transmisión de vídeo
El proceso de transmisión de vídeo es el siguiente:
App → REST API → SDK (gRPC) → RTSP → Reproductor de vídeo.
Ajax Video SDK gestiona la comunicación con los servicios Ajax y proporciona un punto final de transmisión local, mientras que la app se encarga de la reproducción.
El número de flujos de vídeo simultáneos es limitado: hasta 16 flujos por usuario y hasta 2 flujos por cámara.
