Если эфир работает на компьютере, но не на iPhone, первым делом уберите обвязку плеера. Safari на iPhone умеет воспроизводить HLS нативно через обычный `<video src="...m3u8">`; desktop Chrome часто получает тот же поток через hls.js и Media Source. Успех одного пути ничего не говорит о другом.
Минимальная страница с `controls`, `playsinline` и без autoplay отделяет поток от вашего JavaScript, рекламы, аналитики и service worker. Откройте её на том же iPhone и в той же сети. Если она играет, ошибка в выборе playback path или политике запуска. Если нет — разбирайте сетевые запросы, playlist и media segments.
Нативный тест занимает меньше минуты
<!doctype html>
<meta name="viewport" content="width=device-width,initial-scale=1">
<video
id="live"
controls
playsinline
preload="metadata"
style="width:100%;max-width:720px;background:#000"
src="https://media.example.com/live/master.m3u8">
</video>
<pre id="status"></pre>
<script>
const video = document.querySelector('#live');
const out = document.querySelector('#status');
['loadstart','loadedmetadata','canplay','playing','waiting','stalled','error']
.forEach(name => video.addEventListener(name, () => {
out.textContent += name + ' code=' + (video.error?.code ?? '-') + '\n';
}));
</script>Не добавляйте `autoplay` на первом тесте: нажмите Play сами. WebKit разрешает inline-воспроизведение с `playsinline`, а автоматический запуск со звуком по-прежнему зависит от пользовательского жеста. Если muted autoplay нужен продукту, проверяйте его отдельно после ручного запуска.
Network-запросы читаются как цепочка
| Запрос | Ожидаемый результат | Частая поломка |
|---|---|---|
| master.m3u8 | 200, актуальный playlist | redirect на login или HTML вместо m3u8 |
| variant playlist | 200 по абсолютному/относительному URL | неверная база после CDN rewrite |
| init.mp4 или первый .ts | 200/206 и media MIME | 403, expired signature, неправильный Content-Type |
| следующие сегменты | появляются быстрее окна live | плейлист ссылается на уже удалённые сегменты |
| key URI при шифровании | 200 для авторизованного клиента | cookie/CORS/auth не доходит до key server |
Проверяйте URL именно с проблемного устройства через подключённый Safari Web Inspector или прокси тестового стенда. Запрос `curl` из дата-центра может получить другой CDN edge, DNS-ответ и cookies. В ответе playlist не должно быть страницы ошибки с HTTP 200; сохраните первые строки и фактический `Content-Type`.
MIME и HTTPS должны быть согласованы на всех уровнях
Apple рекомендует `application/vnd.apple.mpegurl` для `.m3u8`, `video/mp2t` для MPEG-TS и подходящие media-типы для fMP4. Ошибка на одном сегменте обрывает эфир уже после успешной загрузки master playlist. На HTTPS-странице все playlist, сегменты, ключи, субтитры и постеры также должны идти по HTTPS без недоверенного сертификата.
- Проверить Content-Type для master, media playlist, segment, init section и encryption key.
- Проверить редиректы: конечный URL и сертификат должны быть доступны iPhone.
- Если ресурс на другом origin, вернуть точный CORS policy; credentials согласовать с плеером.
- Не использовать одноразовую подпись короче длительности просмотра и глубины live-окна.
- Убедиться, что CDN не кеширует персональный 403 как общий ответ.
Совместимый контейнер не гарантирует совместимый кодек
Apple HLS Authoring Specification перечисляет допустимые видеоформаты и ограничения профилей. Для широкого покрытия полезно иметь вариант H.264, а audio обычно кодируют в AAC. Desktop-плеер мог выбрать современный HEVC/AV1-вариант или декодировать поток программно, тогда как конкретная модель iPhone выберет другую дорожку либо не сможет её открыть.
#EXTM3U
#EXT-X-VERSION:6
#EXT-X-STREAM-INF:BANDWIDTH=900000,AVERAGE-BANDWIDTH=720000,
RESOLUTION=640x360,CODECS="avc1.4d401e,mp4a.40.2"
360p/index.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2800000,AVERAGE-BANDWIDTH=2200000,
RESOLUTION=1280x720,CODECS="avc1.64001f,mp4a.40.2"
720p/index.m3u8Не копируйте строку `CODECS` из примера: она должна точно описывать ваш encode. Сверьте profile/level, frame rate, resolution, audio sample rate и keyframe interval с фактическими сегментами. Apple рекомендует регулярные IDR, а для максимальной совместимости — наличие H.264-вариантов в допустимых уровнях.
Плейлист проверяет валидатор, а не только глаз
Apple предоставляет Media Stream Validator, который симулирует HLS-сессию и проверяет media playlist и сегменты на соответствие спецификации. Запускайте его для публично доступного тестового URL и сохраняйте отчёт вместе с версией encoder. Валидатор не заменяет устройство, но быстро обнаруживает несогласованные durations, CODECS, discontinuity и варианты, которые браузер на ПК терпит.
mediastreamvalidator 'https://media.example.com/live/master.m3u8'
# Для VOD дождитесь полного отчёта. Для live остановите после
# репрезентативного окна и отдельно проверьте все варианты master playlist.Для live посмотрите, обновляется ли `MEDIA-SEQUENCE`, доступны ли сегменты из заявленного окна и синхронны ли audio/video renditions. Системное время origin, signer и CDN должно совпадать: короткоживущая подпись часто ломается только на устройствах с более долгим стартом.
JavaScript-плеер выбирает native HLS раньше MSE
Проект hls.js прямо указывает, что Safari на Apple-платформах имеет встроенную поддержку HLS через source URL у video. Проверяйте `video.canPlayType('application/vnd.apple.mpegurl')` и отдавайте m3u8 нативному элементу. Hls.js включайте там, где native HLS нет, но MediaSource поддерживается.
const video = document.querySelector('video');
const source = 'https://media.example.com/live/master.m3u8';
if (video.canPlayType('application/vnd.apple.mpegurl')) {
video.src = source;
} else if (window.Hls && Hls.isSupported()) {
const hls = new Hls();
hls.loadSource(source);
hls.attachMedia(video);
} else {
showUnsupportedMessage();
}Встроенный Safari player сам управляет выбором варианта и буфером. Не подменяйте его только по user-agent: feature detection переживает новые версии лучше. Если пользователь нажал Play, а `video.play()` вернул rejected Promise, покажите кнопку и причину; не зацикливайте автоматические попытки.
Финальный прогон делают на реальном iPhone
- Открыть минимальный native video по Wi-Fi и мобильной сети; записать модель, iOS и URL.
- Проверить master, выбранный variant, init/segment и key requests без 3xx→HTML, 4xx и 5xx.
- Запустить Media Stream Validator и исправить ошибки до настройки UI плеера.
- Проверить H.264/AAC fallback, низкий bitrate и правильные CODECS в master playlist.
- Вернуть приложение без service worker и расширений, затем включать слои по одному.
- Отдельно проверить ручной Play, muted autoplay, поворот, background/foreground и повторное подключение.
- Продержать эфир дольше срока подписи URL и нескольких обновлений live playlist.
Для тикета приложите не запись чёрного экрана, а точку обрыва: последний успешный URL, HTTP/MIME, media error code, выбранный variant и отчёт валидатора. Исправление готово, когда минимальный native путь стабилен, а боевой плеер выбирает его на iPhone без обходных таймеров и скрытых повторов.