短枪

用于接入短枪外设，监听识别、枪套和握枪状态，并控制弹药与上膛状态。

资源文件

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

使用前提

• 已将 外设-短枪v2.0.3.xobj 导入课程工程。
• 已将短枪及配套枪套绑定到对应参训人员，并确认训练端可获取武器识别、枪套和握枪状态。
• 已根据课程规则确定初始子弹数、剩余弹匣数、单个弹匣容量和上膛状态。
• 使用键鼠模拟时已确认开火、上膛、上弹夹和卸弹夹按键无冲突；使用真枪外设时应避免同时启用模拟输入。

参数说明

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

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

监听事件

事件	触发条件	典型用途
识别状态为	指定参训实体的短枪识别状态时触发。	根据设备识别或佩戴状态控制训练流程。
枪套检测状态为	指定参训实体的枪套检测状态时触发。	根据设备识别或佩戴状态控制训练流程。
握枪检测状态为	指定参训实体的握枪检测状态时触发。	根据设备识别或佩戴状态控制训练流程。

可执行行为

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

使用步骤

1. 导入资源并把短枪及枪套绑定到实际使用者。
2. 配置模拟输入、武器状态面板和快捷键面板，确认各操作键位符合调试习惯。
3. 在训练开始时依次设置弹匣容量、剩余弹匣数、武器内子弹数和上膛状态。
4. 按训练要求监听短枪识别状态、枪套检测状态和握枪检测状态，并连接规范检查或评分逻辑。
5. 完整测试取枪、握持、装弹夹、上膛、开火、卸弹夹和归还枪套的状态变化。

常见问题

问题	建议
取枪或归还枪套后状态没有变化。	检查短枪和枪套是否绑定到同一参训人员，并确认监听的是枪套检测状态。
已握枪但课程仍判定未握持。	检查握枪检测事件选择的参训实体，并使用真实握持姿态重新测试。
无法开火或弹药显示不正确。	检查子弹数、弹匣容量、剩余弹匣数和上膛状态的初始化顺序。
模拟开火重复触发。	检查真实设备输入与 Mouse0 模拟输入是否同时启用，以及开火逻辑是否重复连接。