动态上下文

查找通过动态上下文中继、脚本 API 和同步世界对象属性向 Convai 角色发送实时场景状态的指南。

动态上下文让 Convai 角色能够实时感知 Unity 场景中正在发生的事情。角色可以引用学员当前所在的站点、刚刚拾取的物品，或刚触发的警报，并在对话进行时将这些信息融入其中。两个入口点会写入同一跟踪状态，并产生相同的网络行为： ConvaiDynamicContextRelay 用于事件驱动绑定的 Inspector 组件，以及 DynamicContext 位于 ConvaiCharacter 上的属性，适用于代码驱动的系统。

动态上下文的工作原理 了解跟踪状态和事件模型、批处理行为，以及确认结果如何传递到你的代码中。

动态上下文快速入门 添加 ConvaiDynamicContextRelay 将其连接到 NPC，并在几个步骤中验证具备上下文感知的对话。

Relay 组件参考 逐字段参考： ConvaiDynamicContextRelay 以及 ConvaiRespondMode 及其接受的值。

连接时的静态上下文 为会话期间不会变化的事实配置在连接时仅发送一次的初始动态信息。

同步行为与时序 Replace、Append 和 Reset 消息如何批处理和刷新，包括 DynamicContextBatchDelaySeconds 时间窗口。

动态上下文脚本 API 完整的 API 参考： ConvaiCharacter.DynamicContext，包括所有方法和 ConvaiRespondMode 枚举。

动态上下文使用示例 涵盖安全演练、入职引导、导览，以及同步世界对象跟踪的端到端场景。

排查动态上下文问题 用于 relay 和 tracker 流程的排查清单、症状表和 Console 日志参考。

同步的世界对象上下文

一个 ConvaiObjectMetadata 组件可以在场景对象上公开已跟踪属性。每个已跟踪属性都会映射到一个动态上下文状态，所有已连接的角色都会自动接收，无需显式 SetState 在你的代码中调用。参见 场景元数据 了解如何注册对象并配置已跟踪属性。

下一步

从 动态上下文快速入门 以启动具备上下文感知的对话。然后阅读 动态上下文的工作原理 ，以在进入参考页面之前了解跟踪状态和事件模型。