Notes HLS pour 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 opérationnelle

Vérifiez l’URL, les en-têtes de réponse et la continuité des segments sur la même période avant de modifier le player.

Conseil de collaboration

Exportez le snapshot de debug avec navigateur/appareil/heure/région pour accélérer l’analyse de cause racine.

Approche de diagnostic

Ne vous fiez pas à un seul message d’erreur. Corrélez logs, statuts HTTP et chronologie avant de conclure.

Séquence recommandée

• Vérifier l’URL et le format de playlist
• Contrôler CORS/auth sur playlist, segments et clés
• Comparer les échecs par niveau de qualité et région
• Utiliser les tendances pour distinguer jitter et panne continue
• Partager un snapshot de debug pour l’investigation

Stratégie de diagnostic approfondie

En production, évitez de modifier plusieurs variables en même temps. Isolez une variable par itération (réseau, token URL, niveau qualité ou région CDN) pour comparer les preuves proprement.

Tenez une chronologie courte avec heure précise et symptômes observés. Elle permet de corréler les événements du player avec les logs CDN/origine et d'accélérer l'analyse de cause racine.

À collecter avant escalade

• URL de lecture d'origine et présence d'une signature
• Fuseau horaire + heure exacte de l'échec
• Navigateur/appareil/OS et type de réseau
• Extrait des logs d'événements autour de l'incident
• Lignes de segments avec code HTTP et temps de chargement
• Reproductibilité selon région ou opérateur