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

Windows、macOS 和 Linux

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

桌面构建没有特定平台的配置要求。所有 SDK 功能都无需额外设置即可使用——无需权限声明、无需修改清单、无需手势处理。麦克风访问、音频播放、空间音频、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 构建会被识别为桌面应用,并且无需任何清单更改即可获得麦克风访问权限。

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

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

桌面端的 Vision

CameraVisionFrameSource 可在所有桌面平台上运行,无需额外配置——将组件添加到 摄像机 一个 GameObject,分配一个 ConvaiVisionPublisher,Vision 即可启用。

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

使用示例

Windows 上的军事任务演练

一家国防承包商在 Windows 工作站上运行任务演练软件。Convai 角色扮演敌对部队、本地指挥官和平民角色,参与一个分支情景。受训者使用标准桌面麦克风与角色交谈。

设置: 标准 SDK 配置——无需特定平台步骤。空间音频会将角色的声音以 3D 空间方式定位到玩家位置周围。

结果: 受训者在任务模拟中与多个角色进行口头互动。该会话会记录回应和分支决策,供事后复盘。

macOS 上的医疗问诊训练

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

设置: 标准 SDK 配置。该角色通过 CameraVisionFrameSource 进行 Vision,镜头对准住院医师正在检查的实体模型。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 头显

最后更新于

这有帮助吗?