Joywayer
e879efaa89
- Created a new markdown file detailing the configuration of InputDeviceIconSetSO. - Included sections on system architecture, field explanations, image specifications, and complete workflow from setup to runtime. - Documented the automatic device recognition logic and provided troubleshooting for common issues. - Added references to relevant files and scripts for easier navigation.
385 lines
19 KiB
Markdown
385 lines
19 KiB
Markdown
# InputDeviceIconSetSO 配置指南
|
||
|
||
**配置文件**：`Assets/_Game/Data/UI/InputIcons/ICN_*.asset`
|
||
**对应脚本**：`InputDeviceIconSetSO.cs` · `InputIconService.cs` · `InputDeviceDetector.cs`
|
||
**创建工具**：Unity 菜单 `BaseGames/Input Icon Studio` 或 Inspector 自定义编辑器
|
||
**影响系统**：`InputIconService` · `InteractPromptWidget` · `InputDeviceIconSwitcher` · `InputIconImage`
|
||
|
||
---
|
||
|
||
## 一、系统架构概述
|
||
|
||
```
|
||
InputDeviceDetector （挂在 UIRoot）
|
||
│ 侦听底层输入事件，识别当前设备类型
|
||
│ 广播 InputDeviceTypeEventChannelSO
|
||
▼
|
||
InputIconService （挂在 UIRoot，IInputIconService 实现）
|
||
│ 订阅设备切换事件，切换当前图标集
|
||
│ 订阅 InputSystem.onActionChange，改键后刷新
|
||
│ SerializeField 直接持有 4 套 InputDeviceIconSetSO 引用
|
||
│
|
||
├── _kbMouseSet → ICN_KeyboardMouse.asset
|
||
├── _xboxSet → ICN_Xbox.asset
|
||
├── _playStationSet → ICN_PlayStation.asset
|
||
└── _switchSet → ICN_Switch.asset
|
||
│
|
||
▼
|
||
InputDeviceIconSetSO
|
||
├── _deviceType （编辑器标识，匹配工具过滤）
|
||
└── _entries[] （绑定路径 → Sprite 的映射表）
|
||
│
|
||
▼
|
||
GetIcon(bindingPath) → Sprite?
|
||
|
||
UI 消费层
|
||
├── InteractPromptWidget 按键提示 HUD 组件
|
||
├── InputDeviceIconSwitcher 静态 Sprite 切换（不随改键变化）
|
||
└── InputIconImage 动态图标（支持 ByActionName 模式，随改键自动刷新）
|
||
```
|
||
|
||
**核心原则**：
|
||
`InputDeviceIconSetSO` 是**纯数据容器**，本身无运行时逻辑；查询、缓存、刷新均由 `InputIconService` 负责。每套 SO 对应一个输入设备，相互独立，方便美术分别维护。
|
||
|
||
---
|
||
|
||
## 二、InputDeviceIconSetSO 字段详解
|
||
|
||
### 2.1 顶层字段
|
||
|
||
| 字段 | 类型 | 序列化名 | 说明 |
|
||
|------|------|---------|------|
|
||
| Device Type | `InputDeviceType` 枚举 | `_deviceType` | 标识本图标集对应的设备类型。**不影响运行时选择逻辑**（选择由 `InputIconService` 按字段引用决定），但供编辑器工具（Input Icon Studio）过滤、分组显示。 |
|
||
| Entries | `IconEntry[]` 数组 | `_entries` | 全部绑定路径与图标的映射表，核心数据。数组顺序不影响查询结果（逐项遍历大小写不敏感匹配）。 |
|
||
|
||
### 2.2 IconEntry 结构体字段
|
||
|
||
每个 `IconEntry` 表示"当玩家的某个按键绑定在 `BindingPath` 时，应显示 `Icon` 这张图标"。
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| `BindingPath` | `string` | Unity InputSystem 的**绑定路径**（Binding Path），格式为 `<设备类型>/<控件路径>`。例：`<Keyboard>/e`、`<Gamepad>/buttonSouth`。**查询时大小写不敏感**。 |
|
||
| `Icon` | `Sprite` | 对应此绑定路径的按键图标。若为 `null`，`GetIcon()` 返回 `null`，UI 组件通常将图标区域隐藏。 |
|
||
|
||
> **⚠ 重要**：`BindingPath` 是玩家**当前实际绑定**的路径（含改键 `effectivePath`）。若玩家把「交互键」从 `<Keyboard>/e` 改到 `<Keyboard>/f`，系统查询的是 `<Keyboard>/f`，因此图标集中**需要包含全部玩家可能绑到的按键**，否则改键后图标显示为空。
|
||
|
||
---
|
||
|
||
## 三、Device Type 枚举说明
|
||
|
||
| 枚举值 | 含义 | 对应 InputIconService 字段 |
|
||
|--------|------|--------------------------|
|
||
| `KeyboardMouse` | 键盘 + 鼠标 | `_kbMouseSet` |
|
||
| `XboxController` | Xbox 手柄（XInput）、PC 通用手柄 | `_xboxSet` |
|
||
| `PlayStationController` | PS4 DualShock 4 / PS5 DualSense | `_playStationSet` |
|
||
| `SwitchController` | Switch Pro Controller / Joy-Con | `_switchSet` |
|
||
|
||
`InputDeviceDetector` 通过 `InputSystem.IsFirstLayoutBasedOnSecond` 检测布局层次来精确识别设备类型：
|
||
- DualShockGamepad / DualSenseGamepad → `PlayStationController`
|
||
- XInputController → `XboxController`
|
||
- 其他未知手柄 → 默认 `XboxController`（Xbox 图标最通用）
|
||
|
||
---
|
||
|
||
## 四、BindingPath 完整参考表
|
||
|
||
### 4.1 键鼠（KeyboardMouse）— 常用按键路径
|
||
|
||
| 按键 | BindingPath | 常见用途 |
|
||
|------|-------------|---------|
|
||
| E 键 | `<Keyboard>/e` | 交互（Interact） |
|
||
| F 键 | `<Keyboard>/f` | 备用交互 / 拾取 |
|
||
| R 键 | `<Keyboard>/r` | 技能 / 法术 |
|
||
| 空格 | `<Keyboard>/space` | 跳跃（Jump） |
|
||
| 左 Shift | `<Keyboard>/leftShift` | 冲刺（Dash）/ 行走 |
|
||
| 左 Ctrl | `<Keyboard>/leftCtrl` | 下蹲 |
|
||
| Q 键 | `<Keyboard>/q` | 技能槽 1 |
|
||
| 1-4 数字键 | `<Keyboard>/1` … `<Keyboard>/4` | 技能快捷栏 |
|
||
| Tab 键 | `<Keyboard>/tab` | 地图 / 物品栏 |
|
||
| Esc 键 | `<Keyboard>/escape` | 暂停菜单 |
|
||
| 鼠标左键 | `<Mouse>/leftButton` | 攻击（Attack） |
|
||
| 鼠标右键 | `<Mouse>/rightButton` | 格挡 / 瞄准 |
|
||
| 鼠标中键 | `<Mouse>/middleButton` | 特殊技能 |
|
||
| 鼠标滚轮上 | `<Mouse>/scroll/up` | 切换武器 / 技能 |
|
||
| 鼠标滚轮下 | `<Mouse>/scroll/down` | 切换武器 / 技能 |
|
||
|
||
> 完整键盘路径参考 Unity InputSystem 文档：[Keyboard Control Path](https://docs.unity3d.com/Packages/com.unity.inputsystem@latest/index.html?subfolder=/manual/Controls.html)
|
||
|
||
### 4.2 Xbox 手柄（XboxController）— 全按键路径
|
||
|
||
| 按键名称 | BindingPath | 说明 |
|
||
|---------|-------------|------|
|
||
| A 键（南键） | `<Gamepad>/buttonSouth` | 跳跃 / 确认 |
|
||
| B 键（东键） | `<Gamepad>/buttonEast` | 冲刺 / 取消 |
|
||
| X 键（西键） | `<Gamepad>/buttonWest` | 攻击 / 交互 |
|
||
| Y 键（北键） | `<Gamepad>/buttonNorth` | 技能 / 特殊 |
|
||
| LB（左肩键） | `<Gamepad>/leftShoulder` | 格挡 / 切换 |
|
||
| RB（右肩键） | `<Gamepad>/rightShoulder` | 技能槽 / 切换 |
|
||
| LT（左扳机） | `<Gamepad>/leftTrigger` | 蓄力攻击 / 瞄准 |
|
||
| RT（右扳机） | `<Gamepad>/rightTrigger` | 攻击 / 确认大招 |
|
||
| 左摇杆按下 | `<Gamepad>/leftStickButton` | 冲刺（长按） |
|
||
| 右摇杆按下 | `<Gamepad>/rightStickButton` | 锁定目标 |
|
||
| Select（菜单左） | `<Gamepad>/select` | 物品栏 |
|
||
| Start（菜单右） | `<Gamepad>/start` | 暂停菜单 |
|
||
| 十字键上 | `<Gamepad>/dpad/up` | 上方向 / 选择 |
|
||
| 十字键下 | `<Gamepad>/dpad/down` | 下方向 / 选择 |
|
||
| 十字键左 | `<Gamepad>/dpad/left` | 左方向 / 选择 |
|
||
| 十字键右 | `<Gamepad>/dpad/right` | 右方向 / 选择 |
|
||
| 左摇杆（上） | `<Gamepad>/leftStick/up` | 移动（上） |
|
||
| 左摇杆（下） | `<Gamepad>/leftStick/down` | 移动（下） |
|
||
|
||
### 4.3 PlayStation 手柄
|
||
|
||
PS 手柄的**面板按键路径与 Xbox 完全相同**（`buttonSouth/East/West/North`）。底层 InputSystem 通过布局映射统一了方向标识：
|
||
|
||
| 逻辑路径 | Xbox 对应 | PlayStation 对应 |
|
||
|---------|----------|----------------|
|
||
| `buttonSouth` | A | ✕ Cross |
|
||
| `buttonEast` | B | ○ Circle |
|
||
| `buttonWest` | X | □ Square |
|
||
| `buttonNorth` | Y | △ Triangle |
|
||
| `leftShoulder` | LB | L1 |
|
||
| `rightShoulder` | RB | R1 |
|
||
| `leftTrigger` | LT | L2 |
|
||
| `rightTrigger` | RT | R2 |
|
||
| `select` | Select / View | Share / Create |
|
||
| `start` | Start / Menu | Options |
|
||
|
||
> **关键设计点**：XboxController 和 PlayStationController 共享相同的 `BindingPath` 字符串，各自在**不同的 `InputDeviceIconSetSO`** 中映射到对应视觉风格的按键图标（Xbox 用圆形彩色图标，PS 用特殊符号图标），由 `InputIconService` 根据当前设备选择哪套 SO。
|
||
|
||
### 4.4 Switch 手柄
|
||
|
||
Switch Pro Controller 路径与 Xbox/PS 相同，面板按键按 Nintendo 习惯排列：
|
||
|
||
| 逻辑路径 | Switch 对应 |
|
||
|---------|------------|
|
||
| `buttonSouth` | B |
|
||
| `buttonEast` | A |
|
||
| `buttonWest` | Y |
|
||
| `buttonNorth` | X |
|
||
| `leftShoulder` | L |
|
||
| `rightShoulder` | R |
|
||
| `leftTrigger` | ZL |
|
||
| `rightTrigger` | ZR |
|
||
| `select` | - |
|
||
| `start` | + |
|
||
|
||
> ⚠ **Switch 按键位置与 Xbox/PS 习惯相反**（南键是 B 不是 A），美术制作图标时需注意：
|
||
> `buttonSouth` 图标应画 **B**（而非 A），`buttonEast` 图标应画 **A**（而非 B）。
|
||
|
||
---
|
||
|
||
## 五、图片（Sprite）规格要求
|
||
|
||
### 5.1 推荐尺寸
|
||
|
||
| 用途 | 推荐尺寸 | 说明 |
|
||
|------|---------|------|
|
||
| 标准按键图标（HUD/提示 UI） | **32×32 px** | InteractPromptWidget 默认显示尺寸，32px 在像素风格下清晰无锯齿 |
|
||
| 高分辨率版本（设置界面、教程） | **64×64 px** | 用于放大显示的场合，需额外维护一套 |
|
||
| 复合按键图标（LT+RT、双摇杆） | **48×24 px** 或 **64×32 px** | 横向组合按键，宽高比 2:1 |
|
||
|
||
### 5.2 Import Settings（Unity Inspector）
|
||
|
||
| 设置项 | 推荐值 | 说明 |
|
||
|-------|-------|------|
|
||
| Texture Type | `Sprite (2D and UI)` | 必须设置为 Sprite 类型，否则无法拖入 ObjectField |
|
||
| Sprite Mode | `Single` | 每个按键一张独立图片，避免拆分 |
|
||
| Pixels Per Unit | `32` | 与项目统一 PPU，1 像素 = 1/32 unit |
|
||
| Filter Mode | `Point (no filter)` | 像素风格固定值，避免双线性插值导致模糊 |
|
||
| Compression | `None`（开发），发布时 `ASTC 6x6`（移动端）| UI 图标质量要求高，开发期不压缩 |
|
||
| Generate Mip Maps | `关闭` | 2D UI 不需要 Mip Maps |
|
||
| Read/Write Enabled | `关闭` | 不需要像素读写 |
|
||
| Max Size | `128` | 32px 图标不需要超过 128 |
|
||
| Wrap Mode | `Clamp` | 避免边缘溢出 |
|
||
|
||
### 5.3 美术风格规范
|
||
|
||
| 规范项 | 说明 |
|
||
|-------|------|
|
||
| **背景透明** | 必须使用 PNG 格式，透明通道保存完整，不要有白色/黑色底边 |
|
||
| **视觉安全区** | 图标主体保留 2px 内边距，避免内容贴近边缘被裁剪 |
|
||
| **明度/对比度** | 图标应在深色（`rgba(0,0,0,0.85)`）背景上清晰可见；避免使用纯黑色线条（改用深灰 `#222`） |
|
||
| **键鼠图标风格** | 偏向拟物，键盘按键绘制带圆角的方形按键轮廓，鼠标按键绘制鼠标轮廓 |
|
||
| **手柄图标风格** | 手柄按键使用品牌标准配色：Xbox（A=绿、B=红、X=蓝、Y=黄），PS（✕=蓝、○=红、□=粉、△=绿），Switch 使用黑底圆形字母 |
|
||
| **一致性** | 同一设备下所有图标使用相同的线条粗细、阴影效果、发光效果 |
|
||
|
||
### 5.4 文件命名规范
|
||
|
||
格式：`IC_Key_{DeviceShort}_{KeyName}.png`
|
||
|
||
| 示例路径 | 对应按键 |
|
||
|---------|---------|
|
||
| `_Game/Art/UI/Icons/InputKeys/IC_Key_KBM_E.png` | 键盘 E 键 |
|
||
| `_Game/Art/UI/Icons/InputKeys/IC_Key_KBM_Space.png` | 键盘空格键 |
|
||
| `_Game/Art/UI/Icons/InputKeys/IC_Key_KBM_LMB.png` | 鼠标左键 |
|
||
| `_Game/Art/UI/Icons/InputKeys/IC_Key_KBM_RMB.png` | 鼠标右键 |
|
||
| `_Game/Art/UI/Icons/InputKeys/IC_Key_Xbox_A.png` | Xbox A 键 |
|
||
| `_Game/Art/UI/Icons/InputKeys/IC_Key_Xbox_RT.png` | Xbox RT 扳机 |
|
||
| `_Game/Art/UI/Icons/InputKeys/IC_Key_PS_Cross.png` | PS ✕ 键 |
|
||
| `_Game/Art/UI/Icons/InputKeys/IC_Key_PS_R2.png` | PS R2 扳机 |
|
||
| `_Game/Art/UI/Icons/InputKeys/IC_Key_Switch_B.png` | Switch B 键（南键） |
|
||
| `_Game/Art/UI/Icons/InputKeys/IC_Key_Switch_ZR.png` | Switch ZR 扳机 |
|
||
|
||
---
|
||
|
||
## 六、InputIconService 绑定配置
|
||
|
||
`InputIconService` 是图标集的运行时持有者，挂载在 Persistent 场景的 UIRoot 上。其 Inspector 字段：
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| `_inputReader` | `InputReaderSO` | 用于查询 Action 的绑定路径（`GetActionEffectivePath`） |
|
||
| `_kbMouseSet` | `InputDeviceIconSetSO` | **键鼠图标集**，当检测到键盘/鼠标输入时激活 |
|
||
| `_xboxSet` | `InputDeviceIconSetSO` | **Xbox 图标集**，检测到 XInput 手柄时激活；未配置时自动 fallback 至 `_kbMouseSet` |
|
||
| `_playStationSet` | `InputDeviceIconSetSO` | **PlayStation 图标集**，检测到 DualShock/DualSense 时激活；未配置时 fallback 至 `_kbMouseSet` |
|
||
| `_switchSet` | `InputDeviceIconSetSO` | **Switch 图标集**，检测到 Switch Pro/Joy-Con 时激活；未配置时 fallback 至 `_kbMouseSet` |
|
||
| `_onDeviceChanged` | `InputDeviceTypeEventChannelSO` | 设备切换事件频道（`EVT_InputDeviceChanged.asset`），与 `InputDeviceDetector` 共用 |
|
||
|
||
> **Fallback 策略**：若对应设备图标集为 `null`，自动 fallback 至键鼠集。这意味着开发初期只配置 `_kbMouseSet` 即可正常运行，手柄图标集可后续补充，不影响功能。
|
||
|
||
---
|
||
|
||
## 七、UI 消费组件说明
|
||
|
||
### 7.1 InteractPromptWidget（按键提示 HUD）
|
||
|
||
| 配置项 | 说明 |
|
||
|-------|------|
|
||
| `_promptChannel` | 引用 `InteractPromptEventChannelSO`，订阅 `InteractableDetector` 的广播 |
|
||
| 显示逻辑 | 收到事件后查询 `IInputIconService.GetActionIcon(actionName)`，设置图标 Sprite；若图标为 `null` 则隐藏图标容器，仅显示文字 |
|
||
| 刷新时机 | 设备切换（`OnIconSetChanged`）、改键（`BoundControlsChanged`）时自动重绘 |
|
||
|
||
### 7.2 InputIconImage（动态图标 Image 组件）
|
||
|
||
`InputIconImage` 是挂载在任意 `Image` 组件旁的辅助脚本，通过 `ServiceLocator` 获取 `IInputIconService`，支持两种工作模式：
|
||
|
||
| LookupMode | 说明 |
|
||
|-----------|------|
|
||
| `ByActionName` | **推荐**。指定 Action 名称（如 `"Interact"`、`"Jump"`），自动查询当前设备+改键后的有效图标 |
|
||
| `ByBindingPath` | 固定路径，不随改键变化。适用于「始终显示空格键图标」等特定场景 |
|
||
|
||
### 7.3 InputDeviceIconSwitcher（静态图标切换）
|
||
|
||
| 字段 | 说明 |
|
||
|------|------|
|
||
| `_kbmSprite` | 键鼠时显示的 Sprite |
|
||
| `_xboxSprite` | Xbox 手柄时显示的 Sprite |
|
||
| `_psSprite` | PS 手柄时显示的 Sprite |
|
||
| `_switchSprite` | Switch 手柄时显示的 Sprite |
|
||
|
||
适用于「图标固定、仅需在设备间切换整套外观」的场景（如教程截图、设置界面设备标识）。
|
||
**不支持改键响应**，如需改键后自动更新请用 `InputIconImage`（ByActionName 模式）。
|
||
|
||
---
|
||
|
||
## 八、完整配置工作流
|
||
|
||
### 8.1 快速开始（最小可用配置）
|
||
|
||
```
|
||
1. 准备图片
|
||
放入 _Game/Art/UI/Icons/InputKeys/
|
||
至少准备以下按键（根据实际绑定按需增删）：
|
||
键鼠：IC_Key_KBM_E.png（交互）、IC_Key_KBM_Space.png（跳跃）、IC_Key_KBM_LMB.png（攻击）
|
||
Xbox：IC_Key_Xbox_X.png（交互）、IC_Key_Xbox_A.png（跳跃）、IC_Key_Xbox_RT.png（攻击）
|
||
|
||
2. 创建图标集 SO
|
||
菜单 BaseGames/Input Icon Studio → 选择键鼠标签页 → 点击「指定图标集」→「新建...」
|
||
保存至 _Game/Data/UI/InputIcons/ICN_KeyboardMouse.asset
|
||
重复创建 ICN_Xbox.asset
|
||
|
||
3. 填充映射
|
||
在 Input Icon Studio 中：
|
||
a. 左侧选中 Action（如 Interact）
|
||
b. 右侧确认 BindingPath（如 <Keyboard>/e）
|
||
c. 将 IC_Key_KBM_E.png 拖入 Sprite 字段
|
||
d. 切换到 Xbox 标签，重复上述步骤
|
||
|
||
4. 绑定到 InputIconService
|
||
在 Persistent 场景 UIRoot → InputIconService Inspector 中：
|
||
将 ICN_KeyboardMouse.asset 拖入 _kbMouseSet 字段
|
||
将 ICN_Xbox.asset 拖入 _xboxSet 字段
|
||
|
||
5. 验证
|
||
进入 PlayMode → 按 E 键 → 观察 HUD 交互提示出现键盘图标
|
||
连接手柄 → 观察图标自动切换为 Xbox 图标
|
||
```
|
||
|
||
### 8.2 批量填充工作流（大量按键）
|
||
|
||
```
|
||
1. 在 ICN_KeyboardMouse.asset 的 Inspector 中：
|
||
点击「从 Action Asset 填充路径」
|
||
→ 自动为 Gameplay ActionMap 中所有 Keyboard&Mouse 绑定生成 Entry（路径已填入，Icon 为空）
|
||
|
||
2. 将对应 Sprite 批量拖入各 Entry 的 Icon 字段
|
||
（可用 Input Icon Studio 左列的覆盖率指示点确认进度）
|
||
|
||
3. 在 Input Icon Studio 查看总覆盖率：
|
||
标签栏显示 "🖱 键鼠 N/N" — N/N 表示全部配置完成
|
||
```
|
||
|
||
### 8.3 改键适配说明
|
||
|
||
**图标集应包含玩家可能绑定到的所有按键**，而非仅包含默认绑定。
|
||
|
||
例如交互键默认为 `<Keyboard>/e`，若玩家将其改为 `<Keyboard>/f`，系统查询 `<Keyboard>/f`，图标集中需有该条目才能正确显示。
|
||
|
||
**推荐策略**：为键盘图标集预填充全部 26 个字母键 + 常用功能键，为手柄图标集预填充所有面板按键和扳机键。
|
||
|
||
---
|
||
|
||
## 九、调试与常见问题排查
|
||
|
||
| 现象 | 原因 | 解决方案 |
|
||
|------|------|---------|
|
||
| 图标区域不显示（空白/隐藏） | `BindingPath` 未在图标集中找到匹配条目 | 在 Input Icon Studio 确认该 Action 当前绑定路径，并在图标集中添加对应条目 |
|
||
| 切换设备后图标没有变化 | `InputDeviceDetector` 或 `InputIconService` 未在场景中激活 | 确认 Persistent 场景 UIRoot 上挂载了两个组件，且 `_onDeviceChanged` 字段引用正确 |
|
||
| 改键后图标仍显示旧按键 | 使用的是 `InputDeviceIconSwitcher` 而非 `InputIconImage(ByActionName)` | 改用 `InputIconImage` 组件并设置 `LookupMode = ByActionName` |
|
||
| 所有设备均显示键鼠图标 | 手柄图标集字段为 null，触发了 fallback 逻辑 | 在 InputIconService Inspector 中为手柄字段指定对应 SO |
|
||
| 图标显示模糊 | Import Settings 的 Filter Mode 不正确 | 将所有按键图标的 Filter Mode 改为 `Point (no filter)` |
|
||
| 图标有白色边缘 | 导出时 PNG 透明通道处理不正确 | 用 Photoshop/Aseprite 重新导出，确保「直接 Alpha」（Straight Alpha）而非预乘 Alpha |
|
||
| 手柄图标显示 Xbox 风格，但玩家用的是 PS 手柄 | `InputDeviceDetector` 未能识别 DualShock 布局 | 确保 Input System 包含 PS 设备支持（`com.unity.inputsystem` ≥ 1.4），并在 Player Settings 中勾选 DualShock 支持 |
|
||
| Input Icon Studio 左列 Action 为空 | `InputReaderSO` 未填入，或 `_inputActions` 字段名不匹配 | 在工具栏 InputReaderSO 字段指定资产；若字段名有变更，同步更新 `InputIconStudioWindow.ReloadActionAsset()` 中的 `FindProperty("_inputActions")` |
|
||
|
||
---
|
||
|
||
## 十、推荐图标集最小条目清单
|
||
|
||
以下是按项目实际 Gameplay ActionMap 中的 Actions 推荐配置的最小图标集。
|
||
|
||
### 10.1 键鼠图标集 — ICN_KeyboardMouse
|
||
|
||
| Action 名称 | 默认 BindingPath | 建议图标 |
|
||
|------------|-----------------|---------|
|
||
| Move（上） | `<Keyboard>/w` | W键图标 |
|
||
| Move（下） | `<Keyboard>/s` | S键图标 |
|
||
| Move（左） | `<Keyboard>/a` | A键图标 |
|
||
| Move（右） | `<Keyboard>/d` | D键图标 |
|
||
| Jump | `<Keyboard>/space` | 空格键图标 |
|
||
| Dash | `<Keyboard>/leftShift` | Shift键图标 |
|
||
| Attack | `<Mouse>/leftButton` | 鼠标左键图标 |
|
||
| Interact | `<Keyboard>/e` | E键图标 |
|
||
| Map | `<Keyboard>/m` | M键图标 |
|
||
| Pause | `<Keyboard>/escape` | Esc键图标 |
|
||
|
||
### 10.2 Xbox 手柄图标集 — ICN_Xbox
|
||
|
||
| Action 名称 | BindingPath | 建议图标 |
|
||
|------------|-------------|---------|
|
||
| Jump | `<Gamepad>/buttonSouth` | A键图标（绿） |
|
||
| Dash | `<Gamepad>/buttonEast` | B键图标（红） |
|
||
| Attack | `<Gamepad>/rightTrigger` | RT图标 |
|
||
| Interact | `<Gamepad>/buttonWest` | X键图标（蓝） |
|
||
| Map | `<Gamepad>/select` | View/Select图标 |
|
||
| Pause | `<Gamepad>/start` | Menu/Start图标 |
|
||
|
||
---
|
||
|
||
## 十一、修改历史
|
||
|
||
| 日期 | 修改内容 |
|
||
|------|---------|
|
||
| 2026-05-22 | 初版：完整字段说明、BindingPath 参考表、图片规格要求、工作流及排查指南 |
|