Roblox 语音转文本 API（Beta 版）

此API能：实现语音控制游戏；构建无障碍功能；打造 NPC 动态对话 等。

仅限英语可以用目前没有其他语言。

视频语音：

 火球

 火焰漩涡

 缩小射线

一、核心功能与用途

1. 实现语音控制游戏：玩家用语音指令（如 “施法”）操控玩法。
2. 构建无障碍功能：为游戏内语音内容添加字幕。
3. 打造 NPC 动态对话：结合文本生成、文本转语音 API，实现玩家与 NPC 全语音交互。

二、使用步骤与配置

1. 开启麦克风：在 Roblox Studio 的「File > Game Settings > Communication」中勾选 “Enable Microphone”。
2. 控制语音广播（可选）：仅需语音转文本时，可断开AudioDeviceInput与AudioEmitter连接，或在VoiceChatService中禁用EnableDefaultVoice，同时确保UseAudioApi开启。
3. 提升识别精度：建议玩家戴耳机，减少背景音（后续将优化回声消除）。
4. 集成与测试：将 API 接入脚本，传入音频获取文本，可参考官方教程代码。
5. 用户权限：仅 13 岁以上且完成验证（部分国家手机号验证，其他需身份证验证）、授权麦克风的用户可使用。

三、可观测性仪表板

在 Creator Hub 的「Monitoring > Speech-to-Text」中，可查看 API 请求量（含基于并发用户数的最大限额）、按状态码拆分的响应与错误率，支持自定义数据时间范围。

四、配额、延迟与安全

1. 配额（Beta 免费）：单请求音频最长 10 秒，每分钟最大请求数 = 1+5× 并发用户数，未来将支持付费扩容。
2. 延迟：音频输入完成后，文本生成平均耗时低于 500 毫秒，受音频长度和网络影响，后续将优化。
3. 安全：转录文本需过平台过滤器以符合《社区标准》，API 基于公开开源数据集训练。

五、未来计划

1. 优化技术：增强回声消除、降低延迟。
2. 扩展支持：新增多语言，接入扩展服务实现付费扩容，探索语音助手功能（将提前通知开发者避免唤醒词冲突）。