Catatan HLS di Safari mobile

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.

Checklist operasional

Sebelum mengubah konfigurasi player, validasi URL, header respons, dan kontinuitas segmen pada rentang waktu yang sama.

Tips kolaborasi

Ekspor snapshot debug beserta browser/perangkat/waktu/wilayah agar analisis akar masalah lebih cepat.

Pendekatan diagnosis

Jangan hanya melihat satu pesan error. Korelasikan event log, kode HTTP, dan timeline sebelum menyimpulkan.

Urutan yang disarankan

• Validasi URL dan format playlist
• Cek CORS/auth pada playlist, segmen, dan key
• Bandingkan pola gagal per level kualitas dan wilayah
• Gunakan tren untuk pisahkan jitter vs gangguan berkelanjutan
• Bagikan snapshot debug untuk investigasi tim

Strategi diagnosis mendalam

Di produksi, jangan ubah banyak variabel sekaligus. Kunci satu variabel per iterasi (jaringan, token URL, level kualitas, atau region CDN) agar pembandingan data tetap valid.

Simpan timeline singkat dengan timestamp dan gejala yang terlihat. Ini memudahkan korelasi event player dengan log CDN/origin sehingga akar masalah lebih cepat ditemukan.

Data yang dikumpulkan sebelum eskalasi

• URL pemutaran asli dan status tanda tangan
• Zona waktu + waktu kejadian yang presisi
• Browser/perangkat/OS dan jenis jaringan
• Cuplikan event log di sekitar waktu gagal
• Baris segmen dengan kode HTTP dan waktu muat
• Apakah masalah muncul juga di region/ISP lain