平台支持矩阵

Convai Unity SDK 平台支持参考，包括 Windows、macOS、Android、iOS、Meta Quest 和 WebGL 的功能可用性。

Convai Unity SDK 可在所有主要的 Unity 部署目标上运行。功能可用性因平台而异——在针对特定目标构建之前，请使用下表确认支持情况。

功能 × 平台矩阵

功能	Windows / macOS / Linux	Android	iOS	Meta Quest	WebGL
语音对话	✅ 完整支持	✅ 完整支持	✅ 完整支持	✅ 完整支持	✅ 完整支持
麦克风采集	✅ 完整支持	✅ 完整支持	✅ 完整支持	✅ 完整支持	✅ 完整支持 — 需要 HTTPS + 用户手势
远程音频播放	✅ Unity AudioSource	✅ Unity AudioSource	✅ Unity AudioSource	✅ Unity AudioSource	⚠️ 通过浏览器路由
口型同步	✅ 完整支持	✅ 完整支持	✅ 完整支持	✅ 完整支持	⚠️ 已知的时序漂移
空间音频	✅ 完整支持	✅ 完整支持	✅ 完整支持	✅ 完整支持	❌ 不支持
动作	✅ 完整支持	✅ 完整支持	✅ 完整支持	✅ 完整支持	✅ 完整支持
情绪	✅ 完整支持	✅ 完整支持	✅ 完整支持	✅ 完整支持	✅ 完整支持
长期记忆	✅ 完整支持	✅ 完整支持	✅ 完整支持	✅ 完整支持	✅ 完整支持
叙事设计	✅ 完整支持	✅ 完整支持	✅ 完整支持	✅ 完整支持	✅ 完整支持
动态上下文	✅ 完整支持	✅ 完整支持	✅ 完整支持	✅ 完整支持	✅ 完整支持
Vision — 摄像头	✅ 完整支持	✅ 完整支持	✅ 完整支持	✅ 完整支持	⚠️ 画布捕获
Vision — 网络摄像头	✅ 完整支持	⚠️ 需要运行时权限	⚠️ NSCameraUsageDescription 必需	❌ 不适用	❌ 不支持
Vision — Quest 透视	❌ 不支持	❌ 不支持	❌ 不支持	✅ 完整支持	❌ 不支持

平台特定要求

WebGL

WebGL 完全受支持，但受浏览器安全策略施加的以下限制约束：

• 麦克风采集 需要 HTTPS 或 localhost。HTTP 部署无法访问麦克风。请在 ConvaiManager.EnableAudioAndStartListening() 通过用户手势（按钮点击）触发——不要在场景加载时自动启动音频。
• 远程音频播放 通过浏览器的音频系统路由，而不是 Unity 的 AudioSource。在 AudioSource 组件上的音量和空间化控制对 WebGL 无效。
• Vision — 摄像头 使用浏览器画布捕获（CameraVisionFrameSource 支持）。
• Vision — 网络摄像头 (WebcamVisionFrameSource）在 WebGL 上不受支持— AsyncGPUReadback 在浏览器运行时不可用。请使用 CameraVisionFrameSource 来改为流式传输游戏画布。
• 空间音频 在 WebGL 上不受支持。

WebGL 存在已知的音频/唇同步时序漂移缺陷——音频和唇同步数据能够正确到达，但在浏览器构建中播放时序可能会漂移。这是一个已跟踪的缺陷，而不是缺失的功能。在发布前，请在目标浏览器中进行验证。

始终在实际托管环境中验证 WebGL 构建，尤其是在构建嵌入 iframe 时。若将构建嵌入到您控制的页面中，请在 iframe 标签中添加 allow="microphone" 到 iframe 标签中。

有关详细的 WebGL 设置、浏览器兼容性和部署步骤，请参阅 WebGL 平台指南。

WebGL

Android

iOS

Meta Quest

下一步

在确认平台限制后，请查看实时 SDK 运行所需的网络要求。

网络和 API 要求