iOS Safari点击后play()仍静默失败，是因为其仅认可同步、可信、语义明确的用户手势：必须使用或role="button"+tabindex="0"元素，通过addEventListener('click', ...)绑定，且play()须在回调首层直接调用，禁用异步链路与内联事件。
为什么 iOS Safari 点击后 play() 仍静默失败
不是 JS 写错了，是 iOS Safari 只认「同步、可信、语义明确」的用户手势：它拒绝所有异步链路（setTimeout、Promise.then、requestAnimationFrame），也不接受绑定在 <div> 或 <code><span></span> 上的 onclick。只有两种元素被认可：<button></button> 标签，或带 role="button" tabindex="0" 的自定义按钮。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 用
<button id="playBtn">播放音乐</button>，别用<div onclick="audio.play()"> <li>监听必须用 <code>addEventListener('click', ...)，禁用内联onclick -
play()必须在事件回调第一行直接调用，不能包裹在函数里或加await - iOS 15+ 允许后续播放脱离手势，但首次触发不可跳过——别依赖这个放宽
- MP3 必须写
type="audio/mpeg"（不是audio/mp3） - OGG 必须是 Vorbis 编码，且写
type="audio/ogg"（用ffprobe a.ogg验证含Audio: vorbis） - 顺序按浏览器支持广度排：
<source src="a.mp3" type="audio/mpeg"></source>放最前，<source src="a.ogg" type="audio/ogg"></source>次之 - 删掉
type="audio/wav"——Chrome 对 IEEE Float WAV 直接拒解码，Safari 也不支持 - 本地开发务必起 HTTP 服务：
python3 -m http.server 8000或npx http-server - Apache 用户在
.htaccess加：AddType audio/mpeg .mp3、AddType audio/ogg .ogg - Nginx 用户在
types块加：audio/mpeg mp3;、audio/ogg ogg; - 真机测试前，打开 Network → 点音频请求 → 查 Response Headers → 确认
Content-Type精确匹配 - 微信环境加兜底监听：
document.addEventListener('WeixinJSBridgeReady', () => audio.play().catch(() => {}), false) - 安卓 WebView 初始化时启用媒体：
webview.getSettings().setMediaPlaybackRequiresUserGesture(false)（仅调试，上线前关掉） - 避免相对路径如
./bgm.mp3，改用绝对路径或file:///android_asset/bgm.mp3（原生打包场景） - 每个
<audio></audio>都要单独预激活：点击按钮时先new Audio().play().catch(() => {})唤醒上下文，再播主音频
<source></source> 的 type 写错等于没写
Safari（尤其 iOS）遇到 <source src="bgm.mp3"></source>（漏 type）会直接跳过该源，不报错、不触发 canplay、duration 为 NaN，控件都不渲染。Chrome 可能碰巧播，那是兼容性红利，不是规范行为。
实操建议：
立即学习“前端免费学习笔记（深入）”；
200 状态不代表音频真能播，关键看响应头 Content-Type
Network 面板里音频请求返回 200，只是 HTTP 成功；如果服务器返回 Content-Type: text/plain 或为空，浏览器就当普通文本扔掉，连解码器都不唤起。本地双击 HTML 走 file:// 协议时，Chrome/Firefox 会直接屏蔽加载，连请求都发不出。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
实操建议：
立即学习“前端免费学习笔记（深入）”；
微信 iOS WebView 和安卓旧 WebView 需额外适配
微信 iOS WebView 行为接近 Safari，但还多一层：若未监听 WeixinJSBridgeReady，play() 会被忽略；安卓旧 WebView（如 Android 7–9 系统自带）默认禁媒体加载，即使路径和格式全对，也会报 DOMException: The element has no supported sources。
实操建议：
立即学习“前端免费学习笔记（深入）”；
Content-Type——它不响，往往就卡在这儿。
