> 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/unity-plugin/changelogs.md).

# 更新日志

## 版本 **3.2.4** （当前）

发布：2025年3月5日

### **公告：**

* 我们正在从 Convai Playground 中基于 Ready Player Me（RPM）的角色创建器过渡到一个质量显著更高的角色创建系统。因此，之前允许从 Playground 导入 RPM 创建角色的 Character Importer 将不再受支持。

***

## 版本 **3.2.3**

发布：2025年1月30日

### **错误修复：**

* 修复了 Ready Player Me 包的版本以确保兼容性

***

## 版本 **3.2.2**

发布：2025年1月23日

### **错误修复：**

* 修复了 Character Importer 问题。

***

## 版本 **3.2.1**

发布：2025年1月20日

### **新功能：**

* 核心 API 访问实现

### **错误修复：**

* 修复了暂停和恢复功能
* 修复了 Character Importer 中 Ready Player Me 包自动更新问题

***

## 版本 3.2.0

发布：2024年10月31日

### **新功能**

* **实现动态配置功能**:
  * 此功能允许您动态向 NPC 传递变量。例如，您可以向 NPC 更新玩家当前生命值、物品栏物品或世界信息，从而增强交互性和沉浸感。
* **实现叙事设计键：**
  * 此功能可在 Narrative Design 部分和触发器中实现动态变量传递。例如，您可以使用 {TimeOfDay} 这样的占位符来创建个性化对话，例如“欢迎，玩家！您的 {TimeOfDay} 过得怎么样？”
* 添加了 MR 演示场景
* 添加了 MR 自动安装和手动安装
* 添加了 Convai XR 包（提供与 Meta SDK 和其他 XR SDK 的兼容性）

### **改进**

* 添加了用于查看和删除 Speaker ID 的长期记忆 API
* 改进了 VR 手动安装
* 改进了自定义包安装

### **紧急修复**

* 小错误修复

***

## 版本 3.1.2

发布：2024年9月16日

### 紧急修复

小错误修复

***

## 版本 3.1.1

发布：2024年9月12日

### 紧急修复

修复了 NPC2NPC 响应延迟

***

## 版本 3.1.0

发布：2024年8月28日

### 变更内容

* 新的 Convai 设置编辑器窗口
* Unity SDK 中集成长期记忆（测试版）
* 带 RTL 支持的 ChatBox UI 改版
* 输入系统改版和移动端 UI 改进

### **改进**

* **UI 改进**
  * 改版后的 ChatBox UI
  * 改进了移动端 UI
  * 实现了聊天禁用功能
  * 添加了使用次数超限通知
  * 为没有 API Key 的情况添加了对话框
* **API 与后端**
  * 重构了 ProcessUserQuery 以更好地处理转录内容
  * 为 Action System 实现了模糊匹配
  * Ready Player Me 和 CC\_Tools 自动导入流程
* **角色与动画**
  * 更新了 Character Importer 管道
  * 为 RPM 角色添加了 OVR effectors
  * 修复了所有角色的 Animator
  * 为 LipSync 用户偏好提供了权重乘数
  * 导入 RPM 角色时将自动添加 Lipsync<br>

### **错误修复与改进**

* **错误修复**
  * 修复了角色在切换后恢复对话的问题
  * 修复了 NarrativeDesignManager 中的章节删除问题
  * 修复了图层问题
  * 优化了 Convai LipSync
* **开发者工具与工作流**
  * 改进了 Convai Logger 系统
  * 更新了所有编辑器脚本的命名空间和格式
  * 删除了 CC Tools 文件夹及其他临时/垃圾文件
  * 在 NarrativeDesignTrigger 检视器中添加了“Update Triggers”按钮
  * 为 actions system 实现了近似字符串匹配
* **其他**
  * 添加了 PlayerDataHandler 和 PlayerDataSO
  * 更新了演示场景中的 NPC 位置和话题
  * 修复了 Convai Setup 窗口中的 Convai 标志

***

## 版本 3.0.1

发布：2024年6月21日

### **错误修复与改进**

* 修复了演示场景中 macOS TMP UGUI 渲染问题
* 预制体缺少 Animator
* 更新了 ActiveNPC 图层检查逻辑

***

## 版本 3.0.0

发布：2024年6月13日

### **变更内容**

#### **NPC2NPC 系统**

* 实现了 NPC2NPC 对话流程系统。
* 添加了对对话中断和重启的处理。
* 增强了对话历史跟踪和流程管理。

#### **叙事设计**

* 添加了与 Narrative Design 相关的文件和触发叙事章节功能。
* 重构了 Narrative Design API，创建了新的移动行为树，并添加了章节变更事件。
* **文件夹重组**
  * 完整重组文件夹和 scripts 文件夹
* **基于性别的 Animator：** 添加了基于性别的 Animator 控制器
* **反馈系统**
  * 实现了带有点赞图标和动画的反馈系统
  * 更新了带反馈按钮的 Transcript UI 预制体
* **Convai 自定义包：** 更新了 Convai 自定义包安装器，并添加了 iOS DLL 下载器
* **场景感知：** 添加了允许玩家指向游戏对象并与之交谈的功能

### **改进**

* **纹理与材质压缩**
  * 压缩了 Amelia 和其他图像（POT 和 Crunch）
  * 更新了图像名称并移除了未使用的图像资源
* **UI 更新**
  * 更新了 UI 预制体，包括 Transcript UI、Mobile UI 和 Mobile QA UI
  * 更新了 Transcript UI 和文本
  * 更新了标志和标志路径
* **系统改进**
  * 重构了 Lipsync 系统，增加了牙齿支持，并实现了面部表情 proto 文件
  * 更新了 ConvaiURPConverterPackage、burst 和 TMPro 包；以及 Convai 自定义包安装器/导出器
  * 更新了 NavMesh 和 NPC2NPC 角色旋转
  * 添加了新的演示场景和 RPM 角色
  * 为保持一致性更新了多个演示场景
* **麦克风管理器：** 将 Microphone Manager 更新为单例类
* **API Key 访问：** 简化了 API Key 访问
* **Convai 场景模板：** 创建了新的场景模板和动态输入系统分配器
* **演示场景**
  * 添加了 NPC2NPC 演示场景
  * 添加了 Narrative Design 演示场景
  * 添加了包含所有功能的新演示场景
  * 适用于桌面和移动端的“Convai Essentials”预制体
* **Lipsync 全面改版**
  * 全面改版了 lipsync 系统，添加了 AR-Kit 和 Reallusion 角色支持
  * 更新了版本并为帧处理添加了多项改进
* **输入系统**
  * 添加了新的输入系统编译指令检查和 Convai Character Layer
  * 简化了 Input Manager 并确保面向未来<br>

### **错误修复**

1. **Transcript UI 错误修复：** 修复了错误并改进了 Transcript UI 角色列表系统
2. **麦克风权限：** 修复了 Android 和 iOS 麦克风权限问题

***

## 版本 2.1.0

### 变更内容

* VR 支持：通过按下一个按钮即可实现虚拟现实功能，创造完全沉浸式体验。
* AR 支持：集成增强现实功能，允许角色和环境在现实世界中通过按下一个按钮与您互动。
* 设置面板：引入一个全面的设置面板，让用户自定义他们的体验。
* 麦克风测试系统：加入麦克风测试功能，以确保最佳音频输入质量。
* 通知系统：实现一个强大的通知系统，向用户通报游戏内事件——尤其是与麦克风相关的问题。
* 输入管理器：使用 Unity 的新输入系统开发一个自定义输入管理系统，支持键盘、手柄和触摸屏等多种输入设备。

### **错误修复与改进**

* 修复：修复了没有 Action Component 时头部跟踪无法工作的问题。
* 改进：添加了可自定义且动态的 Chatbox 支持。
* 改进：改进了 Lip-Sync 平滑效果和音画同步。
* 改进：实现了 Action 事件和事件回调。
* 改进：改进了日志系统。
* 改进：添加了通过语音打断角色回复的能力。
* 改进：改进了移动平台转录 UI。

***

## 版本 2.0.0

### 变更内容

* Lip-sync：为 Reallusion 和基于 Oculus 的角色集成现成的 Lip-sync。
* 文本输入、语音输出：使用文本与角色聊天。
* Character Importer：导入在 Convai Playground 中创建的 Ready Player Me 角色。
* 功能控制系统：通过 Convai NPC 组件按需启用 Convai 功能。
* 日志系统：更好地控制您在调试控制台中看到的 Convai 信息。
* 增强的玩家控制器：当您聚焦角色时自动触发它们，当您的焦点转移后则自动停用它们。
* URP 升级器：使用 URP Upgrader 包（位于 Convai 文件夹中）将渲染管线升级到 Universal Render Pipeline。
* UI 改进：通过自动淡出的 UI 画布改善用户体验。

### 错误与改进

* 修复：解锁光标仍会导致第一人称摄像机移动。
* 修复：在角色说完之前退出播放模式会导致 Unity 崩溃或无法完成编译。
* 修复：UI 文本字段中多个文本块之间的额外空格。
* 修复：Actions 导致 Android 场景崩溃。
* 修复：服务器返回空响应不会导致游戏崩溃，只会抛出错误。
* 改进：使眨眼更平滑。
* 改进：使基于视线跟随的颈部运动更平滑。
* 改进：重组插件结构。


---

# 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/unity-plugin/changelogs.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.