> 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-07-21" tags="v4.4.0,Current" %} ## v4.4.0 **规范化转录时间线** `ConvaiManager.Transcripts` 现在公开一个房间作用域的 `TranscriptTimeline` 由不可变的 `TranscriptTurn` 以及 `TranscriptChange` 模型构建而成，取代了之前基于快照的契约。 `CurrentTimeline` 返回 `TranscriptTimeline` 而不是时间线快照， `已更改` 提供 `TranscriptChangeBatch`，以及 `Subscribe`/`SubscribeCommitted` 回调接收 `TranscriptChange` 值。这对于任何使用旧快照类型的代码来说都是破坏性变更——请参阅 [Transcript API](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/scripting-reference/transcript-api.md) 参考文档，了解完整迁移路径。 **角色动作** * `ConvaiActionConfigPatch` 在活动会话期间更新角色的动作、角色目标、对象目标以及当前注意对象，具有省略列表与空列表语义，并生成更新 ID * `ConvaiActionDefinition.WaitForBotSpeech` （镜像于 `ConvaiActionCommand`）会让新批次中的第一个动作在执行前等待角色讲话，并带有可选的 `DelayAfterBotSpeechSeconds` 暂停以及调度器级别的语音门控超时，因此静默回合不会阻塞该批次 **AI 编码助手集成** **Convai > AI 编码设置** 打开一个新的编辑器部分，用于配置基于 Unity MCP 的 AI 编码辅助，支持 Codex、Claude Code、Cursor、Gemini 和 VS Code Copilot。专门的文档章节对该集成进行了完整说明。 **动态视觉上下文** 房间可以通过全新的动态视觉上下文部分选择启用后端帧采样，位于 `ConvaiRoomManager` 以及 `ConvaiRoomManagerProfile`. **Convai SDK 设置** 该 **Convai SDK** 项目设置页面（**编辑 > 项目设置 > Convai SDK**）以及编辑器窗口中新加入的 **Convai > 设置** 部分共用同一实现，涵盖设置健康、凭据、运行时默认值、诊断、高级和关于。凭据部分增加了 API 密钥混淆、从明文的自动迁移、环境预设（生产、Beta 或自定义），以及带有缓存验证徽章的验证并保存操作。 **唇形同步** 播放对齐加固将 NeuroSync 唇形同步锚定到语音开始的精确音频帧，减少长响应或中断响应时的漂移。 **破坏性变更** * `ConvaiSettings.DefaultMicrophoneIndex` 已替换为 `DefaultMicrophoneDeviceId` （字符串）——整数索引不会迁移；请在 设置 > 运行时默认值 中重新选择麦克风 * `ConvaiSettings.ServerUrl` 现在由环境预设派生——序列化的 URL 仅在环境为 `自定义` * 该 **Convai > 日志设置** 菜单已移除——日志配置位于 **Convai > 设置** （诊断） * `ConvaiRespondMode` 统一了响应模式词汇（`ConvaiContextReactionMode` 已移除）——仅与基于未发布测试版构建保存的场景相关 {% endupdate %} {% update date="2026-06-23" tags="v4.3.0" %} ## v4.3.0 * **VAD 设置：** 可配置的房间连接时用户语音活动检测（VAD）设置，支持房间和配置文件的检查器控制以及服务器默认值处理 * **动态上下文 v2：** 统一的动态上下文流程，包含受跟踪的状态和事件、批处理、确认/结果事件，以及 `ConvaiDynamicContextRelay` 创作界面 * **世界对象上下文：** 同步的世界对象上下文会通过动态上下文发送受跟踪的场景元数据和当前聚焦对象 * **叙事触发器：** 为已保存触发器、行内事件和脚本化语音分别提供不同的触发模式 * **转录 UI：** 用于空间 UI 方案的世界空间聊天转录预制体 * **动作：** 动作配置验证和重复绑定保留，带有步骤诊断和动作调试探查 * **聊天输入：** 聊天输入的回车聚焦行为 **迁移说明** * 动态上下文现在使用 v2 受跟踪的更新流程——请优先使用 `ConvaiCharacter.DynamicContext` 或 `ConvaiDynamicContextRelay` ，而不是已移除的命令式动态上下文 UI * 叙事触发请求现在会携带明确模式——请根据所需的后端行为使用已保存触发器、行内事件或脚本化语音 * 自定义 VAD 值仅在房间连接时发送——当后端应负责 VAD 默认值时，请使用服务器默认选项 {% endupdate %} {% update date="2026-05-08" tags="v4.2.0" %} ## v4.2.0 **动作系统** 角色可以通过结构化运行时执行场景内命令。本版本新增： * `ConvaiActionDispatcher` 带队列式调度——动作按顺序执行，不会发生竞态条件 * `IConvaiActionExecutor` 自定义执行器接口 * 六个内置执行器：移动到（Transform 和 NavMesh）、拾取、注视、Animator 触发器以及 UnityEvent * 由检查器驱动的配置——标准动作设置无需编写脚本 * 用于监控动作队列状态的运行时诊断 **Meta Quest 透视视觉** `QuestVisionFrameSource` 可在 Quest 3 和 Quest 3S 设备上启用视觉模块，无需外接摄像头。在混合现实会话期间，角色可透过设备的透视摄像头观看。 **运行时轮流模式切换** 在实时会话期间，可使用 `ConvaiManager.SetConversationInputModeAsync()` 或运行时设置面板在免提和按键说话模式之间切换——无需重新加载场景。 **动态上下文扩展** * 跟踪器 API 可让你从脚本监控当前上下文状态 * 用于在无需代码的情况下编写上下文命令的检查器工具 * `SampleDynamicContextUI` 预制体演示了运行时注入模式 **场景设置工具与验证** 菜单驱动的组件创建（**GameObject > Convai > 设置所需组件**）以及场景验证（**GameObject > Convai > 验证场景设置**）可在进入 Play 模式前防止配置错误。 **设置面板输入模式控制** 运行时设置面板现在公开输入模式切换——玩家或开发者可以在会话期间无需脚本地更改轮流模式。 {% endupdate %} {% update date="2026-04-09" tags="v4.1.0" %} ## v4.1.0 * **动态上下文：** `ConvaiDynamicContextCommand` 组件可将状态和事件在运行时注入到角色知识中 * **唇形同步示例：** 从唇形同步示例场景中移除了对摄像机的依赖——可与任何摄像机设置配合使用 * **视觉模块：** 改进了帧源生命周期和重新连接处理的可靠性 * **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` **对话流水线：** 语音转文本、语言理解与生成、文本转语音——完全实时流式传输 **模块：** 唇形同步、情绪、视觉、叙事设计、动态上下文、长期记忆、场景元数据、对话动画、注视与注意力 **平台支持：** Windows、macOS、Linux、Android、iOS、WebGL **编辑器工具：** 场景设置、验证、项目设置集成以及 Convai 欢迎窗口 {% endupdate %} {% endupdates %} ### 下一步 要开始使用该 SDK，请按照《入门指南》操作。 {% 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, and the optional `goal` query parameter: ``` GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/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.