126 lines
7.6 KiB
Markdown
126 lines
7.6 KiB
Markdown
|
## Reach UI 技术速查（常用脚本与用法）
|
|||
|
|
|
|||
|
|
目标：日后快速检索 Reach UI 常用脚本、Inspector 关键字段、以及与本项目集成时的注意事项。
|
|||
|
|
|
|||
|
|
本工程 Reach UI 根目录：
|
|||
|
|
- `Assets/ThirdParty/UI/Reach - Complete Sci-Fi UI`
|
|||
|
|
|
|||
|
|
### 一、常用脚本索引（按用途）
|
|||
|
|
|
|||
|
|
#### 1) 按钮（Button）
|
|||
|
|
- [ButtonManager.cs](file:///e:/Unity/Unity%20Program/Test_2022/Assets/ThirdParty/UI/Reach%20-%20Complete%20Sci-Fi%20UI/Scripts/UI%20Elements/ButtonManager.cs)
|
|||
|
|
- 用途：按钮交互、动画、状态（Normal/Highlighted/Disabled）、点击事件（UnityEvent）。
|
|||
|
|
- 常用点：
|
|||
|
|
- `onClick`：对接项目逻辑的主要入口（例如打开设置、开始游戏）。
|
|||
|
|
- `Interactable(bool)`：统一启用/禁用按钮（会走 Reach 的 Disabled 状态表现）。
|
|||
|
|
- `SetText(string)`：运行时改按钮文案（例如“正在加载/开始游戏”）。
|
|||
|
|
|
|||
|
|
#### 2) 下拉菜单（Dropdown）
|
|||
|
|
- [Dropdown.cs](file:///e:/Unity/Unity%20Program/Test_2022/Assets/ThirdParty/UI/Reach%20-%20Complete%20Sci-Fi%20UI/Scripts/UI%20Elements/Dropdown.cs)
|
|||
|
|
- 用途：带动画的下拉选项。
|
|||
|
|
- 关键概念：
|
|||
|
|
- `items`：选项列表（编辑器/脚本生成皆可）。
|
|||
|
|
- `Initialize()`：把 items 实例化成可点击的 ItemButton；若 items 变更后不调用，运行时可能出现空引用或显示不更新。
|
|||
|
|
- `SetDropdownIndex(int)`：设置选中项并刷新 Header Label。
|
|||
|
|
- `onValueChanged(int)`：选中项变化事件。
|
|||
|
|
- 常见坑：
|
|||
|
|
- 使用 Reach 的 “Settings Element (Dropdown)” 创建的样式，通常预置了占位 items（Dropdown Item 1..N）。若要运行时改成真实列表，需要先清空并重建 items，再 `Initialize()`。
|
|||
|
|
|
|||
|
|
#### 3) 滑条（Slider）
|
|||
|
|
- [SliderManager.cs](file:///e:/Unity/Unity%20Program/Test_2022/Assets/ThirdParty/UI/Reach%20-%20Complete%20Sci-Fi%20UI/Scripts/UI%20Elements/SliderManager.cs)
|
|||
|
|
- 用途：Slider + 数值显示（含百分比/取整等）。
|
|||
|
|
- 常用点：
|
|||
|
|
- `mainSlider`：Unity Slider（min/max/value 在这里设置）。
|
|||
|
|
- `useRoundValue`：是否取整。
|
|||
|
|
- `usePercent`：是否显示为百分比。
|
|||
|
|
- `onValueChanged(float)`：变化事件。
|
|||
|
|
|
|||
|
|
#### 4) 面板切换（Panel）
|
|||
|
|
- [PanelManager.cs](file:///e:/Unity/Unity%20Program/Test_2022/Assets/ThirdParty/UI/Reach%20-%20Complete%20Sci-Fi%20UI/Scripts/Panels/PanelManager.cs)
|
|||
|
|
- [PanelManagerEditor.cs](file:///e:/Unity/Unity%20Program/Test_2022/Assets/ThirdParty/UI/Reach%20-%20Complete%20Sci-Fi%20UI/Scripts/Panels/PanelManagerEditor.cs)
|
|||
|
|
- 用途：多面板切换、Panel In/Out 动画、可选的 Tab 按钮联动。
|
|||
|
|
- Inspector 特点：
|
|||
|
|
- 该组件使用自定义 Inspector（Content/Settings 页签），部分选项不在 Unity 默认字段列表里。
|
|||
|
|
- 常用 API：
|
|||
|
|
- `OpenPanel(string panelName)`
|
|||
|
|
- `OpenPanelByIndex(int index)`
|
|||
|
|
- `NextPanel()` / `PreviousPanel()`
|
|||
|
|
- `ShowCurrentPanel()` / `HideCurrentPanel()`
|
|||
|
|
- 常见坑：
|
|||
|
|
- PanelItem 的 `panelObject` 必须是带 Animator 的 Panel 根物体。
|
|||
|
|
- 动画模式（MainPanel/SubPanel）与 Animator 动画片段命名需匹配；优先使用 Prefab 默认模式。
|
|||
|
|
|
|||
|
|
#### 5) 热键事件（Hotkey）
|
|||
|
|
- [HotkeyEvent.cs](file:///e:/Unity/Unity%20Program/Test_2022/Assets/ThirdParty/UI/Reach%20-%20Complete%20Sci-Fi%20UI/Scripts/Events/HotkeyEvent.cs)
|
|||
|
|
- 用途：把一个按键（InputAction）映射到 UnityEvent（例如 ESC 关闭面板）。
|
|||
|
|
- 常见坑：
|
|||
|
|
- `InputAction` 的 Inspector 展示会受项目 Input System 设置影响；推荐从 Reach Demo 场景复制一个可工作的 HotkeyEvent 再改绑定。
|
|||
|
|
|
|||
|
|
#### 6) 设置行组件（Settings Element）
|
|||
|
|
- [SettingsElement.cs](file:///e:/Unity/Unity%20Program/Test_2022/Assets/ThirdParty/UI/Reach%20-%20Complete%20Sci-Fi%20UI/Scripts/UI%20Elements/SettingsElement.cs)
|
|||
|
|
- [SettingsSubElement.cs](file:///e:/Unity/Unity%20Program/Test_2022/Assets/ThirdParty/UI/Reach%20-%20Complete%20Sci-Fi%20UI/Scripts/UI%20Elements/SettingsSubElement.cs)
|
|||
|
|
- 用途：快速创建“设置行（标题 + 右侧控件）”风格 UI；项目里常用的是 `Settings Element (Dropdown)`。
|
|||
|
|
|
|||
|
|
#### 7) 图形设置示例（参考实现）
|
|||
|
|
- [GraphicsManager.cs](file:///e:/Unity/Unity%20Program/Test_2022/Assets/ThirdParty/UI/Reach%20-%20Complete%20Sci-Fi%20UI/Scripts/Rendering/GraphicsManager.cs)
|
|||
|
|
- 用途：Reach demo 的图形设置项（分辨率/VSync/帧率/纹理/各向异性等）的示例实现，可作为绑定 Dropdown/Slider 的参考。
|
|||
|
|
|
|||
|
|
### 二、本项目集成 Reach UI 的经验规则
|
|||
|
|
|
|||
|
|
#### 1) 不要删 Reach 控件的核心脚本
|
|||
|
|
- Button 的动画/状态主要由 `ButtonManager` 驱动。
|
|||
|
|
- Dropdown 的选项生成/显示由 `Dropdown.Initialize()` 管理。
|
|||
|
|
- Slider 的展示与事件由 `SliderManager` 管理。
|
|||
|
|
|
|||
|
|
#### 2) 下拉项修改后一定要 Initialize
|
|||
|
|
- 脚本重建 items 的标准步骤：
|
|||
|
|
- `dropdown.items.Clear()`
|
|||
|
|
- `dropdown.CreateNewItem(...)` 或直接填 items
|
|||
|
|
- `dropdown.Initialize()`
|
|||
|
|
- 再调用 `SetDropdownIndex(...)`
|
|||
|
|
|
|||
|
|
#### 3) “占位 Items”与“运行时重建”冲突的处理
|
|||
|
|
- 若你使用 `Settings Element (Dropdown)` 创建样式，会自带占位 items。
|
|||
|
|
- 若要运行时替换为真实列表，需要明确“由脚本接管 items”，避免编辑器占位项阻止重建。
|
|||
|
|
|
|||
|
|
#### 4) 布局与动画冲突（Button 尺寸问题）
|
|||
|
|
- Reach Button 经常带内部 Layout/Fitter，若放入 LayoutGroup 里尺寸异常，优先使用按钮脚本提供的开关（例如 auto-fit 相关选项），不要手动删组件。
|
|||
|
|
|
|||
|
|
### 三、Notification / Feed Notification（项目用法）
|
|||
|
|
|
|||
|
|
#### 1) 指向交互提示（项目集成）
|
|||
|
|
|
|||
|
|
项目已在玩家侧集成“指向可交互目标时弹出提示”的逻辑，入口位于：
|
|||
|
|
- [PlayerController.cs](file:///e:/Unity/Unity%20Program/Test_2022/Assets/_Project/Scripts/Player/PlayerController.cs)
|
|||
|
|
|
|||
|
|
配置方式（Inspector）：
|
|||
|
|
- 在 PlayerController 的 `Interaction Prompt UI` 区域：
|
|||
|
|
- `Can Interact Notification`：拖入“可互动提示”的 `FeedNotification`
|
|||
|
|
- `Blocked Notification`：拖入“不可互动提示”的 `FeedNotification`
|
|||
|
|
- `Blocked Use Fail Reason`：勾选后会用条件组件返回的 `failReason` 覆盖不可互动提示文本
|
|||
|
|
- `Aim Prompt Refresh Interval`：射线检测刷新间隔，越小越灵敏（默认 0.05）
|
|||
|
|
- `Can/Blocked Notification Animator Speed`：运行时对通知的 Animator 设置 speed，用于加快弹出/收起
|
|||
|
|
|
|||
|
|
显示规则：
|
|||
|
|
- 射线命中且存在 `IInteractable`：
|
|||
|
|
- 条件全部通过：显示 `Can Interact Notification`
|
|||
|
|
- 任一条件失败：显示 `Blocked Notification`（可选显示失败原因）
|
|||
|
|
- 未命中或没有 `IInteractable`：两种提示都会收起
|
|||
|
|
|
|||
|
|
#### 2) 如何让 Feed Notification 动画更快弹出
|
|||
|
|
|
|||
|
|
FeedNotification 的动画由 Animator 控制（In/Out 两段）。加速方案优先级如下：
|
|||
|
|
|
|||
|
|
1) 直接调 Animator Controller 的状态 Speed（推荐，资源层面最稳定）
|
|||
|
|
- 资源位置：`Assets/ThirdParty/UI/Reach - Complete Sci-Fi UI/Animations/HUD/FeedNotification.controller`
|
|||
|
|
- 把 In/Out 状态的 Speed 调大（例如 1.5 或 2）
|
|||
|
|
|
|||
|
|
2) 缩短动画片段本身时长
|
|||
|
|
- 资源位置：
|
|||
|
|
- `Assets/ThirdParty/UI/Reach - Complete Sci-Fi UI/Animations/HUD/FeedNotification_In.anim`
|
|||
|
|
- `Assets/ThirdParty/UI/Reach - Complete Sci-Fi UI/Animations/HUD/FeedNotification_Out.anim`
|
|||
|
|
|
|||
|
|
3) 运行时设置 Animator.speed（项目已提供字段）
|
|||
|
|
- `PlayerController` 里提供了 `Can Interact Notification Animator Speed / Blocked Notification Animator Speed`
|
|||
|
|
- 注意：Reach 的 FeedNotification 内部有按“动画片段原始时长”做协程等待的逻辑，因此 Animator 变快不一定会同步缩短等待时间，但通常不影响观感
|