# 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 均不进入模拟器安装包，也不会通过渲染页面读取。