iOS Safari和微信iOS WebView音频不播主因是未通过用户手势、格式声明及服务端响应三重校验:需在click/touchstart事件第一层调用play(),声明正确type(如audio/mpeg),且服务端返回匹配Content-Type。

苹果端(iOS Safari、微信 iOS WebView)不播音频,99%不是格式选错,而是没过“用户手势+格式声明+服务端响应”三道关卡。只写 <audio src="bgm.mp3"></audio> 必然静默失败,连错误都不报。
为什么 iOS Safari 无视 autoplay muted
iOS 不把 muted 当作“自动播放许可”,只当作“当前静音”。它仍要求首次 play() 必须发生在真实用户手势同步上下文中——哪怕你写了 autoplay muted,点开页面也照样没声音。
- 必须用
<button></button>或带role="button" tabindex="0"的元素绑定addEventListener('click', ...) -
play()调用必须在事件回调第一层,不能包在setTimeout、Promise.then或自定义函数里 - 内联
onclick="audio.play()"无效;div加onclick也无效——iOS 只认语义化或显式声明的可交互元素 - 微信环境额外要等
WeixinJSBridgeReady,否则手势上下文不被认可
MP3 和 OGG 的 type 声明不能错
浏览器不会从文件后缀猜 MIME 类型。写错 type 或漏掉,iOS 就直接跳过该 <source></source>,最终无源可用,duration 为 NaN,控件也不显示。
- MP3 必须写
type="audio/mpeg"(不是audio/mp3) - OGG 必须是 Vorbis 编码,且写
type="audio/ogg"(用ffprobe file.ogg确认含Audio: vorbis) - 顺序必须是 MP3 在前、OGG 在后:
<source src="a.mp3" type="audio/mpeg"><source src="a.ogg" type="audio/ogg"></source></source> - 别加 WAV fallback:体积大、Chrome 拒解 IEEE Float 编码、iOS 加载易超时
服务端 Content-Type 必须严格匹配
即使 HTML 写对了 type,如果服务器返回的响应头 Content-Type 是 text/plain 或空着,浏览器就当文本扔掉,连解码器都不会调用。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
立即学习“前端免费学习笔记(深入)”;
- Apache 配置:
AddType audio/mpeg .mp3 - Nginx 配置:
types { audio/mpeg mp3; audio/ogg ogg; } - 本地开发别双击 HTML:用
python3 -m http.server启 HTTP 服务,否则file://协议下 Chrome/Firefox 直接禁音频加载 - 查 Network 面板,确认音频请求返回 200 且响应头含
Content-Type: audio/mpeg
长音频和多音频需预热激活
iOS 不共享播放权限。播过一个 <audio></audio> ≠ 其他也能播;后台标签页或长时间未操作后,已激活的上下文也会失效。
- 每个待用
<audio></audio>都要单独执行:先load()→ 立即play().catch(() => {})→ 立即pause() -
load()不可省:iOS 9+ 要求显式加载才进入可播放状态 -
pause()不是为了“暂停”,是中断初始流、保留已建立的媒体上下文 - 微信中预热代码要包裹在
WeixinJSBridgeReady回调内,且必须在同一次事件栈中完成
最容易被忽略的是:预热必须对每个 audio 实例独立执行,且 load() 是硬性前置步骤——跳过它,后续任何 play() 都会因“no supported sources”被拒。这不是兼容性问题,是 iOS 的运行时规则。


















