发行说明

Convai Unity SDK 的发行说明——当前版本亮点、先前发行说明、错误修复以及每个版本的迁移指南。

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

2026年5月8日

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 模式前防止配置错误。

设置面板输入模式控制

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

2026年4月9日

v4.1.0

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

2026年3月12日

v4.0.0

Convai Unity SDK 的首次公开发布。

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

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

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

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

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

下一步

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

快速入门