长枪

用于接入长枪外设，监听设备识别状态并控制弹药与上膛状态。

资源文件

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

使用前提

• 已将 外设-长枪v2.0.2.xobj 导入课程工程。
• 已将长枪绑定到对应参训人员，并确认训练端能获取该武器的识别状态。
• 已确定课程初始弹药、弹匣容量、剩余弹匣和上膛状态，以及是否允许单发、连发和关闭保险操作。
• 使用模拟输入时，开火、上膛、弹匣、射击模式和保险键位已确认无冲突。

参数说明

属性栏提供模拟输入、状态面板、快捷键面板和长枪操作按键配置。

参数	作用	推荐配置	注意事项
是否在试玩和实训端模拟该设备	允许通过鼠标、键盘模拟长枪操作。	无实体枪械调试时开启；接入真实设备后按需关闭。	模拟输入与真实设备输入并用时，注意避免重复触发。
是否打开武器状态面板	控制是否显示长枪的武器状态信息。	调试时开启；正式课程按界面需求设置。	面板可能占用画面空间，应避免遮挡重要信息。
是否打开快捷键面板	控制是否显示长枪模拟快捷键。	调试时开启，正式训练时按需关闭。	仅影响快捷键提示面板。
长枪开火	设置模拟开火的按键。	默认 Mouse0。	使用鼠标左键操作时，注意避免与编辑或交互操作冲突。
长枪上膛	设置模拟上膛的按键。	默认 F1。	开火前应按课程规则确认上膛状态。
长枪上弹夹	设置模拟装入弹夹的按键。	默认 F2。	与卸弹夹按键分开配置。
长枪卸弹夹	设置模拟卸下弹夹的按键。	默认 F3。	卸下弹夹后应确认弹药状态事件符合预期。
长枪切换单发	设置切换到单发模式的模拟键。	默认 F4。	切换后应确认武器模式事件和开火效果。
长枪切换连发	设置切换到连发模式的模拟键。	默认 F5。	连发模式应结合课程安全规则测试。
长枪关闭保险	设置关闭保险的模拟键。	默认 F6。	关闭保险后武器可进入可射击状态，应按训练流程调用。

监听事件

事件	触发条件	典型用途
识别状态为	设置指定参训实体武器的识别状态时触发。	根据设备识别或佩戴状态控制训练流程。

可执行行为

行为	效果	常见调用时机
设置武器内子弹数为	设置指定参训实体武器的子弹数	初始化武器、补充弹药或切换武器状态时。
设置剩余弹匣数为	设置指定参训实体武器的弹匣数	初始化武器、补充弹药或切换武器状态时。
设置单个弹匣容量为	设置指定参训实体武器的弹匣容量	初始化武器、补充弹药或切换武器状态时。
设置上膛状态	设置指定参训实体武器的上膛状态	初始化武器、补充弹药或切换武器状态时。

使用步骤

1. 导入资源并将长枪绑定到实际使用者。
2. 配置模拟输入和面板显示，核对开火、上膛、弹匣、单发、连发和关闭保险的键位。
3. 在课程初始化阶段设置弹匣容量、剩余弹匣数、武器内子弹数和上膛状态。
4. 使用“识别状态为”事件判断长枪是否被正确识别，并连接训练准入、提示或评分逻辑。
5. 使用真实设备测试识别、装卸弹匣、上膛、保险、单发和连发操作，确认状态与课程规则一致。

常见问题

问题	建议
长枪已连接但识别状态没有变化。	检查设备是否绑定到事件中选择的参训人员，并确认训练端已识别该长枪。
开火时没有子弹或无法射击。	检查武器内子弹数、弹匣容量、剩余弹匣数和上膛状态，并确认保险状态符合射击条件。
单发、连发或保险操作不符合预期。	核对 F4、F5、F6 的映射，并在真实设备模式下关闭不需要的模拟输入。
状态面板与课程变量不同步。	检查是否有多组逻辑在不同时间重复设置武器状态，并明确唯一的初始化流程。