Recorder

一个库搞定 H5 多格式录音，还能语音转文字

开源 🏷️完全免费 ✅ 目前可打开语音识别 🍴 复刻 1095 🐛 待处理 136 👀 关注 82

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 5641

维护状态低维护

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，完全免费，无付费版本。

项目预览

项目数据

分类语音识别

开发团队xiangyuecn

官网地址https://xiangyuecn.github.io/Recorder

GitHubhttps://github.com/xiangyuecn/Recorder

定价模式🏷️完全免费

价格说明开源项目，MIT许可证，完全免费，无付费版本。

访问状态✅ 目前可打开

是否开源是

开源协议MIT

主要语言JavaScript

技术栈/模型amr,asr,audio,browser,dtmf,h5,html,html5,javascript,luyin,mp3,ogg,record,recorder,recording,sound-record,wav,web,webm,webrtc

GitHub 星标★ 5641

上线时间2018-05-16 00:00:00

代码更新2026-07-30

仓库体积14.1 MB

本站数据更新2026-11-07

维护状态低维护

收录时间2026-08-10

浏览次数6

项目介绍

Recorder 是一个基于 HTML5 的纯前端录音库，旨在解决浏览器和混合应用中录音格式不统一、兼容性差的问题。它支持 mp3、wav、ogg、webm、amr、g711a、g711u 等多种音频格式，覆盖 PC、Android、iOS 部分浏览器、微信及 Hybrid App 环境。核心能力包括录音、格式转换、ASR 语音识别转文字、DTMF 编码解码，并附带 H5 版语音通话聊天示例。通过简单 API 即可实现高质量录音，并针对不同浏览器自动选择最佳编码方案，极大简化了 Web 端音频采集和处理的复杂度。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-10 · 当前星标 ★ 5641

技术标签

asr audio browser html javascript

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 10 分钟部署方式：库/依赖 5 步

环境要求

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

安装与启动步骤

1下载仓库源码

README 提供 GitHub 与 Gitee 两个仓库地址，若 github.io 在线链接无法访问，可下载源码到本地。
```
git clone https://github.com/xiangyuecn/Recorder.git
```
2放入安全环境

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

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

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

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

如何确认成功

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

常见问题

Q：点录音没反应或报错怎么办？

A：录音必须在 https、localhost 等安全环境下进行；若必须用 http，可在 Chrome 打开 chrome://flags/#unsafely-treat-insecure-origin-as-secure，把地址含端口加入 Insecure origins treated as secure 后重启浏览器。

Q：微信、QQ 内置浏览器能录音吗？

A：支持腾讯 Android X5 内核（QQ、微信、小程序 WebView）；如需在微信小程序、uni-app 中直接录音，可使用项目提供的 RecordApp。

Q：支持双声道吗？

A：不支持，本库主要用于语音录制，仅对单声道进行支持，但支持超长时间录音。

Q：录音文件怎么播放？

A：完整音频文件直接把链接赋给 audio.src；本地 blob 可通过 URL.createObjectURL 生成本地链接，也可直接赋给 audio.srcObject（兼容性不如 src）。

Q：官网页打不开怎么办？

A：README 中默认使用 github.io 部署的链接，如果无法访问，可直接下载仓库源码到本地，然后双击打开 html 文件访问。