45 lines
2.0 KiB
Markdown
45 lines
2.0 KiB
Markdown
|
## 玩家控制锁（PlayerControlLockService）技术说明
|
||
|
|
|
||
|
|
目标：当 UI 打开时（设置/暂停/平板等），统一锁定玩家移动/互动并显示鼠标；关闭 UI 时恢复到打开前状态。
|
||
|
|
|
||
|
|
### 一、脚本
|
||
|
|
- [PlayerControlLockService.cs](file:///e:/Unity/Unity%20Program/Test_2022/Assets/_Project/Scripts/Core/InputLock/PlayerControlLockService.cs)
|
||
|
|
|
||
|
|
### 二、设计要点
|
||
|
|
- 以“owner 计数/集合”的方式实现可重入：
|
||
|
|
- 多个 UI 同时打开时，不会互相覆盖
|
||
|
|
- 只有当最后一个 owner 解锁时才真正恢复输入
|
||
|
|
- 缓存并恢复组件 enabled 状态：
|
||
|
|
- 锁定时记录目标组件原始 enabled 值
|
||
|
|
- 解锁时按缓存逐个恢复，避免把原本就禁用的组件错误打开
|
||
|
|
|
||
|
|
### 三、锁定时做的事情（当前实现）
|
||
|
|
- 禁用（若存在）：
|
||
|
|
- `Player.PlayerController`
|
||
|
|
- `ItemUsageSystem`
|
||
|
|
- `InventoryUI`
|
||
|
|
- 复位输入缓存：
|
||
|
|
- 锁定与解锁时会清空 `PlayerController` 的 `Move/Look` 缓存，避免 UI 关闭后出现“卡住上一帧输入”的粘滞移动/转向
|
||
|
|
- 光标：
|
||
|
|
- `Cursor.lockState = None`
|
||
|
|
- `Cursor.visible = true`
|
||
|
|
|
||
|
|
### 四、解锁时做的事情（当前实现）
|
||
|
|
- 恢复上述组件到锁定前的 enabled 状态
|
||
|
|
- 光标：
|
||
|
|
- `Cursor.lockState = Locked`
|
||
|
|
- `Cursor.visible = false`
|
||
|
|
|
||
|
|
### 五、调用接口
|
||
|
|
- `PlayerControlLockService.Instance.Lock(object owner)`
|
||
|
|
- `PlayerControlLockService.Instance.Unlock(object owner)`
|
||
|
|
- `PlayerControlLockService.Instance.IsLocked()`
|
||
|
|
|
||
|
|
### 六、项目内接入点
|
||
|
|
- 暂停菜单打开/关闭：
|
||
|
|
- [InGamePauseMenuController.cs](file:///e:/Unity/Unity%20Program/Test_2022/Assets/_Project/Scripts/UI/PauseMenu/InGamePauseMenuController.cs)
|
||
|
|
- AI 平板打开/关闭：
|
||
|
|
- [TabletController.cs](file:///e:/Unity/Unity%20Program/Test_2022/Assets/_Project/Scripts/UI/TabletController.cs)
|
||
|
|
- 自动创建（DontDestroyOnLoad）：
|
||
|
|
- [SettingsBootstrap.cs](file:///e:/Unity/Unity%20Program/Test_2022/Assets/_Project/Scripts/Core/SettingsSystem/SettingsBootstrap.cs)
|