feat: add Windows real RTC voice device simulator

2026-08-27 11:02:32 +08:00
parent 3b827431c8
commit 5ff1961d79
18 changed files with 6036 additions and 0 deletions
@@ -0,0 +1,41 @@
+# Windows 本地真实 RTC 联调
+
+该覆盖层只用于本机联调，不访问阿里云服务器。它把 API 的 RTC Token 签发器和 Worker 的语音供应商切换到火山引擎，同时保留数据库、Redis、MinIO、Keycloak和告警模拟器在本地 Docker 中运行。
+
+## 1. 生成本地凭据
+
+在项目根目录运行：
+
+```powershell
+.\deploy\local-rtc\configure.ps1
+```
+
+脚本会以隐藏输入方式依次读取：
+
+- RTC AppKey；
+- 火山引擎 AccessKey ID / Secret AccessKey；
+- 豆包端到端语音 APP ID / Access Token；
+- 豆包音色 ID。
+
+密钥文件只生成到`deploy/local-rtc/runtime`，该目录不会提交到 Git。当前首轮联调使用豆包 S2S-O 纯端到端模式（`OutputMode=0`），平台本地路由仍沿用`s2s_hybrid`模板槽位；这是为了只依赖豆包端到端语音凭据，先验证真实双向音频。后续接入火山方舟 Endpoint 后再切换真正的混合编排模式。
+
+## 2. 启动本地后端
+
+```powershell
+.\deploy\local-rtc\start.ps1
+```
+
+首次构建需要下载 Docker 基础镜像。脚本会等待`http://localhost:58080/health/ready`可用。
+
+## 3. 启动模拟器
+
+双击`device-simulator-windows/release/voice-device-simulator-0.1.0-windows-x64.exe`，然后：
+
+1. 保持默认本地平台地址、设备 ID 和本地测试设备密钥；
+2. 点击“检测平台和音频设备”；
+3. 选择麦克风和扬声器；
+4. 点击“开始语音聊天”；
+5. 看到“豆包语音任务已激活”后直接说话；
+6. 点击“结束通话”验证`StopVoiceChat`和RTC离房。
+
+RTC AppKey、火山 AK/SK 和豆包 Access Token 均不进入模拟器安装包，也不会通过渲染页面读取。