空间感知设置参考

查阅所有空间感知和对象命名项目设置、其默认值、单位以及启用它的条件。

每个控制空间感知的项目设置，以及筛选单个聊天机器人接收内容的按聊天机器人偏好设置的规范参考。事实来源： Source/Convai/Convai.h (UConvaiSettings，类别 空间感知 和 对象）以及 Source/Convai/Public/ConvaiSpatialPreferences.h (FConvaiSpatialAwarenessPreferences).

以下所有项目设置都位于 编辑 > 项目设置 > 插件 > Convai.

该 空间感知 类别

显示名称	属性	默认值	单位	编辑条件
启用空间感知	bEnableSpatialAwareness	true	—	无（总开关）
启用视线	bEnableLineOfSight	false	—	bEnableSpatialAwareness
近距离	NearbyDistance	1000.0	厘米	bEnableSpatialAwareness
中等距离	ModerateDistance	4000.0	厘米	bEnableSpatialAwareness
启用关系	bEnableRelations	true	—	bEnableSpatialAwareness
关系聚类距离	RelationClusterDistance	600.0	厘米	bEnableSpatialAwareness && bEnableRelations
从玩家视角描述	bDescribePlayerPerspective	true	—	bEnableSpatialAwareness

• NearbyDistance 低于该上限时，一个对象会被视为“附近”； ModerateDistance 低于该上限时，会被视为“有些距离”。超过 ModerateDistance时，一个对象会被视为“远处”。 ModerateDistance 应设置得大于 NearbyDistance.
• bEnableLineOfSight 每次轮询中，每个聊天机器人/对象对都要消耗一次射线检测。射线无法看见的对象会被报告为超出视野，其位置将被隐藏。
• RelationClusterDistance 限定两个对象必须相距多近，才会描述它们之间的关系（“木箱在桶旁边”）。
• bDescribePlayerPerspective 大约会使传递给聊天机器人的空间文本长度翻倍，因为它会为每条事实添加一个相对于玩家的从句。

参见 空间感知的工作原理 用于说明每项设置会如何改变角色接收的句子。

该 对象 类别

显示名称	属性	默认值	单位	编辑条件
重复名称后缀样式	ObjectNameSuffixStyle (EConvaiObjectNameSuffixStyle)	数字	—	无

ObjectNameSuffixStyle 仅控制后缀样式—— 数字 （“Crate”、“Crate 2”、“Crate 3”）或 字母 （“Crate”、“Crate A”、“Crate B”）——适用于共享同名且已 不 合并的 Convai 对象组件。第一个注册的对象保留其原始名称。一组同名对象是否合并为一个逻辑对象而不是添加后缀，是在 Convai 对象组件本身上的按对象选择，而不是项目设置——参见 合并同名物体.

按聊天机器人设置的空间偏好

这些不是项目设置——它们位于每个 UConvaiChatbotComponent，在 SpatialAwareness 属性（FConvaiSpatialAwarenessPreferences，类别 Convai | 空间感知，高级显示）中。它们会筛选单个聊天机器人从上文所述的空间传递中接收到的内容；当 启用空间感知 在项目设置中关闭时，它们不起作用。

周围环境

属性	类型	默认值	描述
bReceiveSurroundings	bool	true	是否向该聊天机器人告知对象、其他角色以及玩家相对于它自身的位置。
SurroundingsResponse	EC_RunLLMOption	从不	当其周围环境变化时，聊天机器人如何反应。 从不 静默更新； Auto/总是 同时提示 AI 回应。
SurroundingsDelivery	EConvaiContextDelivery	正常发送	周围环境变化何时传达到聊天机器人。仅在 SurroundingsResponse 为 Auto/总是. 正常发送 批量并入下一次计划发送时相关； 等待对话空闲 在无人发言前一直保持。

关系

属性	类型	默认值	描述
bReceiveRelations	bool	true	是否向该聊天机器人告知附近事物彼此之间的关系，与……无关 bReceiveSurroundings.
RelationsResponse	EC_RunLLMOption	从不	当这些关系变化时，聊天机器人如何反应。 从不 静默更新； Auto/总是 同时提示 AI 回应。
RelationsDelivery	EConvaiContextDelivery	正常发送	关系变化何时传达到聊天机器人。仅在 RelationsResponse 为 Auto/总是。与……相同的两个值： SurroundingsDelivery.

下一步

空间感知快速入门排查空间感知问题