Skip to content

AUDIO_TEST_DEMO_GUIDE.md

Latest commit

 

History

History
213 lines (167 loc) · 5.15 KB

AUDIO_TEST_DEMO_GUIDE.md

File metadata and controls

213 lines (167 loc) · 5.15 KB

音频测试Demo使用指南

🎯 概述

音频测试Demo是一个集成在React Native应用中的WebSocket音频流测试工具，允许您直接在应用界面上上传音频文件并测试WebSocket连接和音频传输功能。

📱 访问方式

方法1: 通过调试面板

  1. 启动React Native应用
  2. 点击屏幕右下角的悬浮调试按钮
  3. 在调试面板中找到"🧪 音频测试Demo"按钮
  4. 点击进入音频测试界面

方法2: 直接导航

如果您有开发权限，可以直接在代码中导航到音频测试页面。

🔧 功能特性

1. 连接状态监控

  • 实时显示: WebSocket连接状态（未连接/连接中/已连接/连接错误）
  • 状态指示器: 彩色圆点显示当前连接状态
  • 自动重连: 支持连接失败后的自动重连机制

2. 音频文件管理

  • 多格式支持: MP3, WAV, M4A, AAC, OGG
  • 文件验证: 自动检查文件格式和大小
  • 文件信息: 显示文件名、大小、格式等详细信息
  • 文件更换: 支持随时更换测试文件

3. 测试执行

  • 一键测试: 点击"开始测试"按钮执行完整测试流程
  • 进度显示: 实时显示音频数据发送进度
  • 状态反馈: 测试过程中的详细状态信息

4. 结果管理

  • 测试记录: 保存所有测试结果
  • 结果查看: 通过"结果"按钮查看历史测试记录
  • 结果详情: 包含测试状态、耗时、文件大小等信息
  • 结果清理: 支持清除历史测试结果

📋 使用步骤

第一步：选择音频文件

  1. 点击"选择音频文件"按钮
  2. 从设备中选择要测试的音频文件
  3. 系统会自动验证文件格式和大小
  4. 确认文件信息正确

第二步：开始测试

  1. 确保WebSocket连接状态为"已连接"
  2. 点击"开始测试"按钮
  3. 观察测试进度条
  4. 等待测试完成

第三步：查看结果

  1. 测试完成后，点击右上角"结果"按钮
  2. 查看测试结果详情
  3. 分析连接状态和传输情况
  4. 必要时清除历史结果

🔍 测试流程详解

连接建立

1. 获取用户认证token
2. 初始化WebSocket连接
3. 发送音频配置参数
4. 等待连接确认

音频传输

1. 读取音频文件数据
2. 分块发送音频数据（每块4096字节）
3. 实时更新发送进度
4. 发送结束标记

结果处理

1. 等待服务器响应
2. 记录测试结果
3. 更新连接状态
4. 显示测试完成信息

📊 测试结果说明

成功结果

  • 状态: ✅ 成功
  • 信息: 包含测试耗时、文件大小等
  • 颜色: 绿色背景，表示测试通过

失败结果

  • 状态: ❌ 失败
  • 信息: 包含错误原因和详细信息
  • 颜色: 红色背景，表示测试失败

结果字段

  • 测试ID: 唯一标识符
  • 时间戳: 测试执行时间
  • 状态: 成功/失败/超时
  • 消息: 详细结果描述
  • 耗时: 测试执行时间（毫秒）
  • 文件大小: 测试文件大小

⚠️ 注意事项

网络要求

  • 确保设备网络连接正常
  • WebSocket服务器地址可访问
  • 网络延迟不影响测试结果

文件要求

  • 文件大小建议不超过100MB
  • 支持的音频格式：MP3, WAV, M4A, AAC, OGG
  • 文件完整性检查

权限要求

  • 需要文件读取权限
  • 需要网络访问权限
  • 需要用户认证token

🛠️ 故障排除

连接失败

问题: WebSocket连接失败 解决方案:

  1. 检查网络连接
  2. 验证服务器地址
  3. 确认认证token有效
  4. 检查防火墙设置

文件上传失败

问题: 无法选择或上传音频文件 解决方案:

  1. 检查文件权限
  2. 验证文件格式
  3. 确认文件大小
  4. 重启应用

测试超时

问题: 测试执行时间过长 解决方案:

  1. 检查网络速度
  2. 减小测试文件大小
  3. 检查服务器负载
  4. 重试测试

🔧 技术实现

核心组件

  • AudioTestDemoScreen: 主界面组件
  • realTimeTranslationService: WebSocket服务
  • audioRecordingService: 音频处理服务
  • DocumentPicker: 文件选择器

依赖库

  • react-native-fs: 文件系统操作
  • @react-native-documents/picker: 文件选择
  • ws: WebSocket客户端（Node.js测试）

配置参数

  • 服务器地址: ws://123.56.246.44:80
  • 音频格式: 支持多种格式
  • 分块大小: 4096字节
  • 发送间隔: 100毫秒

📈 性能优化

内存管理

  • 分块读取大文件
  • 及时释放资源
  • 避免内存泄漏

网络优化

  • 控制发送频率
  • 实现断点续传
  • 错误重试机制

用户体验

  • 实时进度反馈
  • 友好的错误提示
  • 响应式界面设计

🚀 扩展功能

计划中的功能

  • 批量文件测试
  • 自定义测试参数
  • 测试报告导出
  • 性能基准测试

自定义配置

  • 可配置的服务器地址
  • 可调整的音频参数
  • 可选择的测试模式

📞 技术支持

如果您在使用过程中遇到问题，请：

  1. 查看控制台日志
  2. 检查网络连接
  3. 验证文件格式
  4. 联系技术支持

版本: 1.0.0
更新日期: 2024年12月
兼容性: React Native 0.80.1+