> 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 插件跨版本的更改。当前版本是 space.vars.unreal\_plugin\_version，支持 Unreal Engine space.vars.unreal\_min\_version 到 space.vars.unreal\_max\_version.
{% hint style="info" %}
此插件处于测试版。测试版发布在小版本之间可能包含破坏性更改。插件清单将当前包标识为 space.vars.unreal\_plugin\_version.
{% endhint %}
{% updates format="full" %}
{% update date="2026-08-11" tags="4.0.0-beta.27" %}
## 4.0.0-beta.27
**蓝图破坏性更改**
* `调用语音` 和 `调用叙事设计触发器` 不再公开 `生成操作` 和 `网络复制` 引脚。现在两者都遵循聊天机器人的自身配置。使用已移除引脚的现有蓝图需要先刷新节点，才能编译。
* `调用语音` 新增了 `传递方式` 选项，因此一条线可以等待安静时机而不是打断，并且其消息现在只会被听到一次，而不会在对话上下文中不断累积。
**动作**
* 捆绑的 `BP Convai Chatbot Component` 自带 `Escort` 操作，可直接使用，因此角色可以将玩家或其他角色带到目的地，而无需重建蓝图处理器。未使用的 `等待动作` 条目已禁用。
* 改进了关卡关闭和垃圾回收期间的移动任务取消，因此正在取消的任务不再会去访问 Unreal 已经在销毁的导航组件。
**空间感知**
* 角色可以从玩家视角给出方向。现在每个被描述的对象还会说明其相对于玩家摄像机的位置，因此“它在哪里？”得到的回答会与玩家所见一致。由 `从玩家视角描述` 在以下位置 **项目设置 > 插件 > Convai**，在 **空间感知** 类别控制，并且默认开启。
**音频和动画**
* 修复了在对话进行时麦克风测试无操作的问题。录音现在可在打开的流中正常工作，角色不会听到测试录音，项目的静音设置也会在之后恢复。
* 现在，身体和面部网格检测只会考虑带有运行中动画蓝图的网格，因此头发、布料和静态道具不再会被误认为角色的身体或面部。
**其他**
* 新增了可供蓝图访问的知识库操作，并修复了使用自定义 Convai 服务器 URL 的 REST 请求。
* 调试覆盖层始终显示完整信息：角色接收到的精确环境句子，以及 `事实` 和 `事件` 部分，现在在所有构建中都可见。
{% endupdate %}
{% update date="2026-08-05" tags="4.0.0-beta.26" %}
## 4.0.0-beta.26
**移动**
* 新增了可复用的 `Convai 移动到` 和 `Convai 陪护` 蓝图节点。护送角色可以带领某人前往目的地，在对方落后时等待，在对方追上时继续，并处理已经就在附近的目的地。
* 改进了目标解析和合并对象导航，因此移动任务会选择可达目的地，并区分“到达”和“已经在那儿”。
**动作**
* 新增了协作式动作计划取消。角色可以在动作运行时改变路线，自定义蓝图动作也可以在其替代动作开始前进行清理。
* 改进了参数化动作：命名值、空格、标点、本地化选项和对象式响应的处理更可靠，而且大型动作列表和多字节文本不再会被固定大小缓冲区截断。
**其他**
* 通过正确报告受支持的协议和客户端版本、识别当前生命周期消息以及转发交互 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
**移动和场景感知**
* 为场景对象新增了移动感知，涵盖方向、停止检测、五个灵敏度级别、可选移动状态，以及可配置的开始和停止响应。
* 新增了 Movement Points 和命名目的地，因此角色可以选择可达的接近点，识别自己是否已经到达，并在路径打开或关闭时作出反应。
* 减少了重复对象和空间事实中的提示重复，并改进了蓝图移动的动作目标解析。
**动态上下文**
* 新增了实时上下文更新的投递控制。响应式事件可以等待自然停顿，在时机重要时立即发送，或者静默更新角色。
* 通过嵌套对象路径、别名、蓝图重命名恢复、更清晰的 Details 面板以及更简洁的变更说明，改进了跟踪属性。
**动作**
* 新增了实验性的 `提醒自己` 和 `监视属性` 动作，可帮助角色继续多步骤任务并响应下一个有意义的属性变化。
**工具**
* 新增了 Convai 调试覆盖层，用于在开发期间检查环境、上下文状态、可达性、跟踪属性和动作结果。
**迁移说明**
* 目标字段和 `解析目标位置` 引脚在此版本中已重命名。升级后请刷新受影响的蓝图节点。
{% endupdate %}
{% update date="2026-06-25" tags="4.0.0-beta.24" %}
## 4.0.0-beta.24
**AI 编码代理**
* 在 Unreal Engine 5.8 上新增了 MCP（模型上下文协议）支持，使 AI 编码代理可以直接在编辑器中工作。
* 新增了用于连接代理的设置流程：Claude Code、Cursor、VS Code、Gemini 或 Codex。
* 新增了 Convai Toolset，一组可由 AI 调用的编辑器操作，使代理可以设置和扩展 Convai 角色，而不必手动编辑蓝图： `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`：获取角色请求现在返回完整角色详情，而不只是角色 ID。
* 修复了指向动画，使其能够正确播放并根据角色发出的指向动作瞄准。
* 修复了踏上到达逻辑，因此站在宽对象占位范围内的角色会被视为已到达，而不会在宽于其接受半径的对象上永远不触发到达。
* 修复了空间感知和同名设置在运行时被忽略的问题；在 Project Settings 中切换它们现在无需重启编辑器即可生效。
* 修复了在聊天机器人断开连接时一次性临时上下文事件丢失的问题；该刷新会延迟到重新连接后执行。
* 修复了音频重采样器除零错误，该错误可能在报告无效采样率时发生。
* 修复了 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 可达时会进行报告，以便机器人作出反应。
**动作**
* 在蓝图图表中新增了右键条目“Create Convai Action Handler”，用于搭建类型化动作处理器。
* 新增了内容浏览器操作“Setup Convai Pawn Movement”，可在任何 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` 开启时，并将结构化动作响应负载解析为类型化动作序列。
* 重构了 `环境` 来自 `UConvaiEnvironment` UObject 为 `FConvaiEnvironmentData` USTRUCT。聊天机器人针对对象、角色和动作提供了更细粒度的 Add/Remove/Clear 方法；去抖动的场景元数据刷新； `bFlushImmediately` 用于对时间敏感更新的高级选择加入。
* 将旧版 `MainCharacter` 拆分为 `ConversationPartner` （已复制、感知场景）和 `LookAtTarget` （仅动画）。新的 `bAutoFillConversationPartnerFromPlayer` 切换会自动用第一个已注册的 Convai Player 组件填充伙伴。
* 新版 `SetObjectInAttention` 沿用动态上下文刷新，并在 `Environment.Objects` 中缺失时自动注册该条目。
* 新增了 `bEnableActions` 聊天机器人切换。 `Environment.Actions` 默认由 `移动到`, `跟随`, `停止移动`，以及 `等待`.
* Actions V2 — 类型化动作模板： `FConvaiAction` 带有结构化 `Parameters` 通过 `EConvaiActionParamType`进行类型化。可选 `连接词` 用于复合动作， `Choices` 用于固定列表约束，或 `EnumType` 从一个 `UENUM`.
* 中抽取选择项。统一的动作结果形状： `FConvaiResultAction.Parameters` 中的 `TMap`。旧版 `RelatedObjectOrCharacter` 和 `ConvaiExtraParams` 保留为已弃用的镜像。
* 新的 Blueprint-pure 访问器： `Get First Param`, `获取参数`, `获取参数类型`, `Get Param As String/Number/Bool/Ref/Byte`, `是否有参数`.
* `HandleActionCompletion` 新增了可选的 `附加说明` 和 `ShouldRespond`。新的 `AbortActionSequence` 接受可选的 `EventText` 并清空队列而不重试。
* 移除了 `EnableNewActionSystem` 全局切换——动作队列路径现在始终开启。
* 向后兼容性：旧版 `UConvaiEnvironment` 和 `UConvaiActionContext` 被恢复为已弃用的兼容层，因此旧蓝图图表仍可编译，但会带有弃用警告。
{% endupdate %}
{% update date="2026-04-24" tags="4.0.0-beta.18" %}
## 4.0.0-beta.18
* 新增了 Android 打包支持。
* 新增了聊天机器人交互的动态上下文批处理和日志记录，以减少冗余更新。
* 新增了饥饿混合和可播放帧检查，以提升口型同步稳定性。
* 新增了用于口型同步动画参数和模拟冻结功能的命令行覆盖项。
* 为 `ConvaiUtils`.
* 新增了自定义参数处理和客户端版本获取。
* 增强了 FaceSync Animation Node 中的组件解析，在搜索 `UConvaiChatbotComponent`.
* 时会包含父 Actor。 `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` 蓝图类。
* 新增了连接指示器小部件，用于显示连接状态。
* 新增了 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 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 版本发布
3.6.x 发布历史
**3.6.7-Beta**
* 新增了 `UseSystemCertificates` Windows 上 SSL 配置的选项。
* 修复了打包后不显示 Convai 日志的问题。
* 修复了因在非游戏线程上传输文本数据而导致的多人游戏崩溃。
**3.6.6**
* 新增了 `EnableSync` 用于音频和口型同步控制的参数。
**3.6.5**
* 已调整 `最小缓冲时长` 和 `音频口型同步比率` 默认为减少音频卡顿。
**3.6.4**
* 在 `ConvaiAudioStreamer` 以防止无效输入导致崩溃。
* 修复了 `最小缓冲时长` 在口型同步启用时未按预期工作。
**3.6.3**
* 在 `ConvaiGRPC`.
**3.6.2**
* 针对 ElevenLabs 和部分 Azure 语音缺少音频的潜在修复。
* 接收 AI 音频回复时性能提升。
**3.6.1**
* 修复了 Linux 构建的头文件。
**3.6.0**
* 支持 UE 5.6。
* 优化了内部组件注册表查找。
* 新增 Convai Logger。
3.5.x 发布历史
**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。
3.4.x 及更早版本
**3.4.2-beta**
* 修复使用文本时玩家超时警告消息的问题。
* 通过增加小延迟和重试读取，提高了 gRPC 连接的健壮性。
**3.4.1-beta**
* 修复了 `IsListening()` 未正确返回角色状态。
**3.4.0-beta**
* 修复了多个连接问题。
* 现在可以在 MetaHuman 面部动画上播放自定义蒙太奇。
**3.3.2**
* 添加了针对多人模式音频被截断的临时修复。
* 新增了 `ConvaiGetAvailableVoices` 函数。
**3.3.1**
* 修复了叙事键未正确设置的问题。
* 使用时间戳实现更好的口型同步。
* 新增了 `使用 RPM 链接下载 Convai 图片` 函数。
* 为 C++ 使用开放了 Convai Player 组件。
**3.3.0**
* 新增 Linux 支持。
* 修复了与角色名称相似的对象会被识别为相关对象或角色的问题。
**3.2.2-Beta**
* 修复了在较早打断角色时 NPC2NPC 崩溃的问题。
**3.2.1-Beta**
* 修复了说话时身体手势不播放动画的问题。
* 新增叙事触发键。
* 改进了 MetaHumans 的情绪动画。
**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 Component 函数： `调用语音`, `调用叙事设计触发器`, `强制设置情绪`, `重置情绪状态`, `获取情绪分数`, `获取已说话时长`, `获取剩余说话时间`, `设置口型同步组件`, `清空动作队列`.
* 新的 Convai Chatbot Component 事件： `收到叙事段落`, `情绪状态已更改`.
* `ConvaiGetLookedAtObjectOrCharacter` 函数。
* Actor 在预设时间后失去对玩家的关注。
* `移动到` 和 `跟随` 动作失败会触发角色回复。
* 面向多人使用场景的环境复制。
改进：
* MetaHuman 身体动画、面部表情和眼神看向。
* Reallusion Animation Blueprint、口型同步和眼神看向。
* 设置小部件 UI。
* 动作准确性。
* 低帧率下的音频采集。
修复：
* 如果打包前场景中已有 Convai Player Component，则修复打包问题。
* 多个交互同时发生时的崩溃。
* `ConvaiBasePlayerWithVoiceActivation` Beta 类仅在第一次交互时有效。
* 整体插件稳定性和警告。
弃用：
* `ConvaiOVRLipsync` 插件和组件。请从项目中删除该插件并使用新的 `FaceSync` 组件替代。
### 下一步
{% 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, and the optional `goal` query parameter:
```
GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/overview/release-notes.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.