{% hint style="warning" %}
**`IsCapturing` 与 `IsPublishing`:** 统计面板显示 `IsCapturing` ——帧源是否正在生成帧。这与 `ConvaiVisionPublisher.IsPublishing`不同，后者表示是否有 WebRTC 视频轨道正在发送到 Convai。这两者可以独立检查；某个源可能正在捕获，但发布已暂停或尚未开始。
{% endhint %}
### 脚本访问
可从其他脚本读取这些属性：
| 属性 | 类型 | 描述 |
| ------------- | ------- | ---------------------- |
| `ShowPreview` | `bool` | 获取或设置预览覆盖层是否可见。 |
| `ShowStats` | `bool` | 获取或设置统计面板是否可见。 |
| `CurrentFps` | `float` | 测得的捕获 FPS，每 0.5 秒更新一次。 |
| `FrameCount` | `long` | 当前帧源的累计帧数。 |
| `IsCapturing` | `bool` | 当前帧源是否正在捕获。 |
### 使用 Sample Debug Hub 验证视觉请求
`VisionDebugPreview` 确认帧源正在本地生成帧。它不能确认 Convai 已接收到这些帧，也不能确认特定视觉请求是否得到了答复。请从 Package Manager 导入 **口型同步示例** 并打开其场景，以测试这条往返流程。该示例会在其 **示例调试中心** ，并传入一个 **视觉** 面板旁实例化一个 **上下文** 和 **情绪** 面板。
打开 **视觉** 面板以访问这些控件：
| 控制 | 操作 |
| ---------------------------------- | ------------------------------------------------------------------------------------- |
| **文本消息** 输入 + **发送文本** | 通过 `ConvaiPlayer.SendTextMessage`发送一条纯文本消息。先用它来确认角色是否有响应。 |
| **视觉提示词** 和 **响应模式** 输入 + **视觉状态** | 调用 `ConvaiRoomManager.RequestVisionStatus()`。当 Convai 响应后，结果文本会报告后端的缓冲结果、当前活动源以及帧的年龄。 |
| **视觉提示词** 和 **响应模式** 输入 + **视觉触发** | 调用 `ConvaiRoomManager.TriggerVision()` 使用提示词文本和已解析的响应模式。结果文本会报告是否附加了帧，以及请求是否被降级。 |
该 **响应模式** 输入接受 `silent`, `auto`，或 `must_respond`。在请求发送前，无法识别的值会被拒绝。结果文本随后会显示 `无效的响应模式“”——请使用 silent、auto 或 must_respond`.
例如，在一次成功触发后，结果文本会显示：
```
视觉触发：状态=success，结果=frames_available，attach=attached，frames=5，downgraded=False
```
若只想在不使用 Hub 的情况下进行场景检查，请添加 `DynamicVisionContextSceneTool` 到任意 GameObject。它通过 IMGUI 覆盖层和等效的上下文菜单命令（**发送文本消息**, **请求视觉状态**, **触发视觉**）提供相同的三个操作。LipSync 示例场景还放置了一个视觉目标装置——位于角色前方的彩色道具——供 **视觉触发** 请求描述。
### 已知限制
* 仅限编辑器。 `VisionDebugPreview` 调用 `enabled = false` 中的 `Awake()` 在非编辑器构建中生效。发布版本中没有运行时开销。
* 在 WebGL 上，覆盖层是空白的，因为 `ConvaiVisionPublisher` 会绕过帧源并直接使用 `canvas.captureStream()` 。没有可供显示的 `RenderTexture` 。请通过 `IsPublishing` 替代。
* 该覆盖层通过 `OnGUI` （IMGUI）渲染。它不能用 UGUI 定位，也不能在世界空间中渲染。
* 每个 `VisionDebugPreview` 组件只会绘制一个统计面板。如果你需要并排比较两个帧源，请添加多个组件。
* `VisionContextDebugPanel` 和 `DynamicVisionContextSceneTool` 是在 `SamplesShared/`下的仅示例组件。它们不是运行时 SDK 的一部分，除非你导入并保留示例，否则不会包含在发布版本中。
### 下一步
{% content-ref url="/pages/b15c237537e3521d8e360ca90de5e9b15be340ec" %}
[发布策略](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/vision/publishing-and-policies.md)
{% endcontent-ref %}
{% content-ref url="/pages/86612bc613c5a299a468b71b3fb8a40e625ee1fe" %}
[排查视觉问题](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/vision/troubleshooting-and-diagnostics.md)
{% endcontent-ref %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/vision/debug-preview.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.