html5音频输出设备切换仅chrome/edge 81+支持，需https环境、用户授权及有效音源，通过audioelement.setsinkid()调用audiooutputdevices api实现，firefox和safari不支持。
HTML5 中的音频输出设备切换，核心依赖的是 AudioOutputDevices API（常通过 audioElement.setSinkId() 调用），但它不是独立存在的“新 API”，而是 Web Audio 与媒体设备能力的延伸功能，目前仅在 Chromium 系列浏览器（Chrome / Edge 81+）中稳定支持。
哪些浏览器能用？
当前只有 Chrome 和基于 Chromium 的 Edge 浏览器支持 setSinkId()。Firefox 和 Safari 完全不支持该能力，调用会直接报 NotSupportedError。即使在 Chrome 中，若用户禁用了相关实验性标志（chrome://flags/#enable-audio-output-devices-api），也可能失效——不过 2026 年主流版本已默认开启，一般无需手动启用。
必须满足的安全与权限条件
这个功能运行有硬性前提：
- 页面必须处于安全上下文：即使用
https://协议，或本地开发时用localhost；http://127.0.0.1或普通 IP 地址都不行。 - 用户需授予“音频输出设备访问”权限——该权限通常不会单独弹窗，而是随
navigator.mediaDevices.enumerateDevices()的首次调用自动触发。 - 建议在用户点击等交互后执行设备枚举和切换，避免因权限未就绪导致返回空设备列表。
如何获取并切换输出设备？
流程分两步：先列出可用设备，再指定目标 deviceId 给 audio 元素。
- 调用
enumerateDevices()，过滤出kind === 'audiooutput'的设备项，每项含deviceId、label（如“扬声器（Realtek Audio）”）和groupId。 - 对已有
<audio></audio>元素调用setSinkId(deviceId)，它返回 Promise，需 await 或 .then() 处理结果。 - 常见错误包括：
SecurityError（非安全上下文）、NotSupportedError（浏览器不支持）、InvalidStateError（元素未加载或已被其他标签页占用该设备）。
实际应用中的限制与注意事项
即便调用成功，系统层面仍有约束：
- 部分蓝牙耳机或 USB 声卡在 macOS 上无法被 setSinkId 切换，会静默失败或抛错。
- 同一设备若正被其他网页或系统进程独占（如 Zoom 正在使用某耳机），切换也会被拒绝。
- 切换后不会自动播放，也不会改变音量或 mute 状态，只影响声音从哪个物理端口输出。
- 该设置仅对当前
<audio></audio>元素生效，不影响其他 audio 标签或 Web Audio 节点。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
