For the complete documentation index, see llms.txt. This page is also available as Markdown.

Windows、macOS 和 Linux

Windows、macOS 和 Linux 构建无需额外的 SDK 配置——包括 Vision、空间音频和屏幕共享在内的所有功能在标准设置后即可工作。

桌面版构建没有平台特定的配置要求。所有 SDK 功能都无需额外设置即可工作——无需权限声明、无需修改 manifest、无需手势处理。麦克风访问、音频播放、空间音频、Vision 和屏幕共享在完成标准 SDK 设置后即可立即运行。

功能支持

功能
Windows
macOS
Linux

语音对话

✅ 完整支持

✅ 完整支持

✅ 完整支持

口型同步

✅ 完整支持

✅ 完整支持

✅ 完整支持

动作

✅ 完整支持

✅ 完整支持

✅ 完整支持

情绪

✅ 完整支持

✅ 完整支持

✅ 完整支持

长期记忆

✅ 完整支持

✅ 完整支持

✅ 完整支持

叙事设计

✅ 完整支持

✅ 完整支持

✅ 完整支持

视觉

✅ 完整支持

✅ 完整支持

✅ 完整支持

空间音频

✅ 完整支持

✅ 完整支持

✅ 完整支持

Unity AudioSource 播放

✅ 完整支持

✅ 完整支持

✅ 完整支持

麦克风设备选择

✅ 完整支持

✅ 完整支持

✅ 完整支持

屏幕共享

✅ 完整支持

✅ 完整支持

✅ 完整支持

屏幕共享是桌面端专属功能——在 WebGL、iOS、Android 或基于 Android 的 XR 头显上不可用。

平台和架构支持

SDK 为以下桌面配置提供预编译的原生库:

平台
支持的架构

Windows

x86_64、arm64

macOS

arm64(Apple Silicon)、x86_64(Intel)、通用

Linux

x86_64

麦克风和音频

桌面平台不需要权限声明。操作系统在应用层授予麦克风访问权限:

  • Windows: 访问通过 Windows 隐私设置管理。Unity 构建会被识别为桌面应用,并且无需任何 manifest 更改即可获得麦克风访问权限。

  • macOS: 当应用首次访问麦克风时,操作系统会显示一次性的系统权限对话框。Unity 会添加 NSMicrophoneUsageDescription 到应用的 Info.plist 在 macOS 构建中自动添加。无需手动配置。

  • Linux: 麦克风访问由系统音频栈(PulseAudio、PipeWire、ALSA)处理。无需进行应用级权限处理。

桌面端的 Vision

CameraVisionFrameSource 可在所有桌面平台上正常工作,无需额外配置——将该组件添加到一个 Camera GameObject,分配一个 ConvaiVisionPublisher,Vision 即可激活。

摄像头捕获会在内部应用垂直像素翻转,以确保正确的帧方向。这在所有桌面平台上都会自动处理——无需配置。

使用示例

Windows 上的军事任务演练

一家国防承包商在 Windows 工作站上运行任务演练软件。Convai 角色在分支场景中扮演敌对势力、地方指挥官和平民角色。受训人员使用标准桌面麦克风与角色对话。

设置: 标准 SDK 配置——无需平台特定步骤。空间音频会根据玩家位置将角色声音置于三维空间中。

结果: 受训人员在任务模拟中通过语音与多个角色互动。会话会记录回答和分支决策,以供行动后复盘。

macOS 上的医疗问诊培训

一所医学院在教师的 MacBook Pro 上部署患者问诊训练器。住院医师通过一个 Convai 角色练习采集病史,该角色会以逼真的症状作出回应,并根据住院医师的问题进行调整。

设置: 标准 SDK 配置。该角色通过 Vision 使用 CameraVisionFrameSource 指向住院医师正在查看的实体模型。macOS 会在首次启动时提示麦克风访问权限——无需额外设置。

结果: 住院医师自然地与角色交谈。macOS 麦克风权限对话框仅在首次启动时出现。Vision 使角色能够识别并回应住院医师在场景中手持的物体。

Linux 上的合规培训自助终端

一家制造企业在安全设施中的 Linux 工作站上运行安全合规培训。与 Windows 上使用的同一个 Unity 构建无需修改即可部署到 Ubuntu x86_64 机器。

设置: 标准 SDK 配置。确保部署机器运行 x86_64 Linux——不支持 arm64。无需更改音频配置;PulseAudio 或 PipeWire 会自动处理麦克风访问。

结果: 操作员在自助终端上与 Convai 角色完成口头合规评估。体验与 Windows 部署完全相同。

下一步

桌面版构建无需平台特定工作。一旦你的场景通过验证,构建即可发布。如果你还要面向 WebGL、iOS、Android 或 XR 头显,请在构建前查阅相关平台指南。

WebGLiOS 和 AndroidXR 头显

最后更新于

这有帮助吗?