For the complete documentation index, see llms.txt. This page is also available as Markdown.

空间感知快速开始

开启空间感知,按关卡比例调整距离区间,并确认角色实际接收到的内容。

本指南会为你的项目开启空间感知,调整距离分段以匹配关卡的比例,并通过 Convai Debug Overlay 确认聊天机器人确实收到了系统生成的句子。

先决条件

  • 已安装 Convai Unreal Engine 插件。

  • 至少有一个 UConvaiChatbotComponent 被放置在关卡中。

  • 关卡中至少有另一个 Actor 具有一个 UConvaiObjectComponent,因此有可供聊天机器人获知的内容。

确认总开关已开启

1

打开项目设置

前往 编辑 > 项目设置 > 插件 > Convai 并展开 空间感知 类别。

2

确认“Enable Spatial Awareness”已勾选

启用空间感知 (bEnableSpatialAwareness) 默认已勾选。如果未勾选,则项目中的任何聊天机器人都不会生成邻近、视线或关系事实——现在就勾选它。

调整距离分段以匹配关卡的比例

空间感知会使用两个阈值(均以厘米为单位)将聊天机器人能够感知到的每个对象归入“近旁”“有一段距离”或“很远”。默认值假定关卡为人类尺度;更大或更小的关卡需要不同的数值。

1

设置近距离

近距离 (NearbyDistance,默认 1000.0 ) 是上限,低于该值时对象会被判定为“近旁”。将其设置为大致相当于关卡中的角色应把某物视为伸手可及或几步之遥的范围。

2

设置中距离

中等距离 (ModerateDistance,默认 4000.0 ) 是上限,低于该值时对象会被判定为“有一段距离”。超过它后,对象会被判定为“很远”。保持 ModerateDistance 大于 NearbyDistance ——系统不会替你强制这种顺序。

这两个距离都具有编辑条件 bEnableSpatialAwareness,因此在总开关打开之前它们会呈灰色。

确认聊天机器人已设置为接收周围环境

上面的项目设置决定空间系统计算什么;每个聊天机器人自身的偏好决定它实际接收什么。

1

选择聊天机器人的 Convai Chatbot 组件

在角色 Blueprint 或关卡 Actor 中,选择 UConvaiChatbotComponent.

2

确认 Receive Surroundings 已开启

展开 Convai | 空间感知 (高级显示)并确认 bReceiveSurroundings 已勾选。默认情况下为 true。如果关闭,无论上面的项目设置如何,这个聊天机器人都不会接收周围环境事实。

验证角色接收到的内容

进入播放模式,打开 Convai 调试覆盖层 使用 Ctrl+Alt+K,并选择聊天机器人。

查看 周围环境 面板中带有以下内容的对象 UConvaiObjectComponent 来自你的前置条件。其所在行会显示聊天机器人接收到的逐字句子——例如,“箱子就在附近,在你前方。”这是直接传递给 Convai 的精确文本,而不是摘要,因此它是确认你的距离分段调整是否产生了你期望措辞的最快方式。

有关叠加层显示的每个面板、图标和标签,请参阅 Convai Debug Overlay 参考.

下一步

空间感知的工作原理空间感知设置参考排查空间感知问题

最后更新于

这有帮助吗?