霰弹枪

用于接入霰弹枪外设并控制武器弹药、弹匣容量和上膛状态。

资源文件

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

使用前提

• 已将 外设-霰弹枪v2.0.2.xobj 导入课程工程。
• 已将霰弹枪绑定到对应参训人员，并确定使用真实设备还是 XR 右手柄模拟操作。
• 已根据课程规则确定武器内子弹数、剩余弹匣数、单个弹匣容量和上膛状态。
• 该资源未提供可监听事件，课程应通过可执行行为初始化或调整武器状态，不应依赖本资源监听开火事件。

参数说明

属性栏提供模拟输入、状态面板、快捷键面板和 XR 手柄按键配置。

参数	作用	推荐配置	注意事项
是否在试玩和实训端模拟该设备	允许通过鼠标、键盘模拟霰弹枪操作。	无实体枪械调试时开启；接入真实设备后按需关闭。	模拟输入与真实设备输入并用时，注意避免重复触发。
是否打开武器状态面板	控制是否显示霰弹枪的武器状态信息。	调试时开启；正式课程按界面需求设置。	面板可能占用画面空间，应避免遮挡重要信息。
是否打开快捷键面板	控制是否显示霰弹枪模拟快捷键。	调试时开启，正式训练时按需关闭。	仅影响快捷键提示面板。
XR右手柄扳机键	设置模拟右手柄扳机操作的按键。	默认 Mouse0。	使用鼠标左键操作时，注意避免与编辑或交互操作冲突。
XR右手柄主按键	设置模拟右手柄主按键操作的按键。	默认 F1。	应在试玩中确认该按键对应的霰弹枪操作。

监听事件

原始说明未提供可监听的实体内部事件。

可执行行为

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

使用步骤

1. 导入资源并将霰弹枪绑定到实际使用者。
2. 确定是否使用模拟设备，并配置 XR 右手柄扳机键和主按键的模拟键位。
3. 在训练开始时设置弹匣容量、剩余弹匣数、武器内子弹数和上膛状态。
4. 在补给、重置或阶段切换逻辑中再次调用对应行为，更新霰弹枪状态。
5. 通过武器状态面板和实际操作检查弹药、弹匣及上膛状态；需要监听射击时使用课程中的其他射击事件来源。

常见问题

问题	建议
逻辑元中找不到霰弹枪事件。	该资源原始说明未提供监听事件，只提供设置弹药、弹匣容量、弹匣数和上膛状态的行为。
XR 右手柄操作没有反应。	检查是否启用模拟设备，以及扳机键和主按键映射是否与当前输入方式一致。
弹药或上膛状态不正确。	检查四个状态行为的参数和执行顺序，并确认阶段切换时没有被其他逻辑覆盖。