HTML 标签原生不支持裸PCM播放,必须封装为WAV格式并配对Content-Type: audio/wav响应头;原始PCM数据应通过Web Audio API(如decodeAudioData或createBuffer)处理。

HTML <audio></audio> 标签**原生不支持裸 PCM 数据流播放**——你不能直接把 Uint8Array 或原始二进制 PCM 丢进 src,浏览器会静默失败或报 MEDIA_ERR_DECODE。真要播 PCM,必须走 Web Audio API 路线,且需严格对齐采样率、位深、通道数与值域。
为什么 <audio src="raw.pcm"></audio> 必然失败
浏览器的 <audio></audio> 只识别封装格式(如 MP3、Opus、WAV),不解析原始 PCM 帧。即使你用 blob:URL 包一层 ArrayBuffer,只要没加 WAV/RIFF 头,Chrome/Firefox/Safari 全部拒绝解码——控制台无报错,canplay 不触发,duration 为 NaN。
-
raw.pcm文件本身无容器头,浏览器无法判断采样率、位深、通道数 - 服务端若返回
Content-Type: application/octet-stream,连 MIME 检查都过不去 - 本地双击 HTML(
file://协议)下,Chrome 直接屏蔽所有音频加载,无论格式
想播 PCM?必须封装成 WAV 并配对 type 和响应头
唯一能被 <audio></audio> 直接加载的“PCM 路径”,是把它打包成标准 WAV(RIFF/WAVE 容器,16-bit PCM little-endian)。这不是妥协,是规范强制要求。
-
type必须写audio/wav,不是audio/pcm(该 MIME 未注册,浏览器无视) - WAV 文件必须是 16-bit PCM、小端序、单/双声道;IEEE Float、μ-law、a-law 编码 Chrome 直接拒
- 服务器响应头
Content-Type必须为audio/wav,Apache 加AddType audio/wav .wav,Nginx 加add_type audio/wav .wav; - 验证方式:Network 面板里点开请求 → Response Headers → 确认
Content-Type: audio/wav
Web Audio API 才是 PCM 的正确入口
若你手头只有原始 PCM 数据(比如从 Worker 计算得来、或从 WebSocket 流式接收),<audio></audio> 就不该出现在方案里。必须用 AudioContext.decodeAudioData() 或直接构造 AudioBuffer:
立即学习“前端免费学习笔记(深入)”;
- 主线程拿到
ArrayBuffer后,调用audioContext.decodeAudioData(arrayBuffer)→ 返回AudioBuffer对象 - 若已知 PCM 参数(如 44.1kHz、stereo、16-bit),可跳过 decode,用
audioContext.createBuffer(2, length, 44100)+copyToChannel()手动填入Float32Array(值域必须 [-1, 1]) - 注意:decodeAudioData 只能在主线程调用,且阻塞;大文件建议预加载+缓存
AudioBuffer,别每次播都解码
服务端配置比前端代码更关键
即使你生成了完美的 WAV 文件,服务端没配对,照样白搭。三要素缺一不可:
-
Content-Type响应头必须精确匹配audio/wav - 必须支持
Range请求头,否则preload="metadata"无法读取时长,进度条拖不动 - 跨域场景下,响应头必须含
Access-Control-Allow-Origin: *,否则 Safari 直接拒绝解码,不报错
本地开发别双击 HTML——用 python3 -m http.server 8000 启服务,否则所有音频加载策略失效。



















