# 本地录制修复 - 快速参考

## 🔍 问题
本地录制总是失败，blob 为空

## 🎯 根本原因
录制启动太晚（1200ms），在对方挂断后才启动，此时 SDK 已销毁视频轨道

## ✅ 解决方案

### 1. 缩短启动延迟
```
1200ms → 500ms
```

### 2. 快速重试
```
300ms 间隔，最多 10 次
```

### 3. 立即停止录制
```
监听 USER_LEAVE 事件，立即调用 beginStopNow()
```

### 4. 缩短停止延迟
```
300ms → 100ms
```

## 📊 测试检查清单

### 启动阶段（接通后 1 秒内）
- [ ] 看到 "尝试启动本地录制"
- [ ] 看到 "视频元素已就绪"
- [ ] 看到 "✅ 本地录制已成功启动"

### 录制阶段（每 250ms）
- [ ] 看到 "收到数据块，大小: XXX"
- [ ] 数据块数持续增加

### 停止阶段（挂断时）
- [ ] 看到 "检测到通话结束事件"
- [ ] 看到 "已收集数据块: X"（X > 0）
- [ ] 看到 "生成 Blob: XXX bytes"（不是 null）
- [ ] 看到 "本地录制已上传并关联到通话记录"

## 🚨 常见问题

### 问题：数据块数为 0
**原因**：录制启动太晚或视频流无效
**检查**：
```javascript
// 控制台执行
document.querySelectorAll('video').forEach((v, i) => {
  console.log(`Video ${i}:`, v.readyState, v.srcObject)
})
```

### 问题：Blob 为 null
**原因**：通话时间太短（< 2 秒）
**解决**：保持通话至少 5 秒

### 问题：录制启动失败
**原因**：找不到视频元素
**检查**：是否看到 "未找到视频元素" 日志

## 📝 修改的文件
1. `admin/src/components/chat-dialog/index.vue`
2. `admin/src/utils/call-local-recorder.ts`

## 🔗 详细文档
- `LOCAL_RECORDING_DEBUG_GUIDE.md` - 完整调试指南
- `RECORDING_FIX_SUMMARY.md` - 修复总结
- `admin/test-local-recording.html` - 测试工具

## 💡 测试建议
1. 清除浏览器缓存
2. 打开控制台（F12）
3. 发起视频通话
4. 保持通话 5 秒以上
5. 正常挂断
6. 检查日志和录制结果