Полоса конвертации должна отражать работу процесса, а не время, прошедшее с нажатия кнопки. Запустите обработку в фоновой задаче, получите длительность входа через ffprobe и читайте машинный вывод FFmpeg с `-progress`. Значение обработанного времени делится на длительность, но 100% показывается только после успешного завершения процесса и проверки итогового файла.

Сначала выясните, где пропадает сигнал. Если worker пишет обновления, а браузер их не получает, проблема в API, кэше или подписке клиента. Если запись job остаётся в `queued`, смотрите очередь. Если меняется только лог stderr, но поле progress пустое, приложение, вероятно, разбирает человекочитаемую строку, формат которой не предназначен для надёжного протокола.

У задачи есть фазы, поэтому один процент без статуса обманывает

ФазаЧто измерятьЧто показать
queuedпозиция или время ожиданияожидает свободный worker
probingполучение метаданныхпроверяем исходный файл
transcodingout_time относительно durationпроцент и обработанное время
packagingсборка контейнера или сегментовзавершаем файл
verifyingчтение выхода и контроль свойствпроверяем результат
completed/failedтерминальный исходссылка либо понятная ошибка

Диапазоны можно распределить, например 0–3% на probing, 3–95% на transcoding и остаток на упаковку с проверкой. Это продуктовая шкала, а не скорость процессора. Она остаётся честной, если пользователь видит название фазы и время последнего обновления.

FFmpeg уже выдаёт поток для программного чтения

Опция `-progress` периодически пишет строки `key=value`; последний ключ блока называется `progress` и имеет значение `continue` или `end`. Период обновления задаёт `-stats_period`. Читайте stdout построчно, собирайте полный блок и только после его окончания сохраняйте новый snapshot, чтобы клиент не увидел смесь полей из двух моментов.

ffmpeg -nostdin -progress pipe:1 -stats_period 1 -i input.mp4 output.mp4

frame=1842
fps=48.1
out_time=00:01:16.750000
speed=2.01x
progress=continue

job_snapshot={"attempt":3,"phase":"transcoding","processed_ms":76750,"progress":0.426}
  • Не парсить декоративную строку `frame=... time=...` из stderr как стабильный API.
  • Не передавать пользователю весь лог процесса: там могут быть пути и внутренние параметры.
  • Ограничить частоту записей в базу, но держать heartbeat worker отдельно от процента.
  • Сохранять версию попытки, чтобы опоздавший процесс не обновил повторный запуск.

Знаменатель берётся из фактического входа

До запуска запросите duration контейнера и потока через ffprobe. Для простого файла доля равна `processed_time / duration` и ограничивается диапазоном 0–0,99 до проверки результата. Но у live-входа, неизвестной длительности, повреждённого контейнера или сложного фильтра точный процент может быть недоступен. Тогда показывайте обработанное время, фазу и живой статус вместо выдуманной цифры.

Прогресс должен быть монотонным внутри одной попытки: `max(previous, calculated)`. После retry создаётся новый attempt ID, а интерфейс явно сообщает о повторе. Склейка нескольких входов требует собственного знаменателя — например, суммы длительностей только тех частей, которые реально входят в output. Слепое использование duration первого файла даст скачок выше 100%.

Клиент получает snapshot и умеет пережить разрыв соединения

Самый простой интерфейс опрашивает `/jobs/{id}` раз в несколько секунд и получает phase, progress, processed time, updated_at и terminal error code. Server-Sent Events или WebSocket уменьшают задержку, но после переподключения клиент всё равно запрашивает последнее сохранённое состояние. Так потерянное событие не превращает индикатор в вечные 73%.

  1. Создать job и сразу вернуть его ID, не удерживая HTTP-запрос на время кодирования.
  2. Проверить право текущего пользователя читать именно эту job.
  3. Считать состояние неизвестным, если heartbeat устарел, а не дорисовывать процент.
  4. Отменять задачу через отдельную команду с подтверждённым переходом состояния.
  5. Удалять временный output при неуспешной попытке и не публиковать частичный файл.

Сто процентов наступают после проверки результата

`progress=end` говорит, что FFmpeg закончил последовательность отчётов, но приложение ещё проверяет код завершения, наличие файла, его размер и читаемость ffprobe. При необходимости сравните ожидаемые потоки, duration и последний timestamp. Только затем атомарно переместите результат в доступное хранилище, запишите `completed` и отдайте ссылку.

Приёмочный тест включает короткий файл, длинный файл, вход с неизвестной длительностью, принудительное падение процесса, отмену и повторный запуск. Во всех случаях индикатор либо движется и завершается проверенным output, либо останавливается в явном failed/cancelled. Старый worker не может перезаписать новую попытку, а обновление страницы восстанавливает текущую фазу без потери состояния.

Проверенные источники