Recorder

环境要求

• 运行环境为 https 或 localhost 等安全环境（getUserMedia 隐私安全要求）
• 浏览器需实现 getUserMedia：Chrome、Firefox、Safari、iOS 14.3+、Android WebView、腾讯 X5（QQ/微信）
• 仅支持单声道录音，未适配双声道
• 纯前端库，无需后端服务；非浏览器环境（nodejs 等）仅支持部分功能

安装与启动步骤

1. 1下载仓库源码

   README 提供 GitHub 与 Gitee 两个仓库地址，若 github.io 在线链接无法访问，可下载源码到本地。

   git clone https://github.com/xiangyuecn/Recorder.git

   复制

2. 2放入安全环境

   把 QuickStart.html 拷贝到你的 https 或 localhost 网站中，无需其他文件即可测试；也可以本地直接双击打开 html 文件查看。

3. 3打开页面录音

   浏览器打开该页面，允许麦克风权限后即可开始录音测试；注意只有安全环境才能录音成功。

4. 4按需引入录制文件

   需要录 mp3 就引入 recorder.mp3.min.js（150kb），只录 wav 用 recorder.wav.min.js（25kb），均支持实时转码与实时传输。

5. 5播放与上传录音

   上传后的录音把音频链接赋给 audio.src 即可播放；本地 blob 可用 URL.createObjectURL 生成本地链接，实时片段用 BufferStreamPlayer 播放。

如何确认成功

浏览器打开 QuickStart.html 页面，点击录音能正常采集并播放音频，说明环境配置成功。

常见问题

注意事项

• 录音必须在 https、localhost 等安全环境下才能进行。
• 默认输出 mp3 格式，另外可选 wav、pcm、g711a、g711u、ogg、amr、webm(beta)，有编码器即可扩展任意格式。
• 不建议自己生成根证书签发域名证书：流程复杂、每台设备都要导入，且很多现代浏览器不再信任用户目录下导入的根证书。
• README 未提供 npm 等包管理器安装方式，使用方式为拷贝 html 或引入 js 文件。