> 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/overview/release-notes.md).

# 发行说明

Convai Unreal Engine 插件的版本历史和重要变更，涵盖公开的 4.x 测试版发布和完整的 3.x 历史。

跟踪 Convai Unreal Engine 插件在各个版本中的变更。当前版本为 <code class="expression">space.vars.unreal\_plugin\_version</code>，支持 Unreal Engine <code class="expression">space.vars.unreal\_min\_version</code> 至 <code class="expression">space.vars.unreal\_max\_version</code>.

{% hint style="info" %}
此插件目前处于测试阶段。不同次要版本的测试版之间可能存在破坏性变更。插件清单将当前软件包标识为 <code class="expression">space.vars.unreal\_plugin\_version</code>.
{% endhint %}

{% updates format="full" %}
{% update date="2026-08-11" tags="4.0.0-beta.27" %}

## 4.0.0-beta.27

**破坏性 Blueprint 变更**

* `Invoke Speech` 和 `Invoke Narrative Design Trigger` 不再提供 `Generate Actions` 和 `Replicate On Network` 引脚。现在这两个节点都遵循聊天机器人的自身配置。连接了已移除引脚的现有 Blueprint 必须刷新节点后才能编译。
* `Invoke Speech` 新增了 `Delivery` 选项，因此语句可以等待安静时刻再播放，而不是打断对话；其消息现在也只会被听到一次，不再累积到对话上下文中。

**动作**

* 随附的 `BP Convai Chatbot Component` 现在包含可直接使用的 `Escort` 动作，因此角色无需重新构建 Blueprint 处理程序，就能引导玩家或其他角色前往目的地。未使用的 `Wait for Action` 条目已禁用。
* 改进了关卡关闭和垃圾回收期间的移动任务取消处理，因此任务取消时，不会再访问 Unreal 正在销毁的导航组件。

**空间感知**

* 角色现在可以从玩家的视角指引方向。现在，每个被描述的对象也会说明它相对于玩家摄像机的位置，因此玩家询问“它在哪里？”时，得到的答案会与所看到的内容一致。此功能由以下选项控制： `Describe From Player Perspective` 位于 **Project Settings > Plugins > Convai**中的 **空间感知** 类别下，且默认启用。

**音频和动画**

* 修复了对话进行中麦克风测试不执行任何操作的问题。现在，即使数据流处于打开状态，也可以录音；角色不会听到测试录音；测试结束后，项目的静音设置会恢复。
* 现在，身体和面部网格检测只会检查具有正在运行的动画 Blueprint 的网格，因此头发、布料和静态道具不会再被误认为角色的身体或面部。

**其他**

* 新增了可通过 Blueprint 访问的知识库操作，并修复了使用自定义 Convai 服务器 URL 的 REST 请求。
* 调试叠加层现在始终会显示完整信息：角色接收的原始环境描述句，以及 `FACTS` 和 `EVENTS` 部分，现在在所有构建版本中都可见。
  {% endupdate %}

{% update date="2026-08-05" tags="4.0.0-beta.26" %}

## 4.0.0-beta.26

**移动**

* 新增了可重复使用的 `Convai Move To` 和 `Convai Escort` Blueprint 节点。执行护送的角色可以引导他人前往目的地；当对方落后时等待，等对方跟上后继续前进，并处理目的地就在附近的情况。
* 改进了目标解析和合并对象导航，因此移动任务会选择可到达的目的地，并能区分已经抵达与本来就在目的地的情况。

**动作**

* 新增协作式行动计划取消功能。角色可以在行动进行时改变计划，自定义 Blueprint 行动也可以在替代行动开始前完成清理。
* 改进了参数化行动：现在能更可靠地处理命名值、空格、标点、本地化选项和对象形式的响应；大型行动列表和多字节文本也不再会被固定大小的缓冲区截断。

**其他**

* 改进了实时通信兼容性：正确报告支持的协议和客户端版本、识别当前生命周期消息，并转发交互 ID。
* 新增可选 Convai Pak Manager 所需的身份验证编辑器路由，并修复了外部编辑器插件解析自身 Convai 服务时的链接问题。
* 更新了随附的 AgentSkills 和行动文档，以反映新的移动、护送、取消和响应行为。
  {% endupdate %}

{% update date="2026-07-30" tags="4.0.0-beta.25.1" %}

## 4.0.0-beta.25.1

* 修复了从 Epic Games Launcher 安装的 Unreal Engine 5.8 上插件无法加载的问题。打开项目时会报告 `Plugin 'ConvAI' failed to load because module 'ConvaiToolset' could not be loaded`。现在项目可以正常打开。Unreal Engine 5.0 至 5.7 不受影响，无需进行任何更改。
* 加强了发布测试：现在每次更新发布前，都会在 UE 5.6、5.7 和 5.8 上自动验证其能否在 Unreal 编辑器中正常打开。
  {% endupdate %}

{% update date="2026-07-27" tags="4.0.0-beta.25" %}

## 4.0.0-beta.25

**移动与场景感知**

* 新增场景对象移动感知功能，涵盖移动方向、停止检测、五档灵敏度、可选移动状态以及可配置的启动和停止响应。
* 新增移动点和命名目的地，让角色能够选择可到达的接近位置、识别自己是否已抵达，并在路径开放或关闭时做出反应。
* 减少了重复对象和空间事实造成的提示重复，并改进了 Blueprint 移动的行动目标解析。

**动态上下文**

* 新增实时上下文更新的传递控制。响应事件可以等待自然停顿后再发送、在时机重要时立即发送，或静默更新角色。
* 改进了受跟踪属性的功能，包括嵌套对象路径、别名、Blueprint 重命名恢复、更清晰的 Details 面板，以及更简洁的变更描述。

**动作**

* 新增实验性 `Remind Self` 和 `Watch Property` 行动，帮助角色继续执行多步骤任务，并对下一个有意义的属性变更做出反应。

**工具**

* 新增 Convai 调试叠加层，可在开发期间检查周围环境、上下文状态、可达性、受跟踪属性和行动结果。

**迁移说明**

* 目标字段和 `Resolve Goal Location` 引脚在此版本中已重命名。升级后请刷新受影响的 Blueprint 节点。
  {% endupdate %}

{% update date="2026-06-25" tags="4.0.0-beta.24" %}

## 4.0.0-beta.24

**AI 编码代理**

* 在 Unreal Engine 5.8 上新增 MCP（Model Context Protocol）支持，让 AI 编码代理能够直接在编辑器中工作。
* 新增代理连接设置流程，支持 Claude Code、Cursor、VS Code、Gemini 或 Codex。
* 新增 Convai Toolset，其中包含一组可由 AI 调用的编辑器操作，让代理能够设置和扩展 Convai 角色，而无需手动编辑 Blueprint： `SetupConvaiCharacter`, `SetupConvaiPlayer`，以及 `SetupConvaiPawnMovement` 用于配置 MetaHuman 和玩家，以支持对话与导航； `AddNavMeshVolumeForCurrentLevel` 用于使关卡支持导航； `AddConvaiAction` 和 `CreateConvaiActionHandler` 用于声明行动并生成对应的处理程序事件；而 `SetBlueprintPropertyAndPropagate` 用于编辑属性，并将变更同步到已放置在关卡中的角色。
* 新增 Convai AgentSkills，这是供代理读取、帮助其正确使用 Convai 的编辑器内知识库，涵盖项目和角色设置、对话、行动、动画、动态上下文、注视、场景感知、叙事、玩家输入、视觉和表现力。

**兼容性**

* 该插件仍可在 UE 5.0 至 5.8 上编译。新工具仅用于编辑器，不依赖运行时，并在 UE 5.8 及更高版本上启用。
  {% endupdate %}

{% update date="2026-06-19" tags="4.0.0-beta.23-hotfix" %}

## 4.0.0-beta.23-hotfix

* 打包：插件现在以仅包含源代码的提交包形式提交到 Fab，不包含 Unreal 生成的 `Binaries` 或 `Intermediate` 文件夹，符合 Fab 要求的插件文件结构。
* 打包：移除了预编译 `Installed` 标志，因此 Fab 会针对每个引擎版本从源代码编译插件。
* 打包：现在每个模块都会声明 `PlatformAllowList`，这是 Fab 的要求。
  {% endupdate %}

{% update date="2026-06-18" tags="4.0.0-beta.23" %}

## 4.0.0-beta.23

* 新增对 Unreal Engine 5.8 的支持。
* 修复了 Android 麦克风采集问题。
* 通过线程安全地访问混合形状数据，提升了面部动画的稳定性。
  {% endupdate %}

{% update date="2026-06-14" tags="4.0.0-beta.22" %}

## 4.0.0-beta.22

**空间感知**

* 新增空间感知子系统，让每个聊天机器人持续感知周围环境，并以通俗易懂的事实描述传递给角色。它会根据视线范围，按照距离区间、方向和朝向，描述附近物体、其他角色以及玩家。
* 新增实体间关系，例如“位于压力板上方”或“在喷泉左侧”，并以最近的较高优先级邻居为参照。
* 在 **项目设置 > 插件 > Convai**中的 **空间感知** 类别下，新增总开关以及视线、距离区间和关系控制，并提供针对每个聊天机器人的周边环境和关系开关。
* **弃用了按对象设置的邻近机制。** 空间感知功能取代了该机制。

**场景对象**

* 新增了将名称相同的 Convai Object 组件合并为单个逻辑对象的功能，因此一堆木箱在角色看来会是一个整体。可通过每个组件上的 `Merge With Same-Named Objects`选择启用，并通过 `Merge Group Index`将不同集合分开。合并后的对象具有一个位置、一段描述和一个整体注视高亮。
* 新增全局设置 `Duplicate Name Suffix Style` ，可设置为 `Numeric` 或 `Alphabetical`，用于区分未合并的同名对象。

**动态上下文**

* 新增临时上下文事件： `Add Context Event` 新增了 `bEphemeral` 选项，可在下一次更新时恰好提示角色一次，且不会持久保存。
* `SetObjectInAttention` 现在默认会发出持续一个刷新周期的注意力提示，因此注视某个对象只会告知角色一次，不会留下持续状态。该调用还会记录警告，说明未生效的原因：聊天机器人已禁用操作、对象不在环境列表中，或对象不在连接时的操作配置中。

**其他**

* 新增 `FConvaiAvatarInfo`：获取角色的请求现在会返回完整的角色详情，而不只是角色 ID。
* 修复了指向动画，使其能够在角色发起的指向操作中正确播放并瞄准。
* 修复了踏上目标后的到达判定：如果角色站在宽大对象的占地范围内，现在会被视为已到达，而不会再因对象宽度超过其接受半径而始终无法判定到达。
* 修复了运行时忽略空间感知和名称重复设置的问题；现在，在项目设置中切换这些选项后，无需重启编辑器即可生效。
* 修复了聊天机器人断开连接时，单次刷新型临时上下文事件丢失的问题；刷新操作现在会延迟到重新连接后执行。
* 修复了报告无效采样率时可能发生的音频重采样器除零错误。
* 修复了 Convai 编辑器更新检查，使其能够正确检测 V4 版本发布；同时修复了编辑器主题初始化问题。
  {% endupdate %}

{% update date="2026-05-25" tags="4.0.0-beta.21" %}

## 4.0.0-beta.21

**动画和手势**

* 全面改进了捆绑的 MetaHuman 动画。
* 新增手势和指向动画，可由 LLM 发出的角色动作自动触发。
* 新增了复制同步的 `PointAtTarget` 以及 `LookAtTarget` ，并将其添加到聊天机器人组件中。

**物体感知和注视**

* 新增 `UConvaiObjectComponent` ，用于为 Actor 添加标签，并将其实时属性作为上下文提供给聊天机器人。
* 新增由注视驱动的注意机制：玩家注视的 Actor 会成为当前关注对象，并显示轮廓高亮和屏幕光标。
* 新增由距离驱动的状态：物体组件会报告对象是否处于聊天机器人 Pawn 的可触及范围内，以便机器人作出响应。

**动作**

* 在蓝图图表中新增右键菜单项“创建 Convai 动作处理器”，用于快速搭建带类型的动作处理器。
* 新增内容浏览器操作“设置 Convai Pawn 移动”，可为任意 Pawn 蓝图设置导航默认值。
* 新增组件和插槽目标支持，以及针对每个条目的动作移动覆盖设置。
* 改进了动作完成流程：处理器可以等待机器人语音播放完毕后再执行下一动作、在同一次调用中发送动态上下文事件，并干净地中止无法恢复的序列。
* 为枚举和选项动作参数新增模糊匹配，避免因 LLM 拼写略有偏差而丢弃动作。
* 将动作线路格式切换为 `{name}` 花括号格式，并改进了响应解析的可靠性。
* 默认在聊天机器人环境中启用动作。

**音频和口型同步**

* 在项目设置和连接请求中新增 VAD（语音活动检测）参数。
* 改进了语句尾部音频处理，减少轻声收尾辅音被截断的情况。
* 改进了口型同步稳定性：当帧短暂停止到达时，会启用数据不足回退机制。
* 修复了麦克风热切换问题，现在会话期间切换设备无需重启音频流。

**其他改进**

* 新增 Convai 身份验证缓存，后续连接无需从头重新验证。
* 新增 `GetBodyAndFaceSkeletalMeshComponents` 辅助函数，用于解析 MetaHuman 和 CC5 骨架。

**错误修复和兼容性**

* 修复了应用关闭时 Android 崩溃的问题。
* 修复了多个 UE 5.0 / 5.4 / 5.5 / 5.7 编译和兼容性问题，使插件能够在所有受支持的引擎版本中顺利构建。
* 在 UE 5.1 及更早版本中禁用了 Convai 编辑器 UI（该功能依赖的属性绑定编辑器功能在这些版本中不可用）。
* 在 UE 5.0 下重新生成了注视高亮材质，使该资源能够在所有受支持的引擎版本中加载。
  {% endupdate %}

{% update date="2026-05-01" tags="4.0.0-beta.19" %}

## 4.0.0-beta.19

* 将动作集成到 WebRTC：聊天机器人现在会在连接时发送 `action_config` （当 `bEnableActions` 启用时），并将结构化动作响应负载解析为带类型的动作序列。
* 重构 `Environment` 从 `UConvaiEnvironment` UObject 到 `FConvaiEnvironmentData` USTRUCT。为聊天机器人提供对象、角色和动作的细粒度添加/移除/清除方法；延迟刷新场景元数据； `bFlushImmediately` 高级可选启用项，用于时间敏感的更新。
* 将旧版 `MainCharacter` 拆分为 `ConversationPartner` （已复制、感知场景）和 `LookAtTarget` （仅用于动画）。新增 `bAutoFillConversationPartnerFromPlayer` 开关，可自动将首个已注册的 Convai Player 组件设为对话对象。
* 新增 `SetObjectInAttention` 会触发动态上下文刷新，并在条目不存在时自动将其注册到 `Environment.Objects` 中。
* 新增 `bEnableActions` 聊天机器人开关。 `Environment.Actions` 默认预置 `Move To`, `Follow`, `Stop Moving`和 `Wait For`.
* Actions V2 — 类型化动作模板： `FConvaiAction` 及其结构化的 `Parameters` 通过 `EConvaiActionParamType`进行类型指定。可选的 `Connector` 用于复合动作， `Choices` 用于固定列表约束，或使用 `EnumType` 从 `UENUM`.
* 统一的动作结果结构： `FConvaiResultAction.Parameters` 类型为 `TMap<FString, FConvaiResultParam>`。旧版 `RelatedObjectOrCharacter` 和 `ConvaiExtraParams` 作为已弃用的镜像字段保留。
* 新增 Blueprint 纯访问器： `Get First Param`, `Get Param`, `Get Param Type`, `Get Param As String/Number/Bool/Ref/Byte`, `Has Param`.
* `HandleActionCompletion` 新增可选参数 `AdditionalNote` 和 `ShouldRespond`。新增 `AbortActionSequence` 接受可选参数 `EventText` 并清空队列，不再重试。
* 移除了 `EnableNewActionSystem` 全局开关——现在始终启用操作队列路径。
* 向后兼容：旧版 `UConvaiEnvironment` 和 `UConvaiActionContext` 已重新引入为已弃用的兼容替代项，以便旧版 Blueprint 图表继续通过编译，并显示弃用警告。
  {% endupdate %}

{% update date="2026-04-24" tags="4.0.0-beta.18" %}

## 4.0.0-beta.18

* 新增 Android 打包支持。
* 为聊天机器人交互新增动态上下文批处理和日志记录，以减少冗余更新。
* 新增饥饿混合和可播放帧检查，以提升口型同步的稳定性。
* 新增用于口型同步动画参数的命令行覆盖选项，以及模拟冻结功能。
* 为以下对象新增自定义参数处理和客户端版本获取功能： `ConvaiUtils`.
* 新增空闲计时器重置和用户空闲警告支持。
* 增强了 FaceSync 动画节点中的组件解析功能，搜索 `UConvaiChatbotComponent`.
* 将参数 `RunLLM` 重命名为 `ShouldRespond` 以提高上下文更新方法的 API 清晰度。
* 更新了口型同步计时行为，以更好地协调音频和动画。当前源码中 `LipSyncTimeOffset` 的默认值为 `0.02` 秒（20 毫秒）。
* 更新了动态上下文防抖行为，以提升批处理一致性。当前源码中的设置为 `ContextDebounceWindow`，默认值为 `0.5` 秒。
* 重构了叙事触发器处理，以简化上下文处理流程。
  {% endupdate %}

{% update date="2026-04-13" tags="4.0.0-beta.17" %}

## 4.0.0-beta.17

* 优化了 MetaHuman 面部动画蓝图中的口型同步计算性能。
* 改进了音频播放时间估算，并移除了已弃用的 `FSoundSource` 缓存。
* 增强了音频播放结束检测，并加入容差处理，以避免浮点舍入导致的边界情况。
* 在调试模式下，为音频流处理器和面部同步组件添加了性能计时统计信息。
* 添加了详细的音频播放调试日志。
* 改进了音频捕获清理流程，确保在组件销毁和结束播放期间安全释放资源。
* 将异步任务中的指针改为弱指针，修复了可能出现的悬空引用问题。
* 修复了 Convai 客户端断开连接期间发生的重入回调问题。
* 修复了在 `BeginDestroy` 中因跨对象委托清理导致的聊天机器人和玩家组件崩溃问题。
* 修复了玩家转录文本未正确追加的问题。
* 添加了情绪提供程序的接线支持。
* 修复了 `ConvaiConnectionConfig` 结构体布局与 DLL 不匹配的问题。
  {% endupdate %}

{% update date="2026-04-09" tags="4.0.0-beta.16" %}

## 4.0.0-beta.16

* 添加了 Android 支持。
  {% endupdate %}

{% update date="2026-04-05" tags="4.0.0-beta.15" %}

## 4.0.0-beta.15

* 修复了口型同步接收速度缓慢的问题。
  {% endupdate %}

{% update date="2026-03-31" tags="4.0.0-beta.14" %}

## 4.0.0-beta.14

* 添加了更新上下文功能。
* 将 `OutputFPS` 更新为 60，以改善口型同步输出效果。
* 改进了口型同步的音频处理，并清理了未使用的变量。
* 提高了音频播放时间计算的准确性，并简化了语音数据播放流程。
  {% endupdate %}

{% update date="2026-03-16" tags="4.0.0-beta.13" %}

## 4.0.0-beta.13

* 添加了连接状态指示器 UI 控件。
* 修复了与会者断开连接时的状态通知处理问题。
* 修复了编辑器 UI 仅显示已安装插件版本的更新日志的问题。
* 提高了连接管理器的可靠性，并改进了状态处理。
* 修复了连接处于孤立状态时音频未发送的问题。
* 改进了服务器事件分发。
* 增强了日志记录，便于调试。
  {% endupdate %}

{% update date="2026-03-09" tags="4.0.0-beta.12" %}

## 4.0.0-beta.12

* 弃用了旧版 `ConvaiBaseCharacter` 和 `ConvaiBasePlayer` 蓝图类。
* 添加了连接状态指示器控件，用于显示连接状态。
* 添加了 LLM 启动/停止事件（`OnLLMStarted`, `OnLLMStopped`) 到 `ConvaiChatbotComponent`.
* 新增情绪支持。
* 新增 STT 切换功能。
* 改进了响应结束时的唇形同步。
* 修复了因使用上一条响应的帧而导致的唇形同步错位边缘情况。
* 修复了同时录制音频和启动新连接时发生的 PIE 崩溃。
* 修复了最小缓冲时长被更新为 0.2 秒的问题。
  {% endupdate %}

{% update date="2026-02-19" tags="4.0.0-beta.11" %}

## 4.0.0-beta.11

* 改进了与 CC5 Reallusion 角色的兼容性。
  {% endupdate %}

{% update date="2026-02-11" tags="4.0.0-beta.10" %}

## 4.0.0-beta.10

* 修复了 DLL 加载问题。
* 修复了 Convai 控制面板中的崩溃。
* 新增对纯蓝图项目的支持。
  {% endupdate %}

{% update date="2026-02-10" tags="4.0.0-beta.9" %}

## 4.0.0-beta.9

* 改进了角色中断处理。
* 提高了唇形同步的准确性。
* 为 `ConvaiSubsystem` 和 `ConvaiChatbotComponent`.
  {% endupdate %}

{% update date="2026-01-15" tags="4.0.0-beta.7" %}

## 4.0.0-beta.7

* 修复了部分转录字符乱码的问题。
  {% endupdate %}

{% update date="2026-01-05" tags="4.0.0-beta.6" %}

## 4.0.0-beta.6

* 新增 ARKit 混合变形唇形同步支持。
* 将默认 `LipSyncMode` 更新为 `BS_MHA` （MetaHuman），位于 `ConvaiFaceSyncComponent`.
* 新增 `RequiresPrecomputedFaceData` 方法到 `ConvaiConnectionInterface`.
* 修复了混合变形选择逻辑，使其根据条件使用 ARKit 名称。
  {% endupdate %}

{% update date="2025-12-20" tags="4.0.0-beta.5" %}

## 4.0.0-beta.5

* 将 `BlendShapesNames` 更新为 ARKit 的新命名约定。
  {% endupdate %}

{% update date="2025-12-05" tags="4.0.0-beta.4" %}

## 4.0.0-beta.4

* 实现了批量 NeuroSync 混合变形处理，并添加统计日志记录。
* 为 `ConvaiAudioStreamer` 和 `ConvaiChatbotComponent`.
* 新增最终用户 ID 功能和设备唯一 ID 支持。
* 修复了语音播放重叠问题：音频开始时停止语音播放。
* 新增 MetaHuman 控制名称支持。
* 修复了编辑器卡死的问题。
* 修复了 Linux 库链接问题。
* 改进了视觉功能的优化。
  {% endupdate %}

{% update date="2025-11-20" tags="4.0.0-beta.3" %}

## 4.0.0-beta.3

* 新增对 UE 5.7 的支持。
* 新增对纯蓝图项目的支持。
  {% endupdate %}

{% update date="2025-11-05" tags="4.0.0-beta.2" %}

## 4.0.0-beta.2

* 新增编辑器登录界面和仪表板。
* 改进了回声消除和降噪效果。
* 新增基于 viseme、使用 FaceSync 组件的初步口型同步支持。
* 为视觉功能新增了伽马校正。
* 修复了 F10 设置菜单。
  {% endupdate %}

{% update date="2025-10-20" tags="4.0.0-beta.1" %}

## 4.0.0-beta.1

* 初步集成 WebRTC。
  {% endupdate %}
  {% endupdates %}

***

### 3.x 版本发布

<details>

<summary>3.6.x 版本发布历史</summary>

**3.6.7-Beta**

* 新增 `UseSystemCertificates` 选项，用于在 Windows 上配置 SSL。
* 修复了打包后不显示 Convai 日志的问题。
* 修复了因在非游戏线程上发送文本数据而导致的多人游戏崩溃问题。

**3.6.6**

* 新增 `EnableSync` 参数，用于控制音频和口型同步。

**3.6.5**

* 调整了 `MinBufferDuration` 和 `AudioLipSyncRatio` 的默认值，以减少音频卡顿。

**3.6.4**

* 改进了 `ConvaiAudioStreamer` 中的数据验证，以防止无效输入导致崩溃。
* 修复了 `MinBufferDuration` 在口型同步启用时未按预期工作的问题。

**3.6.3**

* 改进了 `ConvaiGRPC`.

**3.6.2**

* 尝试修复 ElevenLabs 和部分 Azure 语音缺少音频的问题。
* 改进了接收 AI 音频响应时的性能。

**3.6.1**

* 修复了 Linux 构建的头文件。

**3.6.0**

* 支持 UE 5.6。
* 优化了内部组件注册表查找。
* 新增 Convai Logger。

</details>

<details>

<summary>3.5.x 版本发布历史</summary>

**3.5.4-hotfix-1**

* 修复了播放音频时的竞态条件。
* 将 Android Play Core 更新至 2.0.3。
* 重构了旧的未使用类和代码。

**3.5.4**

* 进一步提高了口型同步的准确性和同步效果。
* 修复了玩家短暂回应后语音转录失败的问题。
* 提升了 gRPC 连接稳定性，避免对话失败。
* 修复了服务器以小块发送大量音频时偶尔发生的崩溃。

**3.5.3-beta**

* 提升了唇形同步的准确性和同步效果。
* 修复了 ElevenLabs 语音被截断的问题。
* 修复了与 Pixel Streaming 的兼容性问题。

**3.5.2**

* 修复了角色即将说完当前句子时开始播放新的语音数据而偶尔导致崩溃的问题。

**3.5.1**

* 新增长期记忆 V0。
* 修复了多人游戏中语音未发送给客户端的问题。
* 新增动态环境信息。

**3.5.0**

* 支持 UE 5.5。

</details>

<details>

<summary>3.4.x 及更早版本</summary>

**3.4.2-beta**

* 修复了使用文本时玩家超时警告消息的问题。
* 通过添加短暂延迟和读取重试，提升了 gRPC 连接的稳定性。

**3.4.1-beta**

* 修复了 `IsListening()` 未能正确返回角色状态的问题。

**3.4.0-beta**

* 修复了多个连接问题。
* 现在可以在 MetaHuman 面部动画上播放自定义蒙太奇。

**3.3.2**

* 新增临时修复方案，解决多人游戏中音频被截断的问题。
* 新增 `ConvaiGetAvailableVoices` 函数。

**3.3.1**

* 修复了叙事键未正确设置的问题。
* 使用时间戳提升了唇形同步效果。
* 新增 `Convai Download Image using RPM link` 函数。
* 开放 Convai Player 组件，供 C++ 使用。

**3.3.0**

* 新增 Linux 支持。
* 修复了与角色名称相似的对象被识别为相关对象或角色的问题。

**3.2.2-Beta**

* 修复了过早打断角色时 NPC2NPC 崩溃的问题。

**3.2.1-Beta**

* 修复了说话时身体手势不播放动画的问题。
* 新增叙事触发键。
* 改进了 MetaHuman 的情绪动画。

**3.2.0**

* 新增 UE 5.4 支持。

**3.1.4**

* 新增 Pixel Streaming 支持和文档。
* 新增 x86\_64 Android 支持。
* 新增叙事设计辅助函数。
* 新增更多蓝图文档。
* 提升了对物体和角色的动作准确性。
* 改进了 MetaHuman 面部和身体动画逻辑。
* 改进了唇形同步。
* 更新了 Reallusion 动画蓝图。
* 修复了添加自定义 MetaHuman 动画时的问题。
* 修复了 UE 5.3 在连接出现问题时发生的崩溃。
* 修复了多人游戏崩溃问题。
* 修复了网络连接不佳时使用 Invoke Speech 偶尔发生的崩溃。

**3.0.1 热修复**

* 修复了 Android 上音频采集偶尔无法正常进行的问题。
* 修复了 Android 上的口型同步崩溃问题，并提升了性能。
* 修复了 Android 上角色说出大量音频内容时偶尔发生的崩溃。
* 改进了整体音频采集效果。
* 修复了 `Update Character` 节点无法更新语言的问题。
* 更新了 Convai ReadyPlayerMe 插件，改进了头部追踪。
* 修复了玩家组件和聊天机器人组件位于同一角色蓝图中时口型同步失效的问题。
* 新增了 Mac 麦克风权限问题的文档指南。
* 修复了 macOS UE 5.3 打包应用因麦克风权限问题导致的启动崩溃。

**3.0.0**

新增：

* 全新的口型同步组件 `FaceSync`，现在不再需要 `ConvaiOVRLipsync` 插件。
* 支持 Mac 口型同步。
* 情绪。
* 注意力对象。
* Convai Chatbot Component 新增函数： `Invoke Speech`, `Invoke Narrative Design Trigger`, `Force Set Emotion`, `Reset Emotion State`, `Get Emotion Score`, `Get Talking Time Elapsed`, `Get Talking Time Remaining`, `Set Lipsync Component`, `Clear Action Queue`.
* Convai Chatbot Component 新增事件： `On Narrative Section Received`, `On Emotion State Changed`.
* `ConvaiGetLookedAtObjectOrCharacter` 函数。
* 经过预设时间后，Actor 会失去对玩家的关注。
* `Move To` 和 `Follow` 操作失败时会触发角色回应。
* 支持多人游戏场景的环境复制。

改进了：

* MetaHuman 身体动画、面部表情和眼神注视。
* Reallusion 动画蓝图、口型同步和眼神注视。
* 设置组件 UI。
* 操作准确性。
* 低帧率下的音频采集。

已修复：

* 打包前场景中存在 Convai Player Component 时出现的打包问题。
* 多个交互同时进行时发生的崩溃。
* `ConvaiBasePlayerWithVoiceActivation` Beta 类仅在首次交互时有效。
* 整体插件稳定性和警告。

已弃用：

* `ConvaiOVRLipsync` 插件和组件。请从项目中删除该插件，并改用新的 `FaceSync` 组件。

</details>

### 后续步骤

{% content-ref url="/pages/fb3a2bacc1ba8d2d274717ebd7a3ac02e56aabb8" %}
[快速开始](https://docs.convai.com/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
