101 lines
2.4 KiB
Markdown
101 lines
2.4 KiB
Markdown
# App 端实时录音配置说明
|
||
|
||
## 让 recorderManager.onFrameRecorded 在 App 端工作的关键配置
|
||
|
||
### 必须满足的条件：
|
||
|
||
1. **format 必须是 'pcm'**
|
||
```javascript
|
||
format: 'pcm' // 不能是 mp3 或 aac
|
||
```
|
||
|
||
2. **必须设置 frameSize**
|
||
```javascript
|
||
frameSize: 5 // 单位 KB，建议 1-10
|
||
```
|
||
|
||
3. **sampleRate 必须是标准值**
|
||
```javascript
|
||
sampleRate: 16000 // 只能是 8000/16000/44100
|
||
```
|
||
|
||
4. **完整配置示例**
|
||
```javascript
|
||
recorderManager.start({
|
||
duration: 600000, // 最长录音时间
|
||
sampleRate: 16000, // 采样率
|
||
numberOfChannels: 1, // 单声道
|
||
encodeBitRate: 48000, // 编码比特率
|
||
format: 'pcm', // 关键：必须 pcm
|
||
frameSize: 5, // 关键：必须设置
|
||
audioSource: 'auto' // 音频源
|
||
})
|
||
```
|
||
|
||
## 工作原理
|
||
|
||
### 实时流式传输模式（推荐）
|
||
- 按住按钮 → 开始录音
|
||
- 录音持续进行，实时产生音频帧
|
||
- 按住时：发送音频帧到服务器
|
||
- 松开时：停止发送（但录音继续）
|
||
- 再次按住：继续发送
|
||
|
||
### 优点
|
||
- 低延迟，实时传输
|
||
- 服务器可以实时处理
|
||
- 用户体验好
|
||
|
||
### 缺点
|
||
- 需要 PCM 格式（文件较大）
|
||
- 需要服务器支持流式处理
|
||
|
||
## 备用方案
|
||
|
||
如果 `onFrameRecorded` 仍然不工作，会自动降级到 `onStop` 方案：
|
||
|
||
```javascript
|
||
recorderManager.onStop((res) => {
|
||
// 读取完整录音文件
|
||
// 一次性发送到服务器
|
||
})
|
||
```
|
||
|
||
## 调试技巧
|
||
|
||
1. **查看日志**
|
||
- `✅ 录音已开始` - 录音启动成功
|
||
- `🎤 收到音频帧 #1` - 实时帧工作
|
||
- `⏹️ 录音已停止` - 降级到备用方案
|
||
|
||
2. **如果没有音频帧**
|
||
- 检查 format 是否为 'pcm'
|
||
- 检查 frameSize 是否设置
|
||
- 检查 manifest.json 中 Record 模块是否启用
|
||
|
||
3. **性能优化**
|
||
- frameSize 越小，延迟越低，但回调频率越高
|
||
- 建议值：3-5 KB
|
||
|
||
## 服务器端要求
|
||
|
||
服务器需要支持：
|
||
1. WebSocket 连接
|
||
2. 接收 PCM 格式音频流
|
||
3. 实时语音识别（如果需要）
|
||
4. 返回音频响应
|
||
|
||
## 当前状态
|
||
|
||
✅ 录音功能已实现
|
||
✅ 文件发送已成功
|
||
⚠️ 需要测试实时帧是否工作
|
||
⚠️ 需要检查服务器端处理
|
||
|
||
## 下一步
|
||
|
||
1. 重新编译并测试
|
||
2. 查看是否有 `🎤 收到音频帧` 日志
|
||
3. 如果有，说明实时流式传输工作
|
||
4. 如果没有，会自动使用备用方案（文件发送）
|