> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/scene-metadata.md).

# 场景元数据

场景元数据使 Convai 角色能够感知 Unity 场景中的物理对象。添加一个 `ConvaiObjectMetadata` 组件到任何 GameObject，描述它是什么，SDK 会在会话连接时自动收集并将该信息发送给 Convai——标准工作流程无需编写脚本。

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>场景元数据如何工作</strong><br>了解注册和传递流程，以及何时使用场景元数据而非动态上下文。</td><td><a href="/pages/df7e8b09abcd66c8464d199cbe2d609cb6a389a8">/pages/df7e8b09abcd66c8464d199cbe2d609cb6a389a8</a></td></tr><tr><td><strong>场景元数据快速入门</strong><br>注册你的第一个场景对象，并确认它在五分钟内发送到 Convai。</td><td><a href="/pages/6870c01843dd57c3ac7ecac3bfb3a6790f115e1b">/pages/6870c01843dd57c3ac7ecac3bfb3a6790f115e1b</a></td></tr><tr><td><strong>场景元数据组件参考</strong><br>ConvaiObjectMetadata 和 ConvaiSceneMetadataCollector 的所有 Inspector 字段。</td><td><a href="/pages/b55fe13afe8f10f3ca27eec09be22c5bd975a884">/pages/b55fe13afe8f10f3ca27eec09be22c5bd975a884</a></td></tr><tr><td><strong>场景元数据脚本 API</strong><br>ConvaiMetadataRegistry 静态 API 和 ConvaiSceneMetadataCollector 的公共方法。</td><td><a href="/pages/553ff838d38639ef80a27f8380dc466768470562">/pages/553ff838d38639ef80a27f8380dc466768470562</a></td></tr><tr><td><strong>场景元数据使用示例</strong><br>医疗培训、工业安全、博物馆导览以及运行时对象排除的完整设置。</td><td><a href="/pages/16c5aa93667aec71180b560b3408b114f488e893">/pages/16c5aa93667aec71180b560b3408b114f488e893</a></td></tr><tr><td><strong>排查场景元数据问题</strong><br>用于诊断 AI 忽略对象、验证错误、空元数据负载和依赖失败的问题。</td><td><a href="/pages/f6f3f3d88a3636afea1b0c8774162c2014fba780">/pages/f6f3f3d88a3636afea1b0c8774162c2014fba780</a></td></tr></tbody></table>


---

# 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:

```
GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/scene-metadata.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.