> 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 角色感知你关卡中对象的方式。添加一个 `UConvaiObjectComponent` 到任意 `Actor` —— 一扇门、一个箱子、一个终端 ——，关卡中的每个角色都会知道该对象存在、它叫什么以及它有什么作用。当玩家询问周围环境时，角色会使用这些信息。

对于运行时变更——添加对象、移除角色、设置对话伙伴以及控制注意力——请在 `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="/pages/a6fd7e3b5ee94be300d9c248743b197b93cc0c96">/pages/a6fd7e3b5ee94be300d9c248743b197b93cc0c96</a></td></tr><tr><td><strong>场景元数据快速入门</strong><br>使用 Convai 对象组件为一个世界 Actor 添加标签，并测试角色是否可以在对话中使用它。</td><td><a href="/pages/0feb18e88feac4367d421728b98f739c505dcd5a">/pages/0feb18e88feac4367d421728b98f739c505dcd5a</a></td></tr><tr><td><strong>场景元数据组件参考</strong><br>Convai 对象组件的完整属性、函数和事件参考。</td><td><a href="/pages/5b34043c604b8f8fd8088c66f01ea7887fcd8846">/pages/5b34043c604b8f8fd8088c66f01ea7887fcd8846</a></td></tr><tr><td><strong>运行时管理环境</strong><br>在游戏过程中向聊天机器人的环境中添加、移除和更新世界 Actor。</td><td><a href="/pages/4a8ee50a93a78b9b86484cb79897f6d0d6bde187">/pages/4a8ee50a93a78b9b86484cb79897f6d0d6bde187</a></td></tr><tr><td><strong>场景元数据使用示例</strong><br>医疗培训、工业安全演练、军事模拟以及运行时环境更新的完整设置。</td><td><a href="/pages/7fc985238017f8bd9de6df276f318c98902cac03">/pages/7fc985238017f8bd9de6df276f318c98902cac03</a></td></tr><tr><td><strong>排查场景元数据问题</strong><br>诊断并修复场景对象未被识别或跟踪属性无法更新等常见问题。</td><td><a href="/pages/35be910ed18e7f78411fd4d732770d70307e1434">/pages/35be910ed18e7f78411fd4d732770d70307e1434</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-unreal-engine-plugin/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.