> 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-unreal-engine-plugin/features/scene-metadata.md).

# 场景元数据

查找指南、参考页面和示例，了解如何让 Convai 角色感知 Unreal Engine 关卡中的对象。

场景元数据是你向 Convai 角色提供对关卡中对象感知能力的方式。添加一个 `UConvaiObjectComponent` 到任何 `Actor` ——一扇门、一个箱子、一个终端——，关卡中的每个角色都会知道该对象的存在、名称以及作用。当玩家询问周围环境时，角色会使用这些信息。

对于运行时变更——添加对象、移除演员、设置对话伙伴以及控制注意力——请使用……上的环境 API `UConvaiChatbotComponent`。请参阅 [运行时管理环境](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/scene-metadata/managing-the-environment-at-runtime.md) 以查看完整的方法参考。

当玩家看向带标签的对象时， [凝视关注](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/gaze-attention.md) 系统可以自动将它们提升为聊天机器人的当前焦点。先完成场景元数据设置，然后再继续 [凝视关注快速入门](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/gaze-attention/gaze-attention-quick-start.md).

<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="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/scene-metadata/how-scene-metadata-works.md">场景元数据的工作原理</a></td></tr><tr><td><strong>场景元数据快速入门</strong><br>为世界演员添加 Convai Object Component 标签，并测试角色是否能在对话中使用它。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/scene-metadata/scene-metadata-quick-start.md">场景元数据快速开始</a></td></tr><tr><td><strong>场景元数据组件参考</strong><br>Convai Object Component 的完整属性、函数和事件参考。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/scene-metadata/scene-metadata-component-reference.md">场景元数据组件参考</a></td></tr><tr><td><strong>运行时管理环境</strong><br>在游戏过程中向聊天机器人的环境中添加、移除和更新世界演员。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/scene-metadata/managing-the-environment-at-runtime.md">运行时管理环境</a></td></tr><tr><td><strong>场景元数据使用示例</strong><br>医疗培训、工业安全演练、军事模拟以及运行时环境更新的完整设置。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/scene-metadata/scene-metadata-usage-examples.md">场景元数据使用示例</a></td></tr><tr><td><strong>场景元数据故障排查</strong><br>诊断并修复场景对象无法被识别或跟踪属性无法更新的常见问题。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/scene-metadata/troubleshoot-scene-metadata.md">排查场景元数据问题</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 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-unreal-engine-plugin/features/scene-metadata.md?ask=<question>&goal=<user_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.