真正跨浏览器音频兼容方案需按MP3→Opus→WAV顺序声明，显式写controls（不可写controls="false"），自动播放须满足muted+用户手势+preload="metadata"，无缝循环应监听ended事件手动重置currentTime。
只提供 MP3 就等于主动放弃 Safari（尤其 iOS）、旧版 Firefox 和部分企业内网环境的播放能力。真正跨浏览器可用的音频兼容方案，必须静态声明多格式 <source></source> 并严格按顺序排列，不能靠 JS 动态判断或 fallback 逻辑补救。
controls 属性必须显式存在，且不能设为 controls="false"
不写 controls，浏览器默认隐藏所有控件；写了 controls="false" 是典型陷阱——HTML 中布尔属性只要存在即生效，controls="false" 和 controls="" 效果完全一样，都会显示控件，且无法用 JS 删除该属性来关闭（因为 DOM 属性已存在）。
- 正确写法只有：
controls（无值）或controls="" - 若要自定义 UI，应直接省略
controls，再用 JS 绑定play()/pause()等行为 - 常见错误现象：页面没出现播放器，控制台无报错，但检查 DOM 发现漏写了
controls
<source></source> 格式顺序必须是 MP3 → Opus → WAV，不能放 OGG 在最后
浏览器从上到下尝试每个 <source></source>，遇到第一个 canPlayType() 返回非空字符串的就停。OGG 放在最后毫无意义：Firefox/Chrome 能播，但 Safari 完全跳过它，等于白写。
- 推荐顺序：
<source src="a.mp3" type="audio/mpeg"></source>→<source src="a.opus" type="audio/opus"></source>→<source src="a.wav" type="audio/wav"></source> - MP3 兼容最广，但注意 Safari 对 VBR 编码偶有解码失败
- Opus 体积比 MP3 小 30%～50%，Chrome/Firefox 原生支持，适合网络受限场景
- WAV 是 Safari（尤其 iOS）最稳定的兜底格式，仅适合短提示音；别用于长音频，加载慢、占流量
自动播放必须同时满足 muted + 用户手势 + preload="metadata"
Chrome ≥70、Firefox ≥66、Safari ≥12.1 全面限制有声自动播放。muted 是布尔属性，写即生效；muted="false" 无效，JS 中恢复声音得用 audio.muted = false。
把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件（幻灯片风格）。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本，并且希望生成演示用的 HTML 时触发。支持任意内容来源：iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区，并通过企微直接发送给用户。触发词示例：帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。
立即学习“前端免费学习笔记（深入）”；
-
preload="auto"在 iOS Safari 上被强制降级为metadata，所以直接写preload="metadata"更可控 - 所有
play()调用必须包裹在用户手势回调中（如click、touchstart），并用.catch()容错 - 不要在
loadstart或canplay里提前调用play()，此时未获用户授权会静默失败
无缝循环不能依赖 loop 属性
原生 loop 存在 100–500ms 停顿，尤其在 Safari 和安卓 WebView 中明显。真正可用的方案是监听 ended 事件手动重置 currentTime，并确保音频文件首尾对齐。
- 用 Audacity 检查波形，裁掉首尾毫秒级静音，导出时禁用淡入淡出
- 首次播放必须由用户手势触发，
ended回调中执行audio.currentTime = 0再play() - 高精度场景（如节拍同步、游戏音效）必须用 Web Audio API，预加载
AudioBuffer后用start(when, offset, duration)精确调度
最容易被忽略的是音频文件本身的首尾对齐——再精准的 JS 控制也盖不住 MP3 开头 100ms 的静音段或结尾的硬切相位突变。这一步必须在导出前用专业工具验证，不能只靠代码补救。
