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,23 @@
+# Windows 语音终端模拟器
+
+该程序使用Electron和火山引擎Web RTC SDK模拟一台真实语音终端。它采集Windows麦克风、加入平台分配的RTC房间、发布本地音频、订阅并播放豆包智能体音频，并通过设备v2接口完成激活、状态等待、心跳、Token续签和结束通话。
+
+## 构建
+
+```powershell
+Set-Location .\device-simulator-windows
+npm install
+npm run build
+```
+
+输出：`release/voice-device-simulator-0.1.0-windows-x64.exe`。
+
+## 安全边界
+
+- RTC AppKey、火山AK/SK和豆包Access Token只存在本地后端的受保护文件中；
+- 模拟器安装包只接收平台签发的短期RTC Token；
+- 设备签名密钥只驻留Electron主进程内存，不写入浏览器存储；
+- 当前构建只允许设备API地址指向`localhost`或`127.0.0.1`，避免误连服务器环境；
+- 关闭软件或结束通话时停止音频采集并销毁RTC引擎。
+
+完整本地启动顺序见[本地真实RTC联调说明](../deploy/local-rtc/README.md)。