Україна
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 і як практичний приклад застосування.
Системні вимоги
ОС | Мінімальна версія |
|---|---|
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 на камеру.
