催泪喷雾器

用于接入催泪喷雾器并监听指向、扳机和喷射命中状态。

资源文件

项目	内容
分类	武器与喷射外设
最新资源	外设-催泪喷雾器v2.0.2.xobj
原始说明	外设-催泪喷雾器_文档.json
更新记录	更新记录.md
来源目录	通用外设/外设资源/外设-催泪喷雾器

使用前提

• 已将 外设-催泪喷雾器v2.0.2.xobj 导入课程工程。
• 已将催泪喷雾器绑定到对应参训人员，并准备可被指向和命中的训练目标。
• 已根据场景距离配置横向FOV、垂直FOV和深度，且已确定使用真实设备还是模拟设备。
• 课程中已规划指向提示、按下扳机和目标被喷射命中后的处理逻辑。

参数说明

属性栏提供模拟输入和识别范围配置。

参数	作用	推荐配置	注意事项
是否在试玩和实训端模拟该武器	允许在没有实体设备时模拟喷雾器操作。	调试时开启；接入真实设备后按实际输入方式设置。	模拟输入与真实设备输入并用时，注意避免重复触发。
横向FOV	设置识别区域的横向范围。	默认 2，根据实际识别范围调整。	图片未标明单位，应通过试玩确认边界。
垂直FOV	设置识别区域的垂直范围。	默认 2，根据实际识别范围调整。	图片未标明单位，应与横向FOV配合调试。
深度	设置识别区域的纵深范围。	默认 5，根据使用距离调整。	数值过小可能无法识别，过大可能扩大误识别范围。

监听事件

事件	触发条件	典型用途
指向并按下	指定的参训人员使用催泪器指向任意实体并按下扳机时触发。	判断外设瞄准目标并完成喷射操作。
指向	指定的参训人员使用催泪器指向任意实体时触发。	判断外设瞄准目标或进入操作条件。
*被命中	任意实体被特效粒子碰撞到时触发。	判断喷射或攻击是否作用到目标实体。
*按下扳机	指定的实体按下扳机时触发。	触发操作计分、提示或后续课程逻辑。

可执行行为

原始说明未提供可执行的实体内部行为。

使用步骤

1. 导入资源并将喷雾器绑定到实际使用者。
2. 调整横向FOV、垂直FOV和深度，使识别范围覆盖预期喷射距离但不过度扩大。
3. 使用“指向”事件显示目标提示，使用“指向并按下”或“按下扳机”事件判断喷射操作。
4. 在需要响应喷射效果的目标上连接“被命中”事件及后续状态、评分或提示。
5. 使用真实设备和课程目标完整测试对准、按压、命中和离开识别范围的过程。

常见问题

问题	建议
指向事件过早或过晚触发。	根据现场距离调整横向FOV、垂直FOV和深度，并在范围边缘反复测试。
按下扳机没有进入喷射逻辑。	检查喷雾器与参训人员绑定，以及事件中选择的实体是否与实际使用者一致。
目标未触发“被命中”。	确认目标位于特效粒子路径上，并检查逻辑监听的目标实体是否正确。