警棍

用于监听警棍按键与挥动动作，并控制挥动检测的开始和结束。

资源文件

项目	内容
分类	警用外设
最新资源	外设-警棍v2.0.7.xobj
原始说明	外设-警棍_文档.json
更新记录	更新记录.md
来源目录	通用外设/外设资源/外设-警棍

使用前提

• 已将 外设-警棍v2.0.7.xobj 导入课程工程。
• 已将警棍绑定到对应参训人员，并确认训练区域允许完成实际挥动动作。
• 课程已明确警棍挥动检测的开始和结束时机，避免在无关阶段持续监听。
• 如需监听警棍按键，已确认事件中的具体按键和操作类型与设备一致。

参数说明

原始说明未提供可编辑参数。

监听事件

事件	触发条件	典型用途
*完成挥动警棍	指定实体完成挥动警棍时触发。	判断警棍动作是否完成并进入处置流程。
对进行*	指定实体监听指定按键时触发。	触发操作计分、提示或后续课程逻辑。

可执行行为

行为	效果	常见调用时机
开始检测挥动警棍	开始检测挥动警棍操作，之后如果执行挥动警棍，才会发送事件	进入需要检测该动作的训练阶段时。
结束检测挥动警棍	结束检测挥动警棍操作	动作检测阶段结束或课程暂停时。

使用步骤

1. 导入资源并将警棍绑定到实际使用者。
2. 在需要识别挥动的训练阶段开始时调用“开始检测挥动警棍”。
3. 使用“完成挥动警棍”事件连接动作完成提示、计数或评分逻辑。
4. 如需响应警棍按键，另行配置“对指定按键进行操作”事件并填写实体、按键和操作类型。
5. 阶段结束时调用“结束检测挥动警棍”，再测试检测开启前、开启期间和结束后的事件状态。

常见问题

问题	建议
挥动警棍后没有触发完成事件。	确认在挥动前已执行“开始检测挥动警棍”，并检查警棍与参训人员的绑定。
训练阶段结束后仍然检测挥动。	在阶段结束、重置和退出分支中都调用“结束检测挥动警棍”。
按键操作没有触发。	检查事件中的实体、按键和按下/松开等操作类型是否与实际动作一致。
一次挥动被多次计数。	检查是否重复启动检测或重复连接完成事件，并在每轮动作后按课程需要结束检测。