Посмотрите, сколько качеств реально загрузил действующий экземпляр 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 изучите ограничение верхнего уровня и политику по размеру плеера. Маленькое окно может намеренно не получать самое крупное изображение. Сравните обычный и полноэкранный режимы, сохранив одинаковый поток. Не отключайте все ограничения разом: так теряется возможность понять, какое условие сдерживало выбор.

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

Сетевой тест должен позволять увидеть переход

В тестовом сеансе задайте воспроизводимые более медленные, затем более быстрые условия сети. Запишите время изменения, выбранный уровень, обращения за сегментами и остановки воспроизведения. Уже загруженный буфер способен скрыть немедленную реакцию, поэтому не оценивайте алгоритм по одному мгновенному значению после переключения ограничения.

  1. Подтвердить путь воспроизведения.
  2. Сопоставить master и доступные уровни.
  3. Проверить режим и ограничения.
  4. Снять переходы в управляемом сетевом тесте.

Цель приёмки — непрерывный просмотр и ожидаемое поведение в согласованных условиях, а не постоянная смена цифры качества. Проверьте также ручной выбор с возвратом в Auto и новый запуск ролика. После теста верните прежние сетевые настройки стенда.

В отчёте оставьте версию hls.js, число доступных уровней, состояние Auto и последовательность запросов без секретных параметров. Если ограничение было намеренным, отразите его в интерфейсе. Если найден дефект обработчика, сохраните короткий сценарий его воспроизведения, чтобы следующая правка меню не вернула ручной режим незаметно для зрителя.

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