浏览代码

📝 docs(architecture): 更新SDK架构文档,添加实时语音识别结果显示相关内容

- 更新状态描述,添加"需要补充实时语音识别结果显示"
- 扩展验收标准,增加实时结果显示相关要求(AC:14,15,16)
- 添加"实现实时语音识别结果显示"任务及子任务
- 新增"实时语音识别结果显示问题分析"章节,对比功能缺失情况并提出修复方案
- 更新变更记录,添加2.3版本关于识别结果显示缺失的内容
- 添加"实时语音识别结果显示"开发检查项
yourname 2 月之前
父节点
当前提交
27cdb4b2f5
共有 1 个文件被更改,包括 60 次插入17 次删除
  1. 60 17
      docs/stories/1.1.sdk-core-architecture.md

+ 60 - 17
docs/stories/1.1.sdk-core-architecture.md

@@ -4,7 +4,7 @@
 
 ## Status
 
-🔄 In Progress - SDK核心架构和基础封装进行中(需要补充RtcManager集成)
+🔄 In Progress - SDK核心架构和基础封装进行中(需要补充RtcManager集成和实时语音识别结果显示
 
 ## Story
 
@@ -12,7 +12,7 @@
 **I want** 将现有的stt-demo应用中的语音转文字功能封装成通用的TypeScript SDK,
 **so that** 我可以在任何TypeScript项目中轻松使用语音转文字功能,而不依赖特定框架。
 
-**验收标准扩展**: 在主应用中新增SDK测试页面,验证SDK在实际应用环境中的功能完整性,包括完整的音频传输功能。
+**验收标准扩展**: 在主应用中新增SDK测试页面,验证SDK在实际应用环境中的功能完整性,包括完整的音频传输功能和实时语音识别结果显示
 
 ## Acceptance Criteria
 
@@ -29,6 +29,9 @@
 11. **实现RtcManagerAdapter适配器类**,封装真实RtcManager功能,支持音频传输
 12. **在SDK测试页面中集成RtcManager功能**,提供完整的音频传输测试环境
 13. **通过E2E测试验证完整的音频传输流程**,确保SDK能够进行实际的语音转文字操作
+14. **实现实时语音识别结果显示功能**,在SDK测试页面中显示转录文本和翻译结果
+15. **集成多语言字幕显示组件**,支持实时滚动字幕效果
+16. **监听和处理转录结果事件**,确保实时更新显示内容
 
 ## Tasks / Subtasks
 
@@ -102,6 +105,13 @@
   - [ ] 编写RtcManagerAdapter单元测试
   - [ ] 更新SDK测试页面,添加音频传输测试功能
   - [ ] 扩展E2E测试,验证完整的音频传输流程
+- [ ] Task 11: **实现实时语音识别结果显示** (AC: 14,15,16)
+  - [ ] 在SDK测试页面中添加实时转录结果显示区域
+  - [ ] 实现转录结果事件监听和处理机制
+  - [ ] 集成多语言字幕显示组件,支持滚动字幕效果
+  - [ ] 添加转录文本和翻译结果的实时更新
+  - [ ] 实现多语言切换和显示配置
+  - [ ] 扩展E2E测试,验证实时结果显示功能
 
 ## Dev Notes
 
@@ -211,6 +221,31 @@ const routerItems = [
 ]
 ```
 
+### 实时语音识别结果显示问题分析
+
+**问题识别**:
+
+- 当前SDK测试页面缺少实时语音识别结果显示功能
+- 与主应用相比,SDK测试页面只显示状态信息,不显示实际转录内容
+- 缺少类似主应用的字幕显示组件和滚动字幕效果
+- 没有监听和处理转录结果事件
+
+**缺失功能对比**:
+
+| 功能             | 主应用          | SDK测试页面 |
+| ---------------- | --------------- | ----------- |
+| 实时转录结果显示 | ✅ 完整字幕组件 | ❌ 缺失     |
+| 多语言支持显示   | ✅ 支持多语言   | ❌ 缺失     |
+| 滚动字幕效果     | ✅ 动画效果     | ❌ 缺失     |
+| 转录结果事件监听 | ✅ 完整事件处理 | ❌ 缺失     |
+
+**修复方案**:
+
+- 在SDK测试页面中添加实时转录结果显示区域
+- 集成主应用的字幕显示组件
+- 实现转录结果事件监听和处理
+- 支持多语言转录和翻译结果显示
+
 ### CERTIFICATE修复说明
 
 **问题分析**:
@@ -316,21 +351,22 @@ 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 |
-| 2025-09-26 | 2.2     | **发现功能不完整**:识别SDK缺少RtcManager集成,更新故事状态和验收标准             | Bob (SM)    |
+| 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)    |
+| 2025-09-26 | 2.3     | **识别实时语音识别结果显示缺失**:发现SDK测试页面缺少转录结果显示功能,添加相关任务 | Bob (SM)    |
 
 ## Dev Agent Record
 
@@ -366,6 +402,13 @@ export const testLanguages = ["zh-CN", "en-US", "ja-JP"]
 - [ ] 集成到SDK测试页面
 - [ ] 扩展E2E测试验证音频传输
 
+13. ❌ **实时语音识别结果显示**: 需要在SDK测试页面中添加转录结果显示功能
+
+- [ ] 添加实时转录结果显示区域
+- [ ] 实现转录结果事件监听和处理
+- [ ] 集成多语言字幕显示组件
+- [ ] 扩展E2E测试验证实时结果显示
+
 ### File List
 
 **新增/修改的文件:**