Unity WebGL 与浏览器游戏的 AI NPC:2026 年哪些可行
Unity 的 WebGL 构建不支持麦克风输入。哪些 AI NPC 工具可以在浏览器中运行,以及如何让带语音的角色在 Unity WebGL 中跑起来。
Neocortex TeamThe team behind Neocortex
· 更新于 2026年10月20日 · 阅读约 6 分钟

你的 AI NPC 在 Unity 编辑器中运行得完美无缺。你点击 Build,把 WebGL 构建上传到 itch.io,打开链接,按下对话按钮,然后什么也没有发生。 没有报错,没有转写文本,没有回复。角色只是呆呆地站在那里。
这是 AI NPC 在浏览器游戏中出故障最常见的方式,其原因很简单:Unity 在 WebGL 构建中不支持 Microphone 类。浏览器游戏仍然是让玩家最快接触到游戏的方式(无需安装,只需一个链接),因此本文将讲解语音为何会失效,哪些 AI NPC 工具可以在 Unity WebGL 和浏览器中运行,以及如何交付一个第一次点击就能工作的带语音角色。
为什么 WebGL 构建中语音会失效
在桌面端,Unity 直接读取麦克风。在浏览器中,它做不到:麦克风由浏览器掌控,它会放在权限提示之后,并且只向 JavaScript 开放。 Unity 内置的 Microphone API 在 WebGL 中不可用,因此任何依赖它的 AI NPC 工具都会在编辑器中正常工作,但在你的浏览器构建中悄无声息地失败。
音频输出也有它自己的问题。Unity 的部分可编写脚本的音频回调在 WebGL 中同样不可用,因此通过这些回调传输语音的工具需要一条浏览器端的音频通道。 此外,浏览器还有两条自己的规则:页面必须通过 HTTPS 提供,并且只有在玩家点击或轻触之后,音频才能开始播放。
能在 WebGL 中工作的工具,必须通过浏览器音频与 Unity 之间的桥接来解决上述所有问题。
哪些 AI NPC 工具可以在 Unity WebGL 和浏览器中使用
| 工具 | Unity WebGL | WebGL 中的语音输入 | 普通网页或 JS | 备注 |
|---|---|---|---|---|
| Neocortex | 支持 | 支持,通过 SDK 的 WebGL 模板 | Web SDK(npm)和 Web API | 同一角色可用于 WebGL、桌面、移动端和其他引擎 |
| Convai | 支持,列于其 Unity 平台矩阵中 | 支持,需要 HTTPS 和用户手势 | Web SDK、PlayCanvas 插件 | 远程音频通过浏览器播放,而非 Unity 的 AudioSource |
| Inworld | Unity Runtime SDK 未列出 | 未记录 | Node.js Runtime SDK | 旧版 Unity SDK 附带了 WebGL 麦克风插件 |
| Charisma.ai | 未记录 | 未记录 | 带语音识别辅助功能的 JS 和 React SDK | 侧重故事,仅限云端 |
| Player2 | Unity SDK 代码库中有 WebGL 音频脚本,但未记录为受支持的平台 | 不明确 | 直接使用 API | 玩家需要 Player2 账户 |
| ElevenLabs Agents | 早期阶段的 Unity SDK,附带 WebGL 桥接,需要 Unity 6.3 LTS 或更高版本 | 支持,通过该桥接 | 基于 WebRTC 的浏览器 SDK | 语音智能体,而非游戏角色 |
六个步骤,把带语音的 NPC 发布到 Unity WebGL
Neocortex 通过一个 WebGL 模板 解决麦克风问题,该模板把浏览器音频桥接到 Unity。我们写过它的工作原理。简而言之:
- 安装 Neocortex Unity SDK。 WebGL 模板会随之一起导入。你也可以通过
Tools > Neocortex > Import WebGL Template导入。 - 将构建目标切换为 WebGL。
- 选择模板。 在
Project Settings > Player > Resolution and Presentation中,将 WebGL Template 设为 Neocortex。你可以调整模板样式,使其与你的页面相匹配。 - 从 WebGL Audio Sample 开始。 从 Package Manager 导入示例,并将场景添加到构建中。
- 点击时启动麦克风。 将录音与玩家按下的按钮或按键绑定,这样浏览器的权限提示会出现在合理的时刻。
- 通过 HTTPS 构建并测试。 上传到提供 HTTPS 的主机,并至少在两个浏览器中测试。
此后,你在桌面端使用的同一套语音组件即可在浏览器中工作,回复也会以角色的声音流式返回。
上传之前:浏览器构建检查清单
- HTTPS。 浏览器只允许在安全页面上访问麦克风。开发阶段的
localhost是例外。 - 用户手势。 麦克风和音频只有在玩家点击或轻触之后才会开始。
- iframe。 如果你的游戏运行在另一个页面之内(许多游戏门户都会这样做),该 iframe 需要获得使用麦克风的权限。
- 密钥。 将 WebGL 构建中的所有内容都视为公开的,因为任何人都可以读取它。检查你的构建中包含哪些密钥,以及它们允许做什么。
- 构建体积。 本地模型在浏览器中很少实用,因此云端推理是常态。
- 备用方案。 为拒绝麦克风权限提示的玩家提供文字输入。
发布浏览器构建之前的常见问题
我能在 WebGL 构建中运行本地模型吗?
很少能。模型文件从几百兆字节到几吉字节不等,对浏览器游戏来说下载耗时很长,而且 WebGL 构建的内存限制很严格。云端推理可以让构建保持较小,并让首次对话更快。
玩家每次都必须允许麦克风访问吗?
页面第一次请求麦克风时,浏览器会询问,并根据各浏览器自己的规则为每个站点记住该答案。请为选择拒绝的玩家做好规划。
我能在普通网页游戏中使用同一个角色吗?
可以。Neocortex 的 Web API 可以从任何语言调用,因此为 Unity WebGL 构建的角色也能在 JavaScript 游戏、网站或后端服务中对话。
它能在 itch.io 和其他游戏门户上运行吗?
许多门户会把你的构建以 iframe 的形式嵌入其自己的页面。此时麦克风访问取决于该 iframe 授予的权限,因此请直接在门户上测试语音,而不仅仅是在你自己的 HTTPS 主机上测试,并为浏览器拦截麦克风的玩家保留文字备用方案。
角色回答时玩家应该看到什么?
浏览器游戏在台词之间没有加载画面,因此要显示状态。语音转文字一返回就显示转写文本,在回复到达前显示"思考中"的指示,并让流式语音尽早开始。玩家可以接受他们能看到的短暂等待,但无法接受一个看起来毫无反应的按钮。
我的 WebGL 构建与桌面构建之间有什么区别?
使用 Neocortex 时,角色保持不变。你在浏览器构建中开启 WebGL 模板,其余部分由语音组件处理。
简而言之
WebGL 中的语音需要在浏览器麦克风与 Unity 之间架设一座桥梁,而大多数 AI NPC 工具要么把这件事留给你,要么记录得很含糊。Neocortex 在 SDK 中内置了这座桥梁:在浏览器中提供麦克风输入和流式语音回复;一个角色可同时运行于你的 WebGL 构建、桌面构建以及 Web API;此外还有可视化编辑器,设计师可以在其中掌控性格、情绪、知识、意图和动作,并在任何构建之前于浏览器中进行测试。
工具详情最后核查于 2026 年 10 月。
常见问题
Unity 在 WebGL 中支持麦克风吗?
不支持,Unity 内置的 Microphone 类无法在 WebGL 构建中工作。Neocortex Unity SDK 包含一个 WebGL 模板,可将浏览器麦克风引入 Unity,因此语音 NPC 可以在浏览器中工作。
Convai 能在 Unity WebGL 中运行吗?
可以,Convai 在其 Unity 平台矩阵中列出了 WebGL,并要求麦克风使用 HTTPS 并需要用户手势。Neocortex 同样支持在 Unity WebGL 中进行语音输入,并且可以使用与你在桌面端、Unreal 和 Godot 中相同的角色。
ElevenLabs 有 Unity SDK 吗?
有,ElevenLabs 为 Unity 6.3 LTS 及更高版本提供了一个处于早期阶段的 ElevenAgents SDK,附带 WebGL 桥接,专为语音智能体而构建。Neocortex 则为你提供在可视化编辑器中设计性格、知识、情绪和动作的游戏角色。
为什么我的 AI NPC 麦克风在 Unity 编辑器中可用,在浏览器中却不行?
Unity 的 Microphone API 在 WebGL 中不可用,因此浏览器构建没有音频输入。将你的构建切换到 Neocortex WebGL 模板,同样的语音组件即可在浏览器中工作。
浏览器游戏的语音聊天需要 HTTPS 吗?
需要。浏览器只允许在安全页面上访问麦克风,开发阶段的 localhost 除外。请通过 HTTPS 托管你的 Neocortex WebGL 构建,并在点击或轻触之后再启动麦克风。






