ONVIF-камеры¶
Sapsan умеет находить ONVIF-камеры в сети, принимать их события (движение, детекция людей и машин) и проверять камеру на совместимость.
Warning
Подсистема ONVIF активно развивается — состав возможностей и конфигурация могут меняться.
Поиск камер¶
Sapsan обнаруживает камеры по WS-Discovery (мультикаст-запрос ProbeMatch) и дополнительно понимает проприетарный протокол обнаружения Hikvision. Для каждой найденной камеры собираются адреса (XAddrs), имя и модель; повторные наблюдения одной камеры объединяются.
При работе через NAT адреса, которые камера сообщает о себе (snapshot-URL, RTSP-URL), автоматически переписываются на реально достижимый адрес устройства.
События камеры¶
События из ONVIF-метаданных превращаются в эпизоды с открытием и закрытием:
- движение (CellMotion
IsMotion, MotionAlarm) —trueоткрывает эпизод,falseзакрывает; - детекция человека и транспортного средства;
- срабатывание цифрового входа;
- зависшие эпизоды закрываются по таймауту неактивности.
Несколько источников движения на одной камере отслеживаются независимо.
Проверка совместимости¶
Встроенная проверка камеры формирует структурированный отчет: информация об устройстве, аутентификация (HTTP Digest), часы камеры (перекос времени учитывается автоматически), классификация событий, а также RTSP-проба потока со сводкой ошибок (потери пакетов, битые данные, рассинхрон) и статистикой ключевых кадров.
Note
TODO: как запускается discovery и compliance-проверка (конфиг/API/CLI), настройка камеры через ONVIF, получение снапшотов.