实体跟随控制

实体跟随控制用于让一组实体跟随某个目标实体移动，并保持编课时已经摆好的相对位置关系。它适合用在随动标识、组合道具、队列对象、观察目标附件等场景。

资源文件

项目	内容
分类	运动控制
可用版本	实体跟随控制-v1.2.xobj、实体跟随控制-v1.3.xobj
原始说明	实体跟随控制-v1.2_文档.txt
演示视频	实体跟随控制.mp4
测试课程	实体跟随控制测试课程.tar.gz
来源目录	00 通用/运动控制/实体跟随控制

使用前提

• 课程中已经存在一个目标实体。
• 已经摆放好需要跟随的实体，并确认它们与目标实体的初始相对位置。
• 如果希望跟随效果从某个流程节点才开始，应通过“开始跟随”行为触发，而不是让资源默认一直运行。

参数说明

参数	作用	推荐配置	注意事项
目标实体	被跟随的实体。	选择主目标、角色、车辆或移动参考点。	目标实体移动时，跟随实体会以它为参考更新。
跟随实体	需要跟随目标的一组实体。	选择所有需要保持队形或相对位置的对象。	不要把目标实体本身加入跟随实体列表。
相对坐标	是否保持或使用相对位置偏移。	需要保持编课摆放关系时开启。	原说明未写清具体取值，配置时需结合测试课程验证。
相对角度	是否保持或使用相对角度偏移。	跟随实体朝向也要随目标变化时开启。	如果只需要位置跟随，可先关闭角度跟随验证效果。

可执行行为

行为	效果	常见调用时机
开始跟随	启动跟随逻辑。	训练步骤开始、目标进入移动阶段。
停止跟随	停止跟随逻辑，实体保持停止时的位置。	训练步骤结束、需要固定对象位置。

使用步骤

1. 在场景中放置目标实体。
2. 放置所有跟随实体，并调整到希望保持的相对位置。
3. 导入资源并配置“目标实体”和“跟随实体”。
4. 根据需求配置相对坐标和相对角度。
5. 在流程开始处调用“开始跟随”。
6. 在流程结束或需要冻结位置时调用“停止跟随”。

示例流程

一个训练目标移动时，需要让提示牌和辅助模型始终跟随目标：

1. 把训练目标设置为“目标实体”。
2. 把提示牌、辅助模型设置为“跟随实体”。
3. 编课时把提示牌放在目标实体右侧，把辅助模型放在目标后方。
4. 开始训练后调用“开始跟随”，提示牌和辅助模型会跟随目标移动，并保持原来的相对关系。

常见问题

问题	建议
跟随实体位置不符合预期。	检查编课时的初始相对位置，资源会以初始关系作为跟随依据。
跟随实体朝向异常。	单独验证“相对角度”配置，确认是否需要跟随目标旋转。
进入课程后没有跟随。	确认流程中已经调用“开始跟随”。