Как подключить собственную HSC-камеру V380 Pro из своего клиента: вход аккаунта, получение ключа, X25519/AES, облачный relay, бинарные пакеты IOTC, видео и звук, управление поворотом/светом и чтение SD-записей.
Это репозиторий документации. Здесь нет сайта, веб-плеера, серверного приложения, S3-инфраструктуры, готового клиента, записей с камер и личных конфигураций. Небольшие фрагменты кода находятся только внутри руководства и поясняют формат.
Описание восстановлено по исходному снимку клиента для V380 Pro 2.2.81. Наблюдения относятся к HSC-семейству, а не ко всем камерам под брендом V380. Состояние материала: 29 октября 2026 года. Это не официальный SDK производителя.
| Раздел | Что получится понять |
|---|---|
| 1. Совместимость и маршрут подключения | Нужные данные и последовательность обмена |
| 2. Облачный API, подписи и ключи | Авторизация аккаунта, список устройств, X25519-сессия |
| 3. Relay и IOTC | TCP handshake, заголовки, secure type, live и keepalive |
| 4. Видео, звук и временные метки | Выборочное AES-дешифрование, HEVC/H.264, PCM/IMA ADPCM |
| 5. PTZ и свойства камеры | Чтение/запись DPID, поворот, STOP, свет и ночное видение |
| 6. Список и чтение SD-записей | Пагинация, времена, окно frames и обновление сессии |
| 7. Диагностика | Как найти этап отказа и проверить полученное медиа |
| 8. Проверка документации | Что сверено в этом выпуске и что ещё не установлено |
sequenceDiagram
participant C as Ваш клиент
participant A as API V380
participant R as Relay
participant D as Камера
C->>A: Вход аккаунта, список устройств, public key
C->>A: X25519 exchange → sid / exp
C->>A: Dispatch → текущие relay
C->>R: call(type=2) → параметры канала
C->>R: TCP forward, 1500 байт
R-->>C: 1101 / 1000
C->>D: Через relay: зашифрованный LIVE_START
D-->>C: Атрибуты, видео и аудио
C->>D: Keepalive и необходимые команды
Первый результат — получить декодируемый видеокадр, а не только успешный HTTP-ответ. Затем можно добавлять звук, управление и SD-чтение.
В исходном описании указана проверенная 4G HSC-камера HSC V3L4GXHR:
ПО V2.0.2.6(HSC_V3L4GXHR_20250419), прошивка Hw_EV3L_NG1__4G_20250419.
В этом выпуске подключение к устройству повторно не выполнялось.
Клиент использует облако производителя для входа, ключей и relay. Работа без запущенного приложения на телефоне не означает независимость от этого облака. Нужны учётная запись с доступом к камере и её ID. QR или один ID не заменяют авторизацию.
Указанные соли/константы — части наблюдавшегося протокола. Вымышленный ID
123456789 и строки TOKEN, BASE64_* — заполнители. Рабочих токенов, ключей,
QR-кодов, адресов личных серверов или идентификаторов камер здесь нет.
Материал переработан из предоставленного автором архива; конкретные источники, контрольные суммы и границы достоверности — в SOURCES.md. Текст руководства распространяется по CC BY 4.0 с указанием FoxCoderGit. Это не лицензия на приложение V380 Pro, его библиотеки или сервисы производителя.