Если эфир работает на компьютере, но не на 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.m3u8200, актуальный playlistredirect на login или HTML вместо m3u8
variant playlist200 по абсолютному/относительному URLневерная база после CDN rewrite
init.mp4 или первый .ts200/206 и media MIME403, 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

  1. Открыть минимальный native video по Wi-Fi и мобильной сети; записать модель, iOS и URL.
  2. Проверить master, выбранный variant, init/segment и key requests без 3xx→HTML, 4xx и 5xx.
  3. Запустить Media Stream Validator и исправить ошибки до настройки UI плеера.
  4. Проверить H.264/AAC fallback, низкий bitrate и правильные CODECS в master playlist.
  5. Вернуть приложение без service worker и расширений, затем включать слои по одному.
  6. Отдельно проверить ручной Play, muted autoplay, поворот, background/foreground и повторное подключение.
  7. Продержать эфир дольше срока подписи URL и нескольких обновлений live playlist.

Для тикета приложите не запись чёрного экрана, а точку обрыва: последний успешный URL, HTTP/MIME, media error code, выбранный variant и отчёт валидатора. Исправление готово, когда минимальный native путь стабилен, а боевой плеер выбирает его на iPhone без обходных таймеров и скрытых повторов.

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