Skip to content

Руководство пользователя Archivarius

Archivarius использует API Flussonic, поэтому Flussonic обязателен в составе стенда.

Подробная инструкция по развертыванию доступна на странице Установка и развертывание.

После установки откройте интерфейс Archivarius в браузере: http://localhost:3000.

Загрузка и подготовка файла

После первого запуска каталог обычно пустой, поэтому работу начинают с загрузки исходного файла.

В текущем рабочем сценарии используются исходные файлы в формате MP4.

Рекомендуемые требования к исходному файлу:

  • контейнер: MP4;
  • видео: H.264 (допустим также HEVC);
  • аудио: AAC;
  • имя файла: латиница/цифры без специальных символов.

Порядок загрузки и подготовки:

  1. В блоке Upload нажмите выбор файла и укажите исходный MP4.
  2. Убедитесь, что выбран правильный файл (имя отобразится в поле формы).
  3. Нажмите кнопку загрузки и дождитесь сообщения об успешном завершении.
  4. Если запись не появилась сразу, нажмите Load catalog, чтобы принудительно обновить список.
  5. Выберите загруженный файл и запустите для него Transcode.
  6. Дождитесь завершения транскодирования, после этого файл можно открывать в плеере и вырезать фрагмент.

Кнопка Load catalog обновляет список файлов в каталоге и помогает быстро увидеть недавно загруженные или измененные записи.

Работа с каталогом

Каталог — это стартовый экран Archivarius, где отображается список доступных видео.

В каталоге пользователь может:

  • просматривать список исходных файлов;
  • открывать выбранный файл в плеере для просмотра и вырезки;
  • удалять или обновлять список файлов (если эти действия доступны по правам);
  • загружать новый исходный файл в архив через форму загрузки (если есть права на загрузку).

Разметка и вырезка фрагмента

Работа с метками на таймлайне:

  • левый клик — поставить метку начала (Start);
  • правый клик — поставить метку конца (End);
  • колесо мыши — масштабирование таймлайна (zoom) и перетаскивание рабочей области.

Когда обе метки установлены, воспроизведение зацикливается между началом и концом фрагмента. Это позволяет проверить выбранный интервал до запуска вырезки.

Типовой пример работы с файлом:

  1. Откройте видео в плеере через кнопку Open player в каталоге.
  2. На таймлайне поставьте маркер начала и маркер конца.
  3. Нажмите кнопку Вырезать.
  4. Дождитесь завершения обработки.
  5. Проверьте результат в секции Preview (версия low-res).
  6. Подтвердите выдачу итогового результата после оплаты.
  7. Откройте или скачайте итоговый фрагмент в секции Скачать (high-res).

Работа с результатами

После обработки в интерфейсе отображаются:

  • Preview
    Ссылки для быстрой проверки фрагмента:
  • HLS — открыть поток;

  • File — скачать файл.

  • Скачать
    Итоговый результат для выдачи:

  • HLS — открыть поток;
  • File — скачать файл.

Секция Скачать становится видимой после оплаты.

Устранение неисправностей (Troubleshooting)

Проблема: файл не появился в каталоге после загрузки

Что проверить:

  • нажмите Load catalog для обновления списка;
  • проверьте, что загрузка завершилась без ошибки в статусе;
  • проверьте конфигурацию: sourceVodPrefix в config.docker.json должен совпадать с объявленным vod-блоком в flussonic.conf (например, sourceVodPrefix: "vod_src" и vod vod_src { ... }).

Проблема: ошибка при загрузке файла

Что проверить:

  • формат исходного файла (рекомендуется MP4 с H.264/HEVC + AAC);
  • корректность имени файла (без специальных символов);
  • доступность Flussonic API и отсутствие ошибок в его логах.

Проблема: не запускается или не завершается Transcode

Что проверить:

  • статус задачи в каталоге и текст ошибки;
  • доступность хранилищ source и transcoded;
  • что Flussonic и Archivarius запущены и связаны по сети.

Проблема: секция Скачать не появляется

Что проверить:

  • что вырезка успешно завершена и есть результат в Preview;
  • что оплата выполнена и секция Скачать стала доступна;
  • что при обновлении страницы статус задачи не содержит ошибок.

Проблема: некорректный фрагмент после вырезки

Что проверить:

  • правильно ли установлены метки начала и конца;
  • что конец фрагмента позже начала;
  • что при зацикленном предпросмотре между метками виден нужный интервал.

Если ошибка повторяется, передайте в поддержку текст ошибки из статуса в интерфейсе и шаги воспроизведения.