参训人员统计判断

参训人员统计判断用于统计当前参训人员数量，并与指定课程参数进行比较。它也可以判断参训人员中是否包含指定角色，或把参训人数写入课程参数，适合多人协同、角色校验和人数门槛判断。

资源文件

项目	内容
分类	数据统计和判断
最新资源	参训人员统计判断-v1.0.xobj
原始说明	参训人员统计判断-v1.0_文档.txt
来源目录	00 通用/数据统计和判断/参训人员统计判断

使用前提

• 课程中已经配置参训人员和角色。
• 需要比对人数时，先准备好用于存储人数阈值的课程参数。
• 需要判断角色时，确认角色名称与课程内实际角色一致。

参数说明

属性栏中配置用于人数比对的课程参数，以及是否显示调试信息。

参数	作用	推荐配置	注意事项
判断的课程参数名	指定用于和参训人员数量进行比较的课程参数。	填写保存目标人数的课程参数名，例如 NeedTraineeCount。	参数值应为可比较的数字，否则人数判断可能不符合预期。
是否显示参训人员数量和参数值	控制是否显示调试信息。	调试编排时开启，正式训练时关闭。	开启后便于核对当前人数和课程参数值，但可能影响正式呈现。

监听事件

监听事件用于接收人数比对和角色检查的判断结果。

事件	触发条件	典型用途
课程参数和参训人员数量相等	执行人数检查后，课程参数值等于当前参训人数。	满足开课、分组或协同人数条件。
课程参数和参训人员数量不相等	执行人数检查后，课程参数值不等于当前参训人数。	提示人数不足或人数不匹配。
参训人员包括角色*	执行角色检查后，参训人员中包含指定角色。	判断是否存在指挥员、操作员等必要角色。

可执行行为

执行行为用于主动检查人数、检查角色，或把当前参训人数保存到课程参数。

行为	效果	常见调用时机
检查课程参数是否等于参训人员人数	读取当前参训人数并与指定课程参数比较。	进入训练前、开始协同任务前。
检查参训人员包括的角色	判断当前参训人员中是否包含指定角色。	角色分工确认、权限判断。
将参训人数保存到*	把当前参训人数写入指定课程参数。	后续逻辑需要复用当前人数时。

使用步骤

1. 将资源导入课程工程。
2. 在属性栏中填写“判断的课程参数名”。
3. 调试阶段按需开启参训人员数量显示。
4. 在逻辑元中执行人数检查、角色检查或人数保存行为。
5. 监听对应事件，进入人数满足或不满足的后续流程。

常见问题

问题	建议
人数判断结果不对。	检查课程参数值是否为目标人数，并确认当前参训人员已加入训练。
角色判断没有触发。	确认星号替换为实际角色名称。
正式课程中出现调试信息。	关闭“是否显示参训人员数量和参数值”。