Neocortex Logo

如何在 Unity 中让 NPC 用 ChatGPT 说话

在 Unity 中让 NPC 用 ChatGPT 说话:用 UnityWebRequest 调用 OpenAI API,了解它还需要你自己构建什么,并以更快的方式添加一个有声角色。

Sercan AltundasFounder of Neocortex

· 阅读约 9 分钟

在 Unity 中让 NPC 用 ChatGPT 说话:用 UnityWebRequest 调用 OpenAI API,了解它还需要你自己构建什么,并以更快的方式添加一个有声角色。

“ChatGPT NPC”是大多数 Unity 开发者最初想象 AI 角色的方式:把玩家输入的内容发送给语言模型,然后把答案显示在 NPC 头顶。本指南正是用 OpenAI API 构建这样一个角色,然后说明它还留给你解决哪些问题,以及同一个 NPC 在 Neocortex Unity SDK 中会是什么样子。

路线 1:自己调用 OpenAI API

你需要一个 OpenAI API 密钥和一个 Unity 项目。NPC 会保存一个消息列表,以一条系统提示开头,说明角色是谁,并在玩家每次说话时发送整个列表:

using System;
using System.Collections;
using System.Collections.Generic;
using System.Text;
using UnityEngine;
using UnityEngine.Networking;

public class ChatGptNpc : MonoBehaviour
{
    [Serializable] class Message { public string role; public string content; }
    [Serializable] class ChatRequest { public string model; public Message[] messages; }
    [Serializable] class Choice { public Message message; }
    [Serializable] class ChatResult { public Choice[] choices; }

    [SerializeField] private string apiKey; // for local testing only, never ship it
    private readonly List<Message> history = new()
    {
        new Message { role = "system", content = "You are Brannoch, a gruff village blacksmith. Answer in one or two sentences." }
    };

    public IEnumerator Ask(string playerLine)
    {
        history.Add(new Message { role = "user", content = playerLine });
        string body = JsonUtility.ToJson(new ChatRequest { model = "MODEL_NAME", messages = history.ToArray() });

        using var request = new UnityWebRequest("https://api.openai.com/v1/chat/completions", "POST");
        request.uploadHandler = new UploadHandlerRaw(Encoding.UTF8.GetBytes(body));
        request.downloadHandler = new DownloadHandlerBuffer();
        request.SetRequestHeader("Content-Type", "application/json");
        request.SetRequestHeader("Authorization", "Bearer " + apiKey);
        yield return request.SendWebRequest();

        if (request.result != UnityWebRequest.Result.Success) { Debug.LogWarning(request.error); yield break; }
        Message reply = JsonUtility.FromJson<ChatResult>(request.downloadHandler.text).choices[0].message;
        history.Add(reply);
        Debug.Log(reply.content); // show it in your dialogue UI
    }
}

把 MODEL_NAME 替换为 OpenAI 文档中的当前模型,调用 StartCoroutine(npc.Ask("Got any work?")),Brannoch 就会作出回答。这大约四十行代码,就是一个可运行的原型。

原型还留给你构建的内容

第一次对话是最容易的部分。要把它发布出去,你还需要解决:

  • 密钥。 打包进构建中的 OpenAI 密钥,任何人都能提取出来,并且会耗尽你整个账户的额度。你需要在游戏和 API 之间架设一台属于你自己的服务器。
  • 语音。 玩家语音需要语音转文字,回复需要文字转语音,两者之间还要流式衔接,否则每次回答都要等两者都完成。我们的语音管线指南对此做了详细拆解。
  • 情绪与行为。 回复只是纯文本。要驱动动画或游戏玩法,你需要提示模型输出 JSON,再解析它,并处理格式错误的情况。
  • 历史记录。 列表会随着每一句台词不断增长,成本和延迟也会随之增加。你需要进行裁剪或生成摘要。
  • 保持角色设定。 仅靠一条系统提示,在玩家施压时很快就会失效。请参阅如何让 AI NPC 保持角色。
  • 成本控制。 没有任何机制阻止某个玩家整天和 NPC 聊天,并让你的账单飙升。

路线 2:使用 Neocortex 实现同一个 NPC

使用 Neocortex,你只需在浏览器编辑器中设计一次 Brannoch,包括性格、世界、知识库、声音和行为,其余工作由 Unity SDK 处理:

  1. 在 Unity 中,通过 git URL 添加该包:https://github.com/neocortex-link/neocortex-unity-sdk.git
  2. 在 Tools > Neocortex > Settings 中粘贴你的 API 密钥。
  3. 右键点击 Hierarchy,选择 Neocortex > Complete Voice Chat,然后在 Smart Agent 的下拉菜单中选择 Brannoch。
  4. 按下 Play 并开始交谈。

在代码中,一个文字问题配以语音回答只需一次调用:

agent.TextToAudio("Got any work?"); // agent is a NeocortexSmartAgent

每条回复都以台词的形式返回,每句台词都带有一个情绪,此外还包括带有目标对象 ID 的行为,因此动画和游戏玩法可以挂接到 Unity 事件上,而无需解析文本。我们的分步Unity AI 角色教程展示了完整的设置过程。

并排对比

直接使用 OpenAI APINeocortex Unity SDK
第一条文字回复约 40 行代码无需代码
语音输入与输出自行构建:STT、TTS、流式传输一个组件,流式播放
每句台词的情绪提示模型输出并解析内置,17 种情绪
行为提示输出 JSON 并进行验证在编辑器中定义,以数据形式发送
密钥保护你自己的服务器每个密钥均设有按玩家和按角色的限制
WebGL 麦克风Unity 中不提供包含的模板
角色设计一条系统提示可视化编辑器,支持在浏览器中测试

自己动手路线中的常见问题

  • “回复被截断了。” 模型达到了输出上限。请在系统提示中要求简短的回答,这样对话也会更好。
  • “它忘记了我们说过的话。” 你必须每次都发送完整的历史记录。语言模型在请求之间不会记住任何东西。
  • “能把它作为 WebGL 构建发布吗?” 密钥留在其中就不行:任何人都可以在浏览器的网络面板中读取它。请通过你自己的服务器发送请求。

后续步骤

要在 Unity 中进一步使用 Neocortex,可以添加语音聊天和脚本台词的文字转语音。如果你希望在原型阶段于自己的机器上运行模型,请参阅如何在 Unity 中本地运行 LLM。所有教程都收录在构建 AI NPC 指南中。

核查于 2026 年 11 月。Neocortex 与 OpenAI 没有关联。

常见问题

我能在 Unity 中用 ChatGPT 为 NPC 提供对话吗?

可以。你可以使用 UnityWebRequest 和描述角色的系统提示,从 Unity 调用 OpenAI API。如果你希望在不自己构建的情况下获得语音、情绪、行为和密钥限制,Neocortex 通过其 Unity SDK 为你提供完整的角色。

把 OpenAI API 密钥放进 Unity 游戏里安全吗?

不安全。构建中的任何内容都可以被提取,而 OpenAI 密钥可以完全控制你账户的支出。如果你直接调用 OpenAI,请通过你自己的服务器转发请求。Neocortex 密钥可以设置按玩家和按角色的用量限制,由我们的服务器执行,你也可以在仪表盘中停用某个密钥。

如何让 ChatGPT NPC 保持角色设定?

编写具体的系统提示,描述世界,限制角色所知道的内容,并针对试图打破设定的玩家进行测试。Neocortex 角色在编辑器中通过世界、知识库和行为构建,并保持在你所描述的世界之内。

如何让 ChatGPT NPC 开口说话?

你需要为玩家提供语音转文字,为回复提供文字转语音,并在两者之间进行流式衔接,以保持等待时间较短。Neocortex Unity SDK 只需一个组件即可完成这三项工作。

相关文章

继续阅读