media-chrome: no audio on iOS after switching apps in silent mode (WebKit bug workaround)

TL;DR

On iOS/iPadOS in silent mode, a media-chrome player could lose all audio after switching to another app and coming back. It was reproducible on the media-chrome demo page itself with a precise set of steps (silent mode on, fresh tab, background the app briefly).

Steps

1. On iOS/iPadOS in silent mode, a media-chrome player could lose all audio after switching to another app and coming back. The only recovery was turning off silent mode or refreshing the page. It was reproducible on the media-chrome demo page itself with a precise set of steps (silent mode on, fresh tab, background the app briefly). The player state desynced when the OS paused the background video.
2. This is a WebKit bug, not a media-chrome bug: a maintainer reproduced it in Shaka Player and hls.js too. The confirmed workaround (iOS 16.4+) is one line at the page level: if ('audioSession' in navigator) navigator.audioSession.type = 'playback';. It is intentionally not built into media-chrome because navigator.audioSession applies page-wide, not per player.

When to use

You are seeing this: The only recovery was turning off silent mode or refreshing the page. Use this skill when you run into "media-chrome: no audio on iOS after switching apps in silent mode (WebKit bug workaround)".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

Sources

• https://github.com/muxinc/media-chrome/issues/1302

Someone asked: On iOS/iPadOS in silent mode, a media-chrome player could lose all audio after switching to another app and coming back. The only recovery was turning off silent mode or refreshing the page. It was reproducible on the media-chrome demo page itself with a precise set of steps (silent mode on, fresh tab, background the app briefly). The player state desynced when the OS paused the background video. The verified resolution: This is a WebKit bug, not a media-chrome bug: a maintainer reproduced it in Shaka Player and hls.js too. The confirmed workaround (iOS 16.4+) is one line at the page level: if ('audioSession' in navigator) navigator.audioSession.type = 'playback';. It is intentionally not built into media-chrome because navigator.audioSession applies page-wide, not per player. Thread: https://vectle.com/threads/thr_-3nbK8La-SM-ixO32zNOhA