快速入门

安装 Convai Unreal Engine 插件、配置 API 密钥，并放置你的第一个会说话角色——按顺序完成核心路径可获得最快结果。

在本节结束时，您的项目将在 Unreal Engine 中包含一个可用的 Convai 角色。请按顺序按照核心路径页面进行操作——每一步都直接建立在上一步的基础上。角色骨骼和配置页面是可选分支，您可以在第一次对话正常工作后按任意顺序完成。

开始之前： 请确认您的环境满足 先决条件 页面上的要求——引擎版本、账户、平台和网络访问。

准备工作

先决条件 安装前请验证引擎版本、账户、平台和网络要求。

安装 Convai 插件 从 Fab 或 GitHub Releases 安装，并在您的项目中启用该插件。

核心路径

配置您的 API 密钥 通过 Convai 编辑器窗口登录并存储您的 API 密钥。

场景组件参考 Convai Chatbot、Player、Object 和 Face Sync 组件及其字段的参考。

添加您的第一个 Convai 角色 将一个 Convai 角色放置到关卡中，并与其进行实时语音对话。

角色骨骼

将 Convai 添加到特定角色类型。请在第一次对话正常工作后完成此步骤。

设置 MetaHuman 角色 在您的项目中将 Convai 口型同步和动画连接到 MetaHuman 角色。

设置 Reallusion（CC）角色 导出 Reallusion CC4 或 CC5 头像，将其导入 Unreal，并连接 Convai。

配置

在第一次对话正常工作后调整音频、输入和 UI。每个页面都是独立的。

配置麦克风 选择采集设备并调整音量，以便玩家的声音能够传达到角色。

配置角色音频 调整语音播放音量，启用空间音频衰减，并设置中断淡出时长。

配置对话输入 在按键说话和免提模式之间切换，调整 VAD 设置，并发送文本消息。

添加聊天 UI 添加内置覆盖层或 3D 世界内小组件，或者将自定义小组件连接到转录委托。

验证你的设置

验证你的设置 在添加功能之前，通过检查清单确认设置中的每个部分都能正常工作。

下一步

在验证设置之后，浏览“功能”部分，为您的角色添加 Actions、Emotion、Long-Term Memory 或 Vision。

功能

在进一步构建之前，请先查看核心概念，以更深入地理解对话流程和组件架构。

核心概念