SirenX 催泪喷雾器

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

资源文件

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

使用前提

• 已将 外设-SirenX催泪喷雾器v2.0.7.xobj 导入课程工程。
• 已将 SirenX 催泪喷雾器绑定到对应参训人员，并准备需要被指向或命中的目标实体。
• 已根据喷射距离确定横向FOV、垂直FOV和深度；接入真实设备时已关闭不需要的模拟输入。
• 课程逻辑已明确区分“指向”“指向并按下”“按下扳机”和“被命中”的使用场景。

参数说明

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

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

监听事件

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

可执行行为

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

使用步骤

1. 导入资源并把 SirenX 催泪喷雾器绑定到使用者。
2. 按实际训练距离配置横向FOV、垂直FOV和深度，并确定是否启用模拟设备。
3. 为瞄准提示连接“指向”事件，为实际喷射操作连接“指向并按下”或“按下扳机”事件。
4. 需要判断喷射是否作用于目标时，在目标实体上使用“被命中”事件连接评分或状态逻辑。
5. 从识别范围边缘、正常使用距离和非目标方向分别试玩，校准识别范围并排除误触发。

常见问题

问题	建议
喷雾器已经对准目标但没有触发。	检查参训人员和目标实体参数，并调整横向FOV、垂直FOV和深度。
只对准目标就触发了喷射逻辑。	确认逻辑连接的是“指向并按下”，而不是仅判断方向的“指向”。
喷射后目标没有收到“被命中”。	检查目标位置和特效粒子路径，并确认“被命中”事件配置在正确目标实体上。