Произнесите согласованную тестовую реплику и найдите её путь до зрителя: результат распознавания, сегмент субтитров, обновлённый список и отображение в плеере. Если текст уже сформирован, повторный запуск распознавания отвлечёт от ошибки доставки. Сначала определите последний этап, на котором реплика действительно присутствует.
Далее рассматривается отдельная дорожка 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. Нельзя брать произвольное время системных часов и считать его временем реплики в плеере. Сверьте фактическое отображение контрольного текста относительно события в кадре, включая задержку распознавания.
- Связать реплику с сегментом.
- Сверить группу выбранного варианта.
- Измерить показ относительно видео.
- Проверить позднее подключение и смену качества.
Подключите второй тестовый плеер после начала эфира. Проверьте, что он получает текущие субтитры без ожидания уже удалённых объектов. Затем повторите переподключение источника по предусмотренному сценарию и убедитесь, что текст после восстановления относится к новой части эфира.
Для разбора подготовьте обезличенный master, соседние версии текстового списка, один безопасный сегмент и время контрольного события. Не прикладывайте приватный текст всего эфира, если достаточно короткого образца. Приёмка завершена, когда реплика появляется на нужном языке у раннего и позднего зрителя, а смена качества не теряет выбранную дорожку.