的volume属性仅在媒体进入可控制状态后才有效，需等待loadedmetadata或canplay事件；其值为0–1浮点数，非法值自动截断，不触发volumechange事件，且无法获取实时响度，须用Web Audio API实现。
用 <audio></audio> 标签插入音频，但音量控制有前提
<audio></audio> 能播放音频，但默认无法直接读取或设置当前音量值，除非用户或脚本主动操作过音量。浏览器出于隐私和用户体验考虑，对未交互媒体（如自动播放、未获焦点的音频）限制音量 API 访问。常见现象是：刚加载完音频时读 volume 得到 1，但实际静音；或调用 setVolume(0.5) 没反应——本质是媒体元素还没进入“可控制状态”。
- 必须等
loadedmetadata或canplay事件后才建议读写volume - 若音频设置了
muted属性，volume仍可读写，但不会影响输出（此时实际音量为 0） - 自动播放被阻止时（大多数桌面/移动端浏览器），
play()会返回 Promise 并可能 reject，不处理 rejection 会导致后续音量操作无效
volume 属性的行为和边界值
volume 是一个 0–1 范围的浮点数，0 表示静音，1 表示最大音量。它不是分贝值，也不反映系统音量，仅作用于该 <audio></audio> 元素的相对增益。
- 设置
audio.volume = -0.1不会报错，但会被强制截断为 0 - 设置
audio.volume = 1.5同样被截断为 1 - 读取时始终返回规范后的值（即 0–1 内），即使你之前赋过非法值
- 它不触发
volumechange事件，除非值真正改变（比如从 0.3 → 0.4）
const audio = document.querySelector('audio');
audio.addEventListener('volumechange', () => {
console.log('音量变了，当前是：', audio.volume);
});
// 注意：audio.volume = audio.volume 不会触发该事件
获取实时音量需要 Web Audio API，<audio></audio> 自身做不到
<audio></audio> 的 volume 属性只是“设定值”，不是“实时输出响度”。想拿到麦克风输入或播放时的瞬时幅度（比如做可视化波形），必须走 Web Audio API 路线：
- 创建
AudioContext - 用
audioContext.createMediaElementSource(audioEl)接入 HTML 音频 - 连接
AnalyserNode，调用getByteFrequencyData()或getByteTimeDomainData() - 定期读取数据（通常 requestAnimationFrame 中）
单纯靠 audio.volume 拿不到“此刻有多大声”，它只告诉你“你想让它多大声”。很多开发者卡在这一步，误以为改了 volume 就能监听到播放强度。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
立即学习“前端免费学习笔记（深入）”；
兼容性和静音策略的实际影响
iOS Safari 和部分 Android 浏览器对自动播放极其严格：未用户手势触发的 play() 会失败，且此时 volume 设置可能被忽略，甚至 muted 属性也无效（表现为黑屏/无声，但 audio.muted === false）。
- 最稳妥做法：用按钮触发
play()，成功后再操作volume - 检查
audio.readyState是否 ≥ 2（HAVE_ENOUGH_DATA），再读volume - 不要依赖
audio.volume判断是否真的在发声——得结合audio.paused、audio.currentTime > 0和audio.duration > 0综合判断
音量本身是个简单属性，但它的可用性高度依赖媒体生命周期、用户交互状态和浏览器策略。没触发播放就去读 volume，大概率得到误导性结果。
