Произнесите согласованную тестовую реплику и найдите её путь до зрителя: результат распознавания, сегмент субтитров, обновлённый список и отображение в плеере. Если текст уже сформирован, повторный запуск распознавания отвлечёт от ошибки доставки. Сначала определите последний этап, на котором реплика действительно присутствует.

Далее рассматривается отдельная дорожка WebVTT в HLS. Встроенные closed captions и текст, вшитый в изображение, требуют другой проверки. Зафиксируйте форму доставки, язык и поддерживаемые возможности целевых плееров до изменения эфирной схемы.

Реплика может существовать вне текущего окна

На тестовом эфире сохраните время реплики и адрес фактически загруженного текстового сегмента. Откройте его с теми же разрешёнными правами, что использует зритель. Проверьте наличие нужного текста и его интервалы. HTTP 200 с пустым сегментом не подтверждает, что текущая реплика была доставлена.

В RFC 8216 сегмент WebVTT может быть пустым, если на соответствующем участке нет субтитров. Поэтому отсутствие текста в одном объекте само по себе допустимо. Вопрос в том, попала ли ожидаемая реплика в правильный участок и появился ли этот участок в актуальном playlist. Документ проверен 9 ноября 2026 года.

Где пропала репликаЧто сравнить
До WebVTTРезультат распознавания и упаковку
В сегменте есть, в списке нетСвежесть публикации
Список загружен, текста нетВыбор дорожки и временную привязку

Сравните последовательность обновлений текстового списка с видеосписком. Если видео движется вперёд, а текстовый playlist остаётся прежним, исследуйте публикацию и кеширование именно этого объекта. Не увеличивайте общее время хранения всех сегментов до установления причины.

Группа субтитров должна быть связана с выбранным вариантом

RFC 8216 связывает SUBTITLES у варианта с GROUP-ID записи EXT-X-MEDIA типа SUBTITLES. Сверьте точные значения в полученном master. Наличие отдельного рабочего WebVTT по известному оператору адресу ещё не даёт плееру связи с этой дорожкой.

# Условная связь группы в master
#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subs",NAME="Russian",LANGUAGE="ru",AUTOSELECT=YES,URI="subs/ru.m3u8"
#EXT-X-STREAM-INF:BANDWIDTH=1500000,SUBTITLES="subs"
video/index.m3u8

Это условный фрагмент связи в master, а не полный готовый playlist. Характеристики видеоварианта и адреса должны соответствовать вашему пакету. Проверьте выбор языка в плеере и повторите его после смены качества. Ошибка только на одном варианте часто заметна именно в таком тесте.

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

Время текста сверяют с временной шкалой медиа

RFC описывает X-TIMESTAMP-MAP для сопоставления времени WebVTT с временными метками MPEG-2 PES. Нельзя брать произвольное время системных часов и считать его временем реплики в плеере. Сверьте фактическое отображение контрольного текста относительно события в кадре, включая задержку распознавания.

  1. Связать реплику с сегментом.
  2. Сверить группу выбранного варианта.
  3. Измерить показ относительно видео.
  4. Проверить позднее подключение и смену качества.

Подключите второй тестовый плеер после начала эфира. Проверьте, что он получает текущие субтитры без ожидания уже удалённых объектов. Затем повторите переподключение источника по предусмотренному сценарию и убедитесь, что текст после восстановления относится к новой части эфира.

Для разбора подготовьте обезличенный master, соседние версии текстового списка, один безопасный сегмент и время контрольного события. Не прикладывайте приватный текст всего эфира, если достаточно короткого образца. Приёмка завершена, когда реплика появляется на нужном языке у раннего и позднего зрителя, а смена качества не теряет выбранную дорожку.

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