直接写即可让90%网课音频播放；常见卡点是路径错误、仅用MP3格式、autoplay未配muted；必须用相对或绝对路径，区分大小写，推荐MP3+OGG双源并注明type，autoplay需muted且iOS不支持，JS控制须绑定用户交互事件并捕获异常。
直接放 <audio></audio> 标签就行，但只写 src 和 controls 两个属性，90% 的网课页面音频能立刻播起来；路径错、格式单一、没加 muted 就 autoplay——这三处是新手最常卡住的地方。
audio 标签必须带 controls 才有操作界面
不加 controls，音频就“隐身”：没按钮、没进度条、用户点不了，不是静音，是根本不可见。哪怕你后续用 JS 控制播放，也得先让用户能触发交互。
-
src必须是相对路径（如"./audio/lesson1.mp3"）或绝对 URL（如"https://cdn.example.com/voice.mp3"），不能写"lesson1.mp3"或"C:\audio\lesson1.mp3" - 文件得放在和 HTML 同目录，或子目录里；双击 HTML 打开时，
file://协议下 Chrome/Firefox 会拒绝加载，建议用python -m http.server起个本地服务 - 路径大小写必须一致（Linux/macOS 服务器区分大小写），
"Lesson1.mp3"和"lesson1.mp3"是两个文件
MP3 + OGG 双格式回退才真正兼容所有浏览器
只放一个 .mp3，等于主动放弃 Firefox 用户；只放 .ogg，Safari 旧版本可能不认。浏览器按 <source></source> 顺序选第一个能解码的，所以顺序很重要。
- 必须写
type属性："audio/mpeg"（不是"audio/mp3"），"audio/ogg"（不是"audio/oga"） - Ogg 文件推荐用 ffmpeg 转：
ffmpeg -i lesson1.mp3 -c:a libvorbis lesson1.ogg，免费且 Firefox 原生支持 - WAV 体积太大，仅适合几秒提示音；Opus 格式压缩率更高，但需手动转码，对网课教学非必需
autoplay 必须配合 muted，否则在 Chrome/Firefox/iOS Safari 上直接失败
浏览器策略默认禁止有声自动播放。autoplay 单独存在，控制台会报 DOMException: play() failed because the user didn't interact with the document first，不是代码错，是策略拦截。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
立即学习“前端免费学习笔记（深入）”；
- 基础写法：
<audio src="intro.mp3" controls autoplay muted></audio>—— 先静音自动播，再靠 JS 解除静音（如果需要） - iOS Safari 最严：首次播放必须由用户点击触发，
autoplay完全无效，哪怕加了muted - 想 JS 控制播放？必须绑定在
click或touchstart回调里，且要.catch()捕获 Promise 拒绝，否则错误静默消失
JS 控制 audio 播放总报错？检查加载状态和用户交互时机
常见现象：页面一加载就 audio.play()，报错后整个音频功能瘫痪。本质是浏览器要求“用户已与页面产生交互”，不是等 DOM 加载完就能播。
- 安全写法示例：
document.querySelector('#playBtn').addEventListener('click', () => audio.play().catch(e => console.error('Play failed:', e))); - 别反复调用
play()：先判断audio.paused === true再调；正在播时再调会抛错 - 监听
loadeddata事件确保元数据加载完成，再允许用户点击播放，避免点击后黑屏卡顿 - 若用
new Audio()实例，注意它不自动插入 DOM，也不显示控件，纯靠 JS 驱动，适合后台提示音场景
真正麻烦的不是写法，而是路径、格式、协议、策略四者叠加出的“组合故障”——比如本地双击打开 + MP3 单格式 + autoplay 未 muted，四个条件凑齐，100% 播不了，且控制台可能只报一个模糊的 ERR_FAILED。先跑通一个带 controls 的 MP3+OGG 双源结构，再逐步加 autoplay 或 JS 控制，比一上来堆功能更省时间。
