> 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` 不再暴露 `生成操作` 和 `在网络上复制` 引脚。现在两者都遵循聊天机器人的自身配置。移除了这些引脚的现有 Blueprints 在编译前需要刷新节点。
* `Invoke Speech` 新增了一个 `传递` 选项，因此一行内容可以等待一个安静的时机，而不是打断当前流程，而且其消息现在只会被听到一次，而不是在对话上下文中不断累积。

**操作**

* 随附的 `BP Convai Chatbot Component` 自带 `护送` 操作即可使用，因此角色无需重建 Blueprint 处理器，就可以引导玩家或另一角色前往目的地。未使用的 `等待操作` 条目已禁用。
* 改进了关卡关闭和垃圾回收期间的移动任务取消，因此取消中的任务不再会去访问 Unreal 已经在销毁的导航组件。

**空间感知**

* 角色可以从玩家视角提供方向说明。现在每个被描述的对象还会说明它相对于玩家摄像机的位置，因此“它在哪里？”会得到与玩家所见相符的答案。由 `从玩家视角描述` 在 **项目设置 > 插件 > Convai**控制，在 **空间感知** 类别中，并默认开启。

**音频和动画**

* 修复了在对话处于活动状态时麦克风测试变成无操作的问题。现在在打开的流中录音可以正常工作，角色不会听到测试录音，并且之后会恢复项目的静音设置。
* 身体和面部网格检测现在只会考虑带有运行中动画 Blueprint 的网格，因此头发、布料和静态道具不再会被误认为角色的身体或面部。

**其他**

* 新增了可供 Blueprint 访问的知识库操作，并修复了使用自定义 Convai 服务器 URL 的 REST 请求。
* 调试覆盖层始终会显示完整信息：角色接收到的精确环境句子，以及 `事实` 和 `事件` 各部分，现在在所有构建中都可见。
  {% endupdate %}

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

## 4.0.0-beta.26

**移动**

* 新增了可复用的 `Convai 移动到` 和 `Convai 护送` 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 上插件无法加载的问题，打开项目时会报告 `插件“ConvAI”加载失败，因为无法加载模块“ConvaiToolset”`。现在项目可正常打开。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 面板以及更简洁的变更措辞，改进了已跟踪属性。

**操作**

* 新增了实验性的 `提醒自己` 和 `监视属性` 操作，可帮助角色继续多步骤任务，并响应下一次有意义的属性变更。

**工具**

* 新增了 Convai 调试覆盖层，可在开发期间检查周围环境、上下文状态、可达性、已跟踪属性和操作结果。

**迁移说明**

* 目标字段和 `解析目标位置` 引脚在此版本中已重命名。升级后请刷新受影响的 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 角色，而无需手工编辑 Blueprints： `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 麦克风采集问题。
* 通过线程安全地访问 blendshape 数据，提升了面部动画稳定性。
  {% endupdate %}

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

## 4.0.0-beta.22

**空间感知**

* 新增了一个空间感知子系统，为每个聊天机器人提供对周围环境的持续感知，并以自然语言事实的形式传递给角色。它会通过可视距离、方向和朝向描述附近对象、其他角色以及玩家，并受视线范围限制。
* 新增了实体间关系，例如“在压力板上方”或“在喷泉左侧”，并以最近的更高优先级邻居为锚点。
* 在 **项目设置 > 插件 > Convai**控制，在 **空间感知** 类别下新增了总开关以及视线、距离带和关系控制，并为每个聊天机器人提供周围环境和关系切换。
* **废弃了按对象近距离机制。** 空间感知取代了它。

**场景对象**

* 新增了将同名 Convai Object 组件合并为单个逻辑对象的能力，因此一堆箱子在角色看来会作为一个整体。可通过 `将同名对象合并`为每个组件单独启用，并使用 `合并组索引`将不同集合分开。合并后的对象只暴露一个位置、一段描述和一个统一的视线高亮。
* 新增了全局 `重复名称后缀样式` 设置， `数值` 或 `按字母顺序`，用于区分未合并的同名对象。

**动态上下文**

* 新增了短暂上下文事件： `添加上下文事件` 新增了一个 `bEphemeral` 选项，它会在下一次更新中仅提示角色一次，而不会持久保存。
* `SetObjectInAttention` 现在默认会发出一次性刷新的注意提示，因此注视某个对象会只提示角色一次，不会留下持续状态。无论聊天机器人上是否禁用了操作、对象是否缺失于环境列表，或者对象是否缺失于连接时的操作配置，此调用现在都会记录一条警告来说明它为何没有生效。

**其他**

* 新增了 `FConvaiAvatarInfo`：get-characters 请求现在返回完整的角色详情，而不只是角色 ID。
* 修复了指向动画，使其能够从角色发出的指向操作中正确播放和对准目标。
* 修复了踏上到达逻辑，因此站在宽对象占地上的角色会被视为已经到达，而不再对宽于其接受半径的对象永远无法注册到达。
* 修复了运行时忽略空间感知和重复名称设置的问题；现在在 Project Settings 中切换它们无需重启编辑器即可生效。
* 修复了在聊天机器人断开连接时一次性刷新短暂上下文事件会丢失的问题；刷新会延迟到重新连接后。
* 修复了音频重采样器除零错误，该问题可能在报告无效采样率时发生。
* 修复了 Convai 编辑器更新检查，使其能够正确检测 V4 版本，并修复了编辑器主题初始化。
  {% endupdate %}

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

## 4.0.0-beta.21

**动画和手势**

* 彻底改造了随附的 MetaHuman 动画。
* 新增了由 LLM 发出的角色操作自动触发的手势和指向动画。
* 新增了复制的 `指向目标` 以及 `查看目标` 在聊天机器人组件上。

**对象感知和视线**

* 新增了 `UConvaiObjectComponent` ，用于标记 Actor 并将其实时属性作为上下文暴露给聊天机器人。
* 新增了基于视线的注意力：玩家视线下的 Actor 会成为被注意对象，并带有轮廓高亮和屏幕光标。
* 新增了基于接近的状态：对象组件会报告它们何时能被聊天机器人的 Pawn 到达，从而让机器人做出反应。

**操作**

* 在 Blueprint 图中新增了“创建 Convai Action Handler”右键条目，用于搭建类型化的操作处理器。
* 新增了“Setup Convai Pawn Movement”资源浏览器操作，可在任意 Pawn Blueprint 上填充导航默认值。
* 为操作新增了组件和 Socket 目标定位以及按条目的移动覆盖。
* 改进了操作完成机制：处理器可以在下一次操作前等待机器人说话结束，在同一次调用中发布动态上下文事件，并干净地中止无法恢复的序列。
* 为枚举和选项操作参数新增了模糊匹配，因此轻微的 LLM 拼写漂移不再会丢弃该操作。
* 将操作线格式切换为 `{name}` 大括号，并改进了响应解析的可靠性。
* 现在聊天机器人环境中默认启用操作。

**音频和唇形同步**

* 在项目设置和连接请求中新增了 VAD（语音活动检测）参数。
* 改进了语句末尾音频处理，以减少轻柔尾辅音的截断。
* 通过在帧短暂停止到达时提供饥饿回退，提升了唇形同步稳定性。
* 修复了麦克风热插拔，因此会话中切换设备不再需要重启流。

**其他改进**

* 新增了 Convai 认证缓存，因此后续连接无需从头重新认证。
* 新增了 `GetBodyAndFaceSkeletalMeshComponents` 用于解析 MetaHuman 和 CC5 骨架的辅助程序。

**Bug 修复和兼容性**

* 修复了应用关闭时的 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` 开启时，并解析结构化操作响应载荷为类型化操作序列。
* 重构了 `环境` 来自 `UConvaiEnvironment` UObject 为 `FConvaiEnvironmentData` USTRUCT。为对象、角色和操作提供了更细粒度的添加/移除/清除方法；对场景元数据刷新进行去抖； `bFlushImmediately` 用于时间关键更新的高级可选功能。
* 拆分了旧版 `MainCharacter` 为 `ConversationPartner` （复制的、具有场景感知）和 `查看目标` （仅动画）。新的 `bAutoFillConversationPartnerFromPlayer` 切换会自动使用第一个已注册的 Convai Player 组件填充伙伴。
* 新 `SetObjectInAttention` 走动态上下文刷新流程，并在缺失时自动将条目注册到 `Environment.Objects` 中。
* 新增了 `bEnableActions` 聊天机器人切换。 `Environment.Actions` 默认以 `移动到`, `跟随`, `停止移动`，以及 `等待`.
* Actions V2 — 类型化操作模板： `FConvaiAction` 带结构化 `参数` 通过类型化 `EConvaiActionParamType`。可选 `连接词` 用于复合操作， `选择` 用于固定列表约束，或 `EnumType` 从一个 `UENUM`.
* 统一的操作结果形状： `FConvaiResultAction.Parameters` 作为 `TMap<FString, FConvaiResultParam>`。旧版 `RelatedObjectOrCharacter` 和 `ConvaiExtraParams` 保留为已弃用的镜像。
* 新增了 Blueprint 纯访问器： `Get First Param`, `Get Param`, `获取参数类型`, `以字符串/数字/布尔/引用/字节获取参数`, `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 Animation Node 中的组件解析，在搜索 `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 Face Animation Blueprint 中的唇形同步计算性能。
* 改进了音频播放时间估算，并移除了已弃用的 `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` Blueprint 类。
* 新增了连接指示器小部件，用于显示连接状态。
* 新增了 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 Dashboard 中的崩溃。
* 新增了对仅 Blueprint 项目的支持。
  {% 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 blendshape 唇形同步支持。
* 更新了默认 `LipSyncMode` 到 `BS_MHA` （MetaHuman）在 `ConvaiFaceSyncComponent`.
* 新增了 `RequiresPrecomputedFaceData` 方法为 `ConvaiConnectionInterface`.
* 修复了 blendshape 选择逻辑，使其按条件使用 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 blendshape 处理并添加了统计日志。
* 新增了音频帧跟踪，并改进了 `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

* 添加了编辑器登录界面和仪表板。
* 添加了更好的回声和降噪。
* 使用 FaceSync 组件添加了基于 viseme 的初始唇形同步支持。
* 为视觉添加了伽马校正。
* 修复了 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 日志记录器。

</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 通过 RPM 链接下载图片` 函数。
* 将 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 支持。
* 添加了叙事设计辅助函数。
* 添加了更多 Blueprint 文档。
* 提高了对象和角色的动作准确性。
* 改进了 MetaHuman 面部和身体动画逻辑。
* 改进了唇形同步。
* 更新了 Reallusion Animation Blueprint。
* 修复了添加自定义 MetaHuman 动画时的问题。
* 修复了 UE 5.3 在出现连接问题时的崩溃。
* 修复了多人游戏崩溃。
* 修复了在连接不良时使用 Invoke Speech 触发的罕见崩溃。

**3.0.1 热修复**

* 修复了 Android 上音频捕获有时无法正常捕获的问题。
* 修复了 Android 上的唇形同步崩溃并提升了性能。
* 修复了 Android 上在角色说出大量音频时的罕见崩溃。
* 改进了整体音频捕获。
* 修复了 `更新角色` 节点未更新语言。
* 更新了 Convai ReadyPlayerMe 插件以改进头部跟踪。
* 修复了当玩家组件和聊天机器人组件位于同一个角色 Blueprint 中时唇形同步不起作用的问题。
* 为 Mac 麦克风权限问题添加了文档指南。
* 修复了由于麦克风权限导致 macOS UE 5.3 上已打包应用的启动崩溃。

**3.0.0**

新增：

* 新的唇形同步组件 `FaceSync`，它不再需要 `ConvaiOVRLipsync` 插件。
* Mac 唇形同步支持。
* 情绪。
* 关注对象。
* 新的 Convai Chatbot 组件函数： `Invoke Speech`, `Invoke Narrative Design Trigger`, `Force Set Emotion`, `Reset Emotion State`, `获取情绪分数`, `获取已说话时长`, `获取剩余说话时长`, `设置唇形同步组件`, `清空动作队列`.
* 新的 Convai Chatbot 组件事件： `叙事章节已接收`, `情绪状态已更改`.
* `ConvaiGetLookedAtObjectOrCharacter` 函数。
* Actor 在预设时间后失去对玩家的关注。
* `移动到` 和 `跟随` 动作失败会触发角色回复。
* 用于多人游戏场景的环境复制。

改进：

* MetaHuman 身体动画、面部表情和眼神注视。
* Reallusion Animation Blueprint、唇形同步和眼神注视。
* 设置窗口小部件 UI。
* 动作准确性。
* 低帧率下的音频捕获。

修复：

* 如果在打包前场景中存在 Convai Player 组件，则会出现打包问题。
* 当同时发生大量交互时的崩溃。
* `ConvaiBasePlayerWithVoiceActivation` Beta 类仅在第一次交互时有效。
* 整体插件稳定性和警告。

已弃用：

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

</details>

### 下一步

{% 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 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.