Платформа 4.0 / BOX 5.0
Отладка, приёмка и ошибки сценариев
Отладка, приёмка и ошибки сценариев: подробная инструкция, назначение полей, порядок действий и иллюстрации интерфейса.
На этой странице
Песочница: пошаговая отладка
В блоке «Тестирование на видео/изображениях» выберите локальный файл или нажмите «Загрузите файл из ассета». При выборе ассета укажите ресурс, его версию и нужный файл. Разметка тестового файла должна соответствовать зонам, ожидаемым сценарием.
| Элемент | Использование |
|---|---|
| Выберите файл на компьютере | Быстрый локальный тест на разрешённом материале |
| Загрузите файл из ассета | Повторяемый тест на сохранённом наборе |
| Загрузка зон → Загрузить | Применение подготовленных зон; проверьте типы и геометрию |
| Начать обработку | Исполнение текущего развёрнутого графа на выбранном материале |
| Визуализация | Проверка рамок, треков и служебных наложений |
| Шкала / кадр | Покадровая проверка конкретного момента |
| Лог | Откройте журнал выполнения, чтобы найти запуск блоков и ошибки. При сбое начните с первой ошибки по времени: последующие сообщения могут быть её следствием. |
| Лог фрейма | Выберите момент на шкале и откройте данные этого кадра. Сопоставьте категории, координаты и идентификаторы с визуализацией; так можно локализовать ошибку конкретного эпизода. |
| Лог сообщений | Посмотрите, какие именованные поля приходят в блок и выходят из него. Сверьте имена топиков, типы значений и наличие обязательных данных перед следующим блоком. |
| События | События, сформированные в тесте |
| Скачать видео с визуализацией | Материал для совместного разбора результата |
Начните с короткого ролика. Сначала подтвердите, что модель загрузилась и кадры обрабатываются. Затем проверьте первый неверный этап: рамки → треки → атрибуты → фильтры → события. При ошибке инициализации сокращение временного окна бессмысленно: исполнение ещё не началось.
Протокол одного теста: сценарий/версия; модели/версии; ассет/версия/файл; параметры кадра; зоны; время запуска; ожидаемые эпизоды; фактические эпизоды; задержка; пропуски и ложные события; логи; вывод и автор. Если сравниваете пороги, меняйте один существенный параметр за раз.
Учебный граф на иллюстрации содержит только VideoFrame → Detector → LocalVisualizer. Он показывает получение детекций и их отображение. Пока в нём нет узлов формирования и отправки событий, требовать от него записей в журнале нарушений нельзя. В этой редакции повторный полный прогон бизнес-правила не заявляется.
Приёмка и передача в эксплуатацию
Перед выпуском проверьте пять уровней:
- Ресурсы: модели готовы, версии фиксированы, ассет воспроизводим, категории совпадают.
- Логика: положительные, отрицательные и граничные примеры дают ожидаемые результаты; время и координаты согласованы.
- Камера: нужная версия назначена, зоны и индивидуальные настройки верны, расписание и аналитика включены.
- Процесс: событие видно нужному оператору, решение сохраняется, уведомление/интеграция работают в предусмотренном режиме.
- Эксплуатация: известны ответственный, предыдущая версия, порядок возврата, критерии неисправности и данные для обращения.
Итоговый паспорт сценария: цель; ограничения; версии графа и моделей; схемы зон; параметры камеры; набор тестов; измеренные результаты; условия ввода; порядок возврата; дата и ответственный. Запись о качестве должна ссылаться на измерение, а не на число «99%», характеризующее широту сценарного подхода.
Типовые ошибки сценариев
| Симптом | Причина, которую стоит проверить | Действие |
|---|---|---|
| После выхода исчезли изменения | Было только «Развернуть» | Сохранить логику внешней кнопкой и проверить карточку версии |
| Сценарий не виден при назначении | Черновик или неподготовленная зависимость | Завершить публикацию, проверить модель и права |
| Нет детекций нужного класса | Класс не включён, порог раннего этапа слишком строгий | Проверить выход Detector до фильтров |
| Зона нарисована, но не влияет | Атрибут добавлен без фильтра / неверный тип зоны | Проверить код зоны, сообщение и потребителя атрибута |
| Есть рамки, нет событий | Нет этапа создания/отправки или не выполнено временное условие | Проверить events и каждый фильтр |
| Событие повторяется слишком часто | Разрыв трека, малый интервал, две ветки создают дубль | Сопоставить ID, время и правила повторения |
| Отсутствие на месте не считается | Пустые сообщения отфильтрованы | Передавать наблюдение зоны с нулевым числом людей |
| После обновления поведение старое | Наследованы индивидуальные настройки | Сравнить параметры назначения и базовые значения версии |
| Часть камер не обновилась | Уникальное назначение / выборка камер | Проверить фактический список и версию каждой камеры |
| Тест работает, живая камера нет | Иные зоны, время, качество, профиль или нагрузка | Сопоставить вход и исполнение; провести тест на материале камеры |