触发实体存储和抛出
触发实体存储和抛出用于捕获全局事件中的触发实体 ID，并在后续通过全局事件重新抛出。它也支持自行指定触发实体，或查找距离指定实体最近的参训实体后抛出事件。资源抛出的全局事件会在接收事件名前增加“抛出-”前缀。
资源文件
| 项目 |
内容 |
| 分类 |
逻辑控制 |
| 最新资源 |
触发实体存储和抛出-v1.1.xobj |
| 原始说明 |
触发实体存储和抛出-v1.1_文档.txt |
| 来源目录 |
00 通用/逻辑控制/触发实体存储和抛出 |
使用前提
- 课程中存在需要捕获触发实体的全局事件。
- 后续逻辑需要复用该触发实体或替换为指定实体。
- 需要监听带“抛出-”前缀的新全局事件。
参数说明
| 参数 |
作用 |
推荐配置 |
注意事项 |
| 显示调试UI |
控制是否显示捕获到的事件和触发实体信息。 |
调试事件链路时开启，正式训练时关闭。 |
调试 UI 有助于确认触发实体来源，但正式训练中应关闭。 |
可执行行为
| 行为 |
效果 |
常见调用时机 |
| 开始捕获含触发对象的全局事件 |
开始记录全局事件中的触发实体。 |
进入需要追踪触发对象的阶段。 |
| 停止捕获全局事件 |
停止记录全局事件。 |
阶段结束或避免继续覆盖已存实体。 |
| 抛出事件* |
使用已捕获事件的触发实体抛出指定事件。 |
捕获到触发实体后，延迟转发或复用该实体。 |
| 抛出指定触发实体 |
使用自行指定的触发实体抛出事件。 |
不依赖捕获事件，直接指定对象进入后续逻辑。 |
| 抛出距离最近的参训实体 |
查找距离指定实体最近的参训实体并抛出全局事件。 |
需要把事件转交给最近学员或最近参训对象时。 |
使用步骤
- 将资源导入课程工程。
- 调试阶段开启调试 UI。
- 执行“开始捕获含触发对象的全局事件”。
- 在需要转发时执行“抛出事件*”。
- 如果不依赖捕获结果，可使用“抛出指定触发实体”。
- 如果要按距离选择参训实体，可使用“抛出距离最近的参训实体”。
- 阶段结束时执行“停止捕获全局事件”。
常见问题
| 问题 |
建议 |
| 抛出事件没有携带预期实体。 |
先确认已经开始捕获，并且被捕获的全局事件包含触发实体。 |
| 监听不到抛出的全局事件。 |
检查监听事件名是否加上“抛出-”前缀。 |
| 捕获实体被后续事件覆盖。 |
在捕获到目标事件后及时停止捕获，或使用指定触发实体行为。 |