Заметки по HLS в мобильном Safari

Start with Safari autoplay and user-gesture rules

If M3U8 is not playing in Safari on iPhone, autoplay policy is one of the first things to check. iOS often requires a user gesture before playback can start.

Muted autoplay can behave differently from normal playback, and behavior may vary across iPhone, iPad, and different iOS versions.

Verify native HLS behavior and inline playback settings

Safari frequently uses native HLS playback, so behavior can differ from desktop browsers that rely on hls.js in MSE mode.

Check whether `playsInline`, mute state, fullscreen behavior, and video element lifecycle are causing iOS to pause, restart, or refuse playback.

Test across real iOS conditions, not only one device

A stream that works on one test phone may still fail on another device because of iOS version, battery saver, network restrictions, or CDN edge differences.

Validate playback across multiple iOS versions, connection types, and signed URL windows before assuming the issue is fixed.

Операционный чеклист

Перед изменением настроек плеера проверьте доступность URL, заголовки ответа и непрерывность сегментов в одном временном окне.

Совет по взаимодействию

Экспортируйте debug snapshot и добавьте браузер/устройство/время/регион для ускорения поиска причины.

Подход к диагностике

Не опирайтесь на одно сообщение об ошибке. Сопоставляйте логи, HTTP-коды и временную шкалу.

Рекомендуемая последовательность

• Проверить URL и формат playlist
• Проверить CORS/auth для playlist, сегментов и ключей
• Сравнить паттерн ошибок по качеству и региону
• По трендам отделить джиттер от устойчивой проблемы
• Поделиться debug snapshot для командного анализа

Расширенная стратегия диагностики

В продакшене не меняйте сразу несколько переменных. Фиксируйте по одной (сеть, URL-токен, уровень качества, регион CDN), чтобы сравнение результатов было корректным.

Ведите короткую таймлинию с точными метками времени и симптомами. Так проще сопоставить события плеера с логами CDN/origin и быстрее выйти на корневую причину.

Что собрать перед эскалацией

• Исходный URL воспроизведения и наличие подписи
• Часовой пояс + точное время сбоя
• Браузер/устройство/ОС и тип сети
• Фрагмент event log вокруг момента сбоя
• Строки сегментов с HTTP-кодом и временем загрузки
• Повторяется ли проблема в других регионах/у провайдеров