Посмотрите, сколько качеств реально загрузил действующий экземпляр hls.js и включён ли в нём автоматический выбор. Надпись Auto в меню может остаться после ручного назначения уровня из другого обработчика. Начните со снимка состояния плеера и сетевых запросов в том же сеансе, где виден дефект.
Если проигрыватель использует нативный HLS браузера, свойства hls.js к нему не относятся. Сначала установите фактический путь воспроизведения и версию библиотеки. Для теста используйте разрешённый поток и отдельный сеанс, чтобы изменение сетевых условий не повредило рабочему просмотру.
Сколько вариантов дошло до клиента
Сверьте адрес входного списка с загруженным содержимым. Прямой адрес одного media playlist не предоставляет набор вариантов из master. Затем сопоставьте объявленные качества с фактическим списком hls.levels. Проверять нужно ответ, который получил этот браузер, включая редиректы и персональные ограничения доступа.
Документация hls.js, проверенная 9 ноября 2026 года, описывает autoLevelEnabled как признак включённого автоматического выбора, currentLevel как индекс текущего качества, а autoLevelCapping как верхнее ограничение автоматического уровня. Эти свойства отвечают на разные вопросы и должны читаться вместе.
// Только чтение существующего экземпляра
console.log({
levels: hls.levels.length,
auto: hls.autoLevelEnabled,
current: hls.currentLevel,
cap: hls.autoLevelCapping
});Пример рассчитан на консоль вашего тестового приложения, где переменная hls уже содержит действующий экземпляр. Он только читает состояние. Не создавайте второй плеер поверх первого ради этой проверки и не публикуйте подписанные адреса из сетевого журнала.
Auto может работать внутри слишком узкого диапазона
Если уровней несколько, а автоматический режим выключен, найдите обработчики меню качества и код восстановления пользовательских настроек. Условный сценарий: кнопка рисует Auto, после чего сохранённая настройка вновь назначает ручной уровень. Исправление должно согласовать состояние интерфейса и плеера при каждом повторном открытии видео.
| Состояние | Куда смотреть |
|---|---|
| Один уровень | Входной playlist и состав ответа |
| Auto выключен | Меню и восстановление выбора |
| Auto включён, потолок низкий | Ограничения уровня и окна |
| Переход даёт ошибку | Сегмент и доступ к варианту |
При включённом Auto изучите ограничение верхнего уровня и политику по размеру плеера. Маленькое окно может намеренно не получать самое крупное изображение. Сравните обычный и полноэкранный режимы, сохранив одинаковый поток. Не отключайте все ограничения разом: так теряется возможность понять, какое условие сдерживало выбор.
Отдельно проверьте доступность каждого варианта для этого пользователя. Если переключение ведёт к ошибке сегмента, ищите разрешения, срок действия адреса или публикацию комплекта. Добавление новых качеств на сервере не исправляет отказ в доступе к уже объявленному уровню.
Сетевой тест должен позволять увидеть переход
В тестовом сеансе задайте воспроизводимые более медленные, затем более быстрые условия сети. Запишите время изменения, выбранный уровень, обращения за сегментами и остановки воспроизведения. Уже загруженный буфер способен скрыть немедленную реакцию, поэтому не оценивайте алгоритм по одному мгновенному значению после переключения ограничения.
- Подтвердить путь воспроизведения.
- Сопоставить master и доступные уровни.
- Проверить режим и ограничения.
- Снять переходы в управляемом сетевом тесте.
Цель приёмки — непрерывный просмотр и ожидаемое поведение в согласованных условиях, а не постоянная смена цифры качества. Проверьте также ручной выбор с возвратом в Auto и новый запуск ролика. После теста верните прежние сетевые настройки стенда.
В отчёте оставьте версию hls.js, число доступных уровней, состояние Auto и последовательность запросов без секретных параметров. Если ограничение было намеренным, отразите его в интерфейсе. Если найден дефект обработчика, сохраните короткий сценарий его воспроизведения, чтобы следующая правка меню не вернула ручной режим незаметно для зрителя.