{% 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 导入 **LipSync 示例** 并打开其场景，以测试这一来回流程。该示例会实例化一个 **示例调试中心** 并传入一个 **视觉** 面板以及其 **上下文** 和 **情绪** 面板。
打开 **视觉** 面板以访问这些控件：
| 控件 | 操作 |
| --------------------------------- | ---------------------------------------------------------------------------------- |
| **文本消息** 输入 + **发送文本** | 通过 `ConvaiPlayer.SendTextMessage`发送纯文本消息。先用它确认角色是否有响应。 |
| **视觉提示** 和 **响应模式** 输入 + **视觉状态** | 调用 `ConvaiRoomManager.RequestVisionStatus()`。一旦 Convai 应答，结果文本会报告后端的缓冲区结果、活动源和帧年龄。 |
| **视觉提示** 和 **响应模式** 输入 + **视觉触发** | 调用 `ConvaiRoomManager.TriggerVision()` 以及解析后的响应模式。结果文本会报告是否附加了帧，以及请求是否被降级。 |
该 **响应模式** 输入接受 `silent`, `auto`，或 `must_respond`。在发送请求前，未识别的值会被拒绝。随后结果文本显示 `无效的响应模式“”——请使用 silent、auto 或 must_respond`.
例如，在一次成功触发后，结果文本会显示：
```
视觉触发：状态=success，结果=frames_available，附加=attached，帧数=5，降级=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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
