Україна
Ajax Video SDK — это набор инструментов для интеграции видеонаблюдения Ajax в сторонний софт. Он позволяет разработчикам транслировать видео и записи с видеоустройств Ajax в реальном времени, а также управлять видеопотоками в собственном интерфейсе.
Набор инструментов предназначен для разработчиков, которым нужно интегрировать видео Ajax в свой софт и обеспечить стабильную передачу видео.
Чтобы получить доступ к Ajax Video SDK, заполните эту форму.
Обзор
Ajax Video SDK позволяет разработчикам транслировать видео в реальном времени и воспроизводить архив с видеоустройств Ajax. Инструмент использует двухуровневую архитектуру:
REST API — применяется для аутентификации и получения ресурсов, таких как пространства, видеоустройства, каналы и токены видео.
gRPC SDK — применяется для запуска и управления видеопотоками с помощью токенов, полученных через REST API.
Ajax Video SDK запускает локальный gRPC-сервис, который управляет передачей видео. Софт для мониторинга подключается к сервису для запуска и управления видеопотоками и получает RTSP-адрес, который можно использовать для воспроизведения видео в совместимом плеере.
Особенности
Ajax Video SDK предоставляет следующие возможности:
Прямые трансляции через RTSP.
Воспроизведение архива через RTSP.
Управление архивом:
выбор временного диапазона,
переход к определенной дате или времени,
навигация по архиву по календарю (навигация на стороне клиента),
получение метаданных для выбранного диапазона включая шкалу времени и события обнаружения.
Выбор качества видеопотока (MAIN/SUB).
Структура Ajax Video SDK
Архив Ajax Video SDK содержит библиотеку SDK, .proto-файлы, определяющие gRPC API, и демософт на C++ с исходным кодом, который можно использовать для проверки работы SDK и как практический пример применения.
Системные требования
OS | Минимальная версия |
|---|---|
Windows (64-bit) | Windows 10 |
macOS | macOS 11 |
Linux | Ubuntu 24.04 |
Ajax Video SDK реализован на C/C++, и его можно интегрировать непосредственно в софт, написанный на C++.
Набор инструментов также можно использовать с любым языком программирования, поддерживающим gRPC: нужно запустить SDK как локальный сервис и подключиться к нему через gRPC.
Процесс интеграции
Чтобы получить доступ к Ajax Video SDK, заполните эту форму. Команда Ajax свяжется с вами и отправит архив с файлами SDK для вашей операционной системы.
Пошаговое руководство по интеграции содержится в файле README, который вы получите вместе с Ajax Video SDK.
Чтобы начать использовать Ajax Video SDK:
Пройдите аутентификацию, используя один из доступных способов.
Выберите нужное пространство.
Найдите необходимые идентификаторы видеоустройства (edge) и канала через Ajax API. Можно запросить список всех устройств в пространстве и идентифицировать канал по его названию.
Убедитесь, что ваша учетная запись имеет необходимые права для доступа к выбранному каналу. Передача видео доступна только для каналов, к которым имеет доступ пользователь или компания.
Сгенерируйте токен доступа к воспроизведению видео, используя необходимые идентификаторы видеоустройства и канала.
Запустите локальный gRPC-сервер с помощью SDK.
Откройте поток gRPC (LiveStreaming или ArchiveStreaming) с помощью сгенерированного токена видео.
Используйте полученный из SDK RTSP URL-адрес для воспроизведения видео в совместимом проигрывателе.
Обновляйте токены сеанса и видео до истечения их срока действия, чтобы поддерживать сеанс.
Способы аутентификации
Ajax Video SDK поддерживает два способа аутентификации:
Аутентификация пользователя — требует входа в систему и предоставляет токен сеанса и токен обновления.
Токен компании — позволяет получить доступ без входа в систему с помощью предварительно выданного токена.
Доступ к видеопотокам зависит от прав доступа, связанных с аутентифицированным пользователем или компанией. Права доступа проверяются на стороне Ajax Cloud. Если пользователь или компания не имеет доступа к конкретному каналу, доступ к потоку получить невозможно.
Способ аутентификации определяет, как авторизуются запросы API и какие конечные точки используются.
Управление токенами
Токены, используемые в Ajax Video SDK, имеют ограниченный срок действия, поэтому их нужно обновлять:
Токен сеанса — нужно обновлять периодически (приблизительно каждые 30 минут).
Токен видео — нужно обновлять во время активной передачи видео через gRPC-соединение.
Несвоевременное обновление токенов может привести к прерыванию передачи видео.
Процесс передачи видео
Передача видео происходит следующим образом:
App → REST API → SDK (gRPC) → RTSP → Видеопроигрыватель.
Ajax Video SDK управляет связью с сервисами Ajax и обеспечивает локальную конечную точку передачи видео, в то время как приложение отвечает за воспроизведение.
Количество одновременных видеопотоков ограничено: до 16 на пользователя и до 2 на камеру.
