|
|
@@ -4,7 +4,7 @@
|
|
|
|
|
|
## Status
|
|
|
|
|
|
-✅ Completed - SDK核心架构和基础封装已完成
|
|
|
+🔄 In Progress - SDK核心架构和基础封装进行中(需要补充RtcManager集成)
|
|
|
|
|
|
## Story
|
|
|
|
|
|
@@ -12,7 +12,7 @@
|
|
|
**I want** 将现有的stt-demo应用中的语音转文字功能封装成通用的TypeScript SDK,
|
|
|
**so that** 我可以在任何TypeScript项目中轻松使用语音转文字功能,而不依赖特定框架。
|
|
|
|
|
|
-**验收标准扩展**: 在主应用中新增SDK测试页面,验证SDK在实际应用环境中的功能完整性。
|
|
|
+**验收标准扩展**: 在主应用中新增SDK测试页面,验证SDK在实际应用环境中的功能完整性,包括完整的音频传输功能。
|
|
|
|
|
|
## Acceptance Criteria
|
|
|
|
|
|
@@ -26,6 +26,9 @@
|
|
|
8. **修复SDK初始化接口**:SDK配置需要同时接收appId和certificate,确保token生成功能正常工作
|
|
|
9. **在主应用中新增SDK测试页面**,提供完整的SDK功能演示和测试环境
|
|
|
10. **通过E2E测试验证SDK集成**,确保SDK在实际应用场景中正常工作
|
|
|
+11. **实现RtcManagerAdapter适配器类**,封装真实RtcManager功能,支持音频传输
|
|
|
+12. **在SDK测试页面中集成RtcManager功能**,提供完整的音频传输测试环境
|
|
|
+13. **通过E2E测试验证完整的音频传输流程**,确保SDK能够进行实际的语音转文字操作
|
|
|
|
|
|
## Tasks / Subtasks
|
|
|
|
|
|
@@ -92,6 +95,13 @@
|
|
|
- [x] 测试错误处理:无效配置、连接失败场景
|
|
|
- [x] 验证事件系统:监听和显示SDK事件
|
|
|
- [x] 运行E2E测试确保SDK在实际应用中正常工作
|
|
|
+- [ ] Task 10: **实现RtcManagerAdapter集成** (AC: 11,12,13)
|
|
|
+ - [ ] 创建RtcManagerAdapter类,封装真实RtcManager功能
|
|
|
+ - [ ] 在SttSdk类中添加createRtcManager()方法
|
|
|
+ - [ ] 更新类型定义,添加IRtcManagerAdapter接口
|
|
|
+ - [ ] 编写RtcManagerAdapter单元测试
|
|
|
+ - [ ] 更新SDK测试页面,添加音频传输测试功能
|
|
|
+ - [ ] 扩展E2E测试,验证完整的音频传输流程
|
|
|
|
|
|
## Dev Notes
|
|
|
|
|
|
@@ -306,20 +316,21 @@ export const testLanguages = ["zh-CN", "en-US", "ja-JP"]
|
|
|
|
|
|
## Change Log
|
|
|
|
|
|
-| Date | Version | Description | Author |
|
|
|
-| ---------- | ------- | ---------------------------------------------------------------------------------- | ----------- |
|
|
|
-| 2025-09-25 | 1.0 | 初始故事创建 | Claude Code |
|
|
|
-| 2025-09-25 | 1.1 | 更新测试框架信息:Vitest 3.2.4, Testing Library 16.3.0, Playwright 1.55.0 | Claude Code |
|
|
|
-| 2025-09-25 | 1.2 | 更新测试策略引用:使用architecture/testing-strategy.md文档 | Claude Code |
|
|
|
-| 2025-09-25 | 1.3 | 根据PO验证报告修复:添加史诗引用、澄清技术细节、修正包管理工具、增强安全考虑 | Bob (SM) |
|
|
|
-| 2025-09-25 | 1.4 | 修正包管理工具:将yarn改为npm,与实际package.json保持一致 | Bob (SM) |
|
|
|
-| 2025-09-25 | 1.5 | **重大纠正**:发现SDK实现为模拟功能而非真实封装,需要重新实现真实Agora SDK集成 | Bob (SM) |
|
|
|
-| 2025-09-25 | 1.6 | **完成真实功能集成**:重新实现管理器适配器类,集成真实Agora SDK功能,修复所有测试 | Claude Code |
|
|
|
-| 2025-09-25 | 1.7 | **更新故事状态**:添加主应用集成SDK测试页面需求,将状态改为进行中 | Bob (SM) |
|
|
|
-| 2025-09-25 | 1.8 | **完善实施细节**:根据PO建议细化Task 8任务、添加SDK集成示例和E2E测试场景 | Bob (SM) |
|
|
|
-| 2025-09-25 | 1.9 | **修复SDK初始化问题**:添加CERTIFICATE支持,修复token生成功能 | Bob (SM) |
|
|
|
-| 2025-09-25 | 2.0 | **完成所有任务**:修复SDK初始化接口,完成主应用集成SDK测试页面,故事状态更新为完成 | Claude Code |
|
|
|
-| 2025-09-25 | 2.1 | **添加typecheck脚本**:为主应用添加npm run typecheck命令,修复TypeScript类型错误 | Claude Code |
|
|
|
+| Date | Version | Description | Author |
|
|
|
+| ---------- | ------- | --------------------------------------------------------------------------------- | ----------- |
|
|
|
+| 2025-09-25 | 1.0 | 初始故事创建 | Claude Code |
|
|
|
+| 2025-09-25 | 1.1 | 更新测试框架信息:Vitest 3.2.4, Testing Library 16.3.0, Playwright 1.55.0 | Claude Code |
|
|
|
+| 2025-09-25 | 1.2 | 更新测试策略引用:使用architecture/testing-strategy.md文档 | Claude Code |
|
|
|
+| 2025-09-25 | 1.3 | 根据PO验证报告修复:添加史诗引用、澄清技术细节、修正包管理工具、增强安全考虑 | Bob (SM) |
|
|
|
+| 2025-09-25 | 1.4 | 修正包管理工具:将yarn改为npm,与实际package.json保持一致 | Bob (SM) |
|
|
|
+| 2025-09-25 | 1.5 | **重大纠正**:发现SDK实现为模拟功能而非真实封装,需要重新实现真实Agora SDK集成 | Bob (SM) |
|
|
|
+| 2025-09-25 | 1.6 | **完成真实功能集成**:重新实现管理器适配器类,集成真实Agora SDK功能,修复所有测试 | Claude Code |
|
|
|
+| 2025-09-25 | 1.7 | **更新故事状态**:添加主应用集成SDK测试页面需求,将状态改为进行中 | Bob (SM) |
|
|
|
+| 2025-09-25 | 1.8 | **完善实施细节**:根据PO建议细化Task 8任务、添加SDK集成示例和E2E测试场景 | Bob (SM) |
|
|
|
+| 2025-09-25 | 1.9 | **修复SDK初始化问题**:添加CERTIFICATE支持,修复token生成功能 | Bob (SM) |
|
|
|
+| 2025-09-25 | 2.0 | **完成基础任务**:修复SDK初始化接口,完成主应用集成SDK测试页面 | Claude Code |
|
|
|
+| 2025-09-25 | 2.1 | **添加typecheck脚本**:为主应用添加npm run typecheck命令,修复TypeScript类型错误 | Claude Code |
|
|
|
+| 2025-09-26 | 2.2 | **发现功能不完整**:识别SDK缺少RtcManager集成,更新故事状态和验收标准 | Bob (SM) |
|
|
|
|
|
|
## Dev Agent Record
|
|
|
|
|
|
@@ -349,8 +360,11 @@ export const testLanguages = ["zh-CN", "en-US", "ja-JP"]
|
|
|
|
|
|
### 待完成任务
|
|
|
|
|
|
-10. ✅ **主应用集成**: SDK测试页面已创建并集成到主应用中
|
|
|
-11. ✅ **E2E测试**: Playwright E2E测试已编写并验证SDK功能
|
|
|
+12. ❌ **RtcManager集成**: 需要实现RtcManagerAdapter以支持完整的音频传输功能
|
|
|
+
|
|
|
+- [ ] 创建RtcManagerAdapter类
|
|
|
+- [ ] 集成到SDK测试页面
|
|
|
+- [ ] 扩展E2E测试验证音频传输
|
|
|
|
|
|
### File List
|
|
|
|
|
|
@@ -380,7 +394,7 @@ export const testLanguages = ["zh-CN", "en-US", "ja-JP"]
|
|
|
|
|
|
### 单元测试结果
|
|
|
|
|
|
-**SDK核心包测试状态**: ✅ 全部通过
|
|
|
+**SDK核心包测试状态**: ✅ 基础功能通过(缺少RtcManager相关测试)
|
|
|
|
|
|
- **测试文件**: `packages/stt-sdk-core/tests/`
|
|
|
- **测试数量**: 83个单元测试
|
|
|
@@ -398,7 +412,7 @@ export const testLanguages = ["zh-CN", "en-US", "ja-JP"]
|
|
|
|
|
|
### E2E测试结果
|
|
|
|
|
|
-**SDK测试页面E2E测试**: ✅ 已配置完成
|
|
|
+**SDK测试页面E2E测试**: ✅ 基础功能已配置完成(缺少音频传输测试)
|
|
|
|
|
|
- **测试文件**: `tests/e2e/sdk-test.spec.ts`
|
|
|
- **测试场景**: 10个完整测试用例
|