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

# 发布说明

跟踪 Convai Unity SDK 在各个版本中的变化，包括新功能、错误修复和配置更改。

{% updates format="full" %}
{% update date="2026-05-08" tags="v4.2.0,Current" %}

## v4.2.0

**动作系统**

角色可以通过结构化运行时执行场景内命令。本版本新增：

* `ConvaiActionDispatcher` 使用排队分发——动作按顺序执行，不会出现竞态条件
* `IConvaiActionExecutor` 用于自定义执行器的接口
* 六个内置执行器：移动到（Transform 和 NavMesh）、拾取、注视、Animator 触发器和 UnityEvent
* 通过 Inspector 驱动的配置——标准动作设置无需脚本
* 用于监控动作队列状态的运行时诊断

**Meta Quest 透视视觉**

`QuestVisionFrameSource` 无需外部摄像头即可在 Quest 3 和 Quest 3S 设备上启用 Vision 模块。在混合现实会话期间，角色通过设备的透视摄像头进行观看。

**运行时轮流模式切换**

在实时会话期间切换免提和按键通话模式，使用 `ConvaiManager.SetConversationInputModeAsync()` 或运行时设置面板——无需重新加载场景。

**动态上下文扩展**

* Tracker API 可让你在脚本中监控当前上下文状态
* 用于无需代码编写上下文命令的 Inspector 工具
* `SampleDynamicContextUI` 预制体演示运行时注入模式

**场景设置工具与验证**

通过菜单创建组件（**GameObject > Convai > Setup Required Components**）**GameObject > Convai > Validate Scene Setup**）可在进入 Play 模式前防止配置错误。

**设置面板输入模式控制**

运行时设置面板现在提供输入模式切换——玩家或开发者无需脚本即可在会话期间更改轮流模式。
{% endupdate %}

{% update date="2026-04-09" tags="v4.1.0" %}

## v4.1.0

* **动态上下文：** `ConvaiDynamicContextCommand` 组件可在运行时将状态和事件注入到角色知识中
* **LipSync 示例：** 从 LipSync 示例场景中移除了摄像头依赖——适用于任何摄像头设置
* **Vision 模块：** 改进了帧源生命周期和重连处理的可靠性
* **iOS：** 修复了首次访问麦克风时发生崩溃的问题，当 `NSMicrophoneUsageDescription` 未在构建设置中包含时
* **示例场景：** 优化了 Basic 和 LipSync 示例的设置及场景结构
* **编辑器：** 提升了包含大量场景的项目的启动时间
  {% endupdate %}

{% update date="2026-03-12" tags="v4.0.0,Initial Release" %}

## v4.0.0

Convai Unity SDK 的首次公开发布。

**核心组件：** `ConvaiManager`, `ConvaiRoomManager`, `ConvaiCharacter`, `ConvaiPlayer`

**对话管线：** 语音转文本、语言理解与生成、文本转语音——完全实时流式传输

**模块：** LipSync、情感、视觉、叙事设计、动态上下文、长期记忆、场景元数据、对话动画、凝视和注意力

**平台支持：** Windows、macOS、Linux、Android、iOS、WebGL

**编辑器工具：** 场景设置、验证、Project Settings 集成以及 Convai 欢迎窗口
{% endupdate %}
{% endupdates %}

### 下一步

要开始使用 SDK，请遵循 Getting Started。

{% content-ref url="/pages/5ea68df21c8a54f95779af92056a9ab831531be5" %}
[快速上手](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/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-unity-sdk/overview/release-notes.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.