Полоса конвертации должна отражать работу процесса, а не время, прошедшее с нажатия кнопки. Запустите обработку в фоновой задаче, получите длительность входа через ffprobe и читайте машинный вывод FFmpeg с `-progress`. Значение обработанного времени делится на длительность, но 100% показывается только после успешного завершения процесса и проверки итогового файла.
Сначала выясните, где пропадает сигнал. Если worker пишет обновления, а браузер их не получает, проблема в API, кэше или подписке клиента. Если запись job остаётся в `queued`, смотрите очередь. Если меняется только лог stderr, но поле progress пустое, приложение, вероятно, разбирает человекочитаемую строку, формат которой не предназначен для надёжного протокола.
У задачи есть фазы, поэтому один процент без статуса обманывает
| Фаза | Что измерять | Что показать |
|---|---|---|
| queued | позиция или время ожидания | ожидает свободный worker |
| probing | получение метаданных | проверяем исходный файл |
| transcoding | out_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%.
- Создать job и сразу вернуть его ID, не удерживая HTTP-запрос на время кодирования.
- Проверить право текущего пользователя читать именно эту job.
- Считать состояние неизвестным, если heartbeat устарел, а не дорисовывать процент.
- Отменять задачу через отдельную команду с подтверждённым переходом состояния.
- Удалять временный output при неуспешной попытке и не публиковать частичный файл.
Сто процентов наступают после проверки результата
`progress=end` говорит, что FFmpeg закончил последовательность отчётов, но приложение ещё проверяет код завершения, наличие файла, его размер и читаемость ffprobe. При необходимости сравните ожидаемые потоки, duration и последний timestamp. Только затем атомарно переместите результат в доступное хранилище, запишите `completed` и отдайте ссылку.
Приёмочный тест включает короткий файл, длинный файл, вход с неизвестной длительностью, принудительное падение процесса, отмену и повторный запуск. Во всех случаях индикатор либо движется и завершается проверенным output, либо останавливается в явном failed/cancelled. Старый worker не может перезаписать новую попытку, а обновление страницы восстанавливает текущую фазу без потери состояния.