> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin.md).

# Convai Unreal Engine 插件

Convai Unreal Engine 插件将 Unreal Engine 5 项目连接到 Convai，将对话式 AI 引入训练模拟、交互式体验和游戏中。场景中的角色可进行实时语音和文本对话、表达情绪、让面部动画与语音同步，并响应玩家行为——所有这些都可按项目进行配置。核心运行时工作流以 Blueprint 为先：配置角色、驱动对话，并通过 Blueprint 图表连接大多数功能行为，而无需编写 C++。每个功能均可按需启用，并建立在核心组件之上；只添加项目所需的部分。

{% hint style="info" %}
**插件新手？** 跟随 [快速上手](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/getting-started.md) 以安装、配置 API 密钥并运行你的第一个 AI 角色。
{% endhint %}

### 了解插件

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>概述</strong><br>插件是什么、其模块如何组织，以及每项功能的概览。</td><td><a href="/pages/ef9c025d624fb7a7ea50155c9296da1e2034da53">/pages/ef9c025d624fb7a7ea50155c9296da1e2034da53</a></td></tr><tr><td><strong>兼容性与要求</strong><br>UE 5.x 版本支持、平台目标和角色骨骼兼容性。</td><td><a href="/pages/c0b1130cf155d2cf91b5a9d03994277bafb81c6f">/pages/c0b1130cf155d2cf91b5a9d03994277bafb81c6f</a></td></tr><tr><td><strong>快速上手</strong><br>安装插件，配置你的 API 密钥，并添加你的第一个 AI 角色。</td><td><a href="/pages/fb3a2bacc1ba8d2d274717ebd7a3ac02e56aabb8">/pages/fb3a2bacc1ba8d2d274717ebd7a3ac02e56aabb8</a></td></tr><tr><td><strong>核心概念</strong><br>运行时架构、会话生命周期、对话流程和 Blueprint 事件。</td><td><a href="/pages/d4d67f0a1b2a7584ab386f8d7585472886dfd1d6">/pages/d4d67f0a1b2a7584ab386f8d7585472886dfd1d6</a></td></tr></tbody></table>

### 功能

每个功能均可按需启用，并建立在核心组件之上。

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>角色动作</strong><br>角色在场景中执行带类型的命令（移动到、跟随、自定义）。</td><td><a href="/pages/46d3b8351132c46e6470ee20811d82cf5cae7051">/pages/46d3b8351132c46e6470ee20811d82cf5cae7051</a></td></tr><tr><td><strong>动态上下文</strong><br>在运行时将实时世界状态和事件推送到角色知识中。</td><td><a href="/pages/f1aab12e2433cc2eba9f8b33106fed6d232fe3de">/pages/f1aab12e2433cc2eba9f8b33106fed6d232fe3de</a></td></tr><tr><td><strong>情绪</strong><br>Convai 从对话中推断情绪，并驱动 BlendShape 表情。</td><td><a href="/pages/dac8d878741e85925d7a212fef1afa2b99e74a9d">/pages/dac8d878741e85925d7a212fef1afa2b99e74a9d</a></td></tr><tr><td><strong>长期记忆</strong><br>角色使用终端用户 ID 记住每位玩家，并可跨会话保留记忆。</td><td><a href="/pages/19f4740b1fd265f1b629850b246b7b0621411221">/pages/19f4740b1fd265f1b629850b246b7b0621411221</a></td></tr><tr><td><strong>叙事设计</strong><br>从 Blueprint 中按名称触发脚本化对话分支和段落。</td><td><a href="/pages/c50f2cbde2d775fd6a1147c0ab6bbcf15218f3a6">/pages/c50f2cbde2d775fd6a1147c0ab6bbcf15218f3a6</a></td></tr><tr><td><strong>场景元数据</strong><br>为关卡中的 Actor 添加标签，使角色能够识别并对其进行交互。</td><td><a href="/pages/ae13b29a517504598ad569023c6483ae28a3af7b">/pages/ae13b29a517504598ad569023c6483ae28a3af7b</a></td></tr><tr><td><strong>视觉</strong><br>将摄像机画面流式传输到 Convai，使角色能够描述他们所看到的内容。</td><td><a href="/pages/efe0ea28574973991aa04b83a3d8227caa960b67">/pages/efe0ea28574973991aa04b83a3d8227caa960b67</a></td></tr><tr><td><strong>凝视注意力</strong><br>将玩家准星下的对象作为上下文路由给当前激活的角色。</td><td><a href="/pages/4a5f4bca34572e7102d0b723f97623ed14ebc472">/pages/4a5f4bca34572e7102d0b723f97623ed14ebc472</a></td></tr><tr><td><strong>口型同步</strong><br>实时根据响应音频驱动嘴部和面部 BlendShape。</td><td><a href="/pages/cc7d248786c91571b1e6761c7044cd749219d47a">/pages/cc7d248786c91571b1e6761c7044cd749219d47a</a></td></tr></tbody></table>

### 引用

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>高级主题</strong><br>生产环境认证和集成指南，超出核心设置流程之外的内容。</td><td><a href="/pages/d5eed70628f2e340b85537ef7227b7f8cf81b816">/pages/d5eed70628f2e340b85537ef7227b7f8cf81b816</a></td></tr><tr><td><strong>Blueprint 参考</strong><br>所有组件的完整属性、函数和事件接口。</td><td><a href="/pages/26fe50d5079489485020bc3a2ecb408f1264666e">/pages/26fe50d5079489485020bc3a2ecb408f1264666e</a></td></tr><tr><td><strong>Convai 编辑器窗口</strong><br>在编辑器内登录、浏览示例并导出诊断日志。</td><td><a href="/pages/e2e7f8bd503c5aafc00031c0b28f89d4c6f98f44">/pages/e2e7f8bd503c5aafc00031c0b28f89d4c6f98f44</a></td></tr><tr><td><strong>故障排查</strong><br>常见故障模式、诊断步骤和已知问题。</td><td><a href="/pages/2c318643919de48c794a1f4b6b1eb25b6e0ed166">/pages/2c318643919de48c794a1f4b6b1eb25b6e0ed166</a></td></tr></tbody></table>

### 最新版本

<code class="expression">space.vars.unreal\_plugin\_version</code> 包含由 LLM 发出的角色动作自动触发的手势和指向动画， `UConvaiObjectComponent` 用于为关卡 Actor 添加实时场景属性标记、带轮廓高亮和屏幕光标的凝视驱动注意力，以及模糊枚举匹配，因此轻微的 AI 拼写差异不再会导致动作参数丢失。请参见 [发布说明](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/overview/release-notes.md) 以查看完整更新日志。

### 下一步

{% content-ref url="/pages/fb3a2bacc1ba8d2d274717ebd7a3ac02e56aabb8" %}
[快速上手](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/getting-started.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.