快速开始

你的第一个 Vision 设置

1

将 Connection Type 设置为 Video

选择 ConvaiRoomManager Hierarchy 中的 GameObject。在 Inspector 中，将 连接类型 到 视频.

会立即出现一个对话框：

Convai Vision 设置 Connection Type 已设置为 Video，但缺少所需的视觉组件。添加 ConvaiVisionPublisher 是位于 CameraVisionFrameSource 到此 ConvaiRoomManager 下吗？

单击 添加组件.

SDK 会创建一个名为 ConvaiVisionRoot 位于 ConvaiRoomManager 并添加这两个 ConvaiVisionPublisher 是位于 CameraVisionFrameSource 到其中。无需再进行其他组件设置。

如果你点击了 稍后 并且需要手动添加组件，请参见下面的手动组件设置。

2

分配一个 Camera（如果不使用 Camera.main）

选择 ConvaiVisionRoot GameObject（位于 ConvaiRoomManager）下。在 CameraVisionFrameSource 组件中，找到 目标摄像机 字段中。

• 如果你的场景中有一个 Camera 带有标签 MainCamera，请将该字段留空——该组件会在运行时自动解析它。
• 如果你想捕获特定摄像头（俯视视角、监控摄像头等），请将该摄像头拖到 目标摄像机 字段中。

默认的 捕获预设 为 平衡 （1280 × 720，15 fps），适用于大多数用例。

3

添加 Vision 调试预览并验证

在任意场景 GameObject 上，点击 添加组件 → Convai/Vision/Vision 调试预览（仅编辑器）.

按 播放。游戏视图中会出现一个覆盖层，显示实时摄像头画面和统计面板。房间连接后，FPS 计数器会递增，帧计数也会开始增加——此时角色已开始接收视觉上下文。

手动组件设置

1. 选择目标 GameObject（任何持久场景对象——通常位于你的 NPC 上或附近）。
2. 添加组件 → 搜索 Convai Vision Publisher.
3. 在同一个 GameObject（或其子对象）上， 添加组件 → Convai/Vision/Camera Vision Frame Source.
4. 分配该 目标摄像机 如果不使用 Camera.main.
5. 将 帧源组件 上的字段 ConvaiVisionPublisher 留空——发布器会在运行时发现 CameraVisionFrameSource 同一个 GameObject 上的它。只有当场景中有多个帧源时，才显式指定它。

刚刚发生了什么

1. SDK 创建了一个 ConvaiVisionRoot 位于……下的子 GameObject ConvaiRoomManager 并添加了 ConvaiVisionPublisher 是位于 CameraVisionFrameSource 到其中。
2. ConvaiRoomManager 建立了一个 视频 与 Convai 后端的连接。
3. ConvaiVisionPublisher 检测到活动房间，并等待帧源就绪。
4. CameraVisionFrameSource 渲染所分配的摄像头（或 Camera.main）到一个 RenderTexture 并发出帧可用的信号。
5. VisionPublishCoordinator 应用了 AutoCompatible 发布策略——10 fps、750 kbps——并将纹理传递给视频管线。
6. 一个名为 "unity-scene" 的视频轨道已发布到 Convai 后端。 IsPublishing 变为 true.

接下来是什么

• 帧源 — 在桌面端切换到摄像头源，配置移动端摄像头权限，或设置 Meta Quest 透视功能。
• 发布与策略 — 调整帧率和码率，或切换到 Manual 策略，以明确控制何时开始发布。
• 调试预览 — 自定义覆盖层的位置、大小和统计信息显示。
• 故障排除与诊断 — 如果有任何内容无法正常工作，请从这里开始。

结论