场景元数据如何工作

了解场景对象元数据的注册与传递流程，并学习何时使用场景元数据而不是动态上下文。

ConvaiObjectMetadata, ConvaiMetadataRegistry，以及 ConvaiSceneMetadataCollector 形成一个三段式管道，从你的场景中收集对象描述，并在会话连接时将它们传递给 Convai。理解这一流程有助于你正确配置系统，并在对象未能到达角色时进行调试。

注册与传递流程

每个 ConvaiObjectMetadata 组件会自行注册到 ConvaiMetadataRegistry ，当启用时。房间连接后， ConvaiSceneMetadataCollector 会读取该注册表，组装负载，并将其作为 update-scene-metadata RTVI 消息发送给 Convai。

对象在启用和禁用时会自动注册和注销——无需手动清理。Convai 会在连接时接收所有已注册对象的当前状态。

场景元数据 vs. 动态上下文

这两种系统都会向角色的上下文中注入信息，但用途不同：

	场景元数据	动态上下文
由谁填充	SDK 自动发现对象	开发者手动注入状态
描述内容	场景中的物理对象和实体	运行时状态、事件、玩家操作
发送时间	一次，在房间连接时	随时，按需
典型用途	“南墙上有一个灭火器”	“培训员刚刚未通过阀门检查”

将两者结合使用，以获得最丰富的 AI 上下文体验。

场景元数据描述的是静态世界——存在什么。动态上下文描述的是动态世界——正在发生什么。它们是互补的，而不是竞争的。

下一步

场景元数据快速入门场景元数据使用示例