[docs][refactor]: 拆分重复模块文档并提升框架架构为全局入口
- 技能系统/相机系统/内存对象管理 README 改为概览+导航 - 框架架构.md 由通用框架子目录提升为全局入口 - 更新日期、过时改进点和文档关联路径 - 10-架构说明.md 拆分通用框架与框架架构链接 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -8,8 +8,6 @@
|
||||
|
||||
提供类实例池、行为对象池、脚本对象池、实体池和 RT 展示对象的统一复用机制,减少 GC 和实例化开销。
|
||||
|
||||
---
|
||||
|
||||
## 核心路径
|
||||
|
||||
- 内存管理:`Assets/Game/GameHFScripte/CopyToHF/MemoryManager/`
|
||||
@@ -17,59 +15,15 @@
|
||||
- 调用池:`Assets/Game/GameHFScripte/GameFunction/Logic/CallPoolManager/`
|
||||
- 实体池:`Assets/Game/GameHFScripte/GameFunction/GameEntity/EntityPool/`
|
||||
|
||||
---
|
||||
## 池类型概览
|
||||
|
||||
## 池类型
|
||||
|
||||
### HFClassEntityManager
|
||||
|
||||
类实例池,按类型 hash 维护 `Stack<object>`。
|
||||
|
||||
```text
|
||||
GetClassEntity<T>()
|
||||
-> 优先从 Stack 弹出复用
|
||||
-> 否则 Activator.CreateInstance<T>()
|
||||
```
|
||||
|
||||
### HFSimulateBehaviourPool<T>
|
||||
|
||||
行为对象池,用于继承 `AbsHFSimulateBehaviour` 的对象。
|
||||
|
||||
- 维护未使用队列和使用中列表。
|
||||
- `GiveBack()` 隐藏 GameObject 并调用 `Recycle()`。
|
||||
|
||||
### HFScriptMemPool<T>
|
||||
|
||||
脚本对象池,用于 `IHFRecycle` 的普通对象或 MonoBehaviour。
|
||||
|
||||
- 若类型继承 MonoBehaviour,自动创建 GameObject 挂载组件。
|
||||
- 若类型为普通类,直接 `Activator.CreateInstance`。
|
||||
|
||||
### 实体池
|
||||
|
||||
`HFEntityPool` + 各类 `AbsHFEntityPool` 实现,见 [实体系统](../实体系统/README.md)。
|
||||
|
||||
---
|
||||
|
||||
## 运行时展示对象(RT)
|
||||
|
||||
RT 对象用于在独立相机上展示模型、特效等:
|
||||
|
||||
- `RTObject`:运行时展示对象基类
|
||||
- `RTGameObjectRes`:从资源 id 创建展示对象
|
||||
- `RTEntity`:实体展示对象
|
||||
- `RTCameraItem`:RT 相机项
|
||||
- `RTUIEffectCameraItem`:UI 特效相机项
|
||||
|
||||
创建流程:
|
||||
|
||||
```text
|
||||
RTGameObjectRes
|
||||
-> 从资源 id 创建 GameObject
|
||||
-> 资源加载走 HFABMgr.Instance.LoadAsset
|
||||
```
|
||||
|
||||
---
|
||||
| 池 | 用途 |
|
||||
|---|---|
|
||||
| `HFClassEntityManager` | 类实例池,按类型维护复用栈 |
|
||||
| `HFSimulateBehaviourPool<T>` | 行为对象池,用于继承 `AbsHFSimulateBehaviour` 的对象 |
|
||||
| `HFScriptMemPool<T>` | 脚本对象池,支持普通类与 MonoBehaviour |
|
||||
| `HFEntityPool` | 实体池,见 [实体系统](../实体系统/README.md) |
|
||||
| RT 展示对象 | 在独立相机展示模型/特效,资源加载走 `HFABMgr` |
|
||||
|
||||
## 回收接口
|
||||
|
||||
@@ -79,8 +33,6 @@ RTGameObjectRes
|
||||
| `IHFRecycleEventHandler` | 回收事件处理 |
|
||||
| `OnAfterRecycleHandler` | 回收到类实例池 |
|
||||
|
||||
---
|
||||
|
||||
## 使用规则
|
||||
|
||||
- 频繁创建/销毁的对象优先使用对象池。
|
||||
@@ -88,14 +40,11 @@ RTGameObjectRes
|
||||
- 对象池内对象在归还后应重置状态。
|
||||
- RT 对象注意及时释放相机 seat 和资源引用。
|
||||
|
||||
---
|
||||
## 详细文档
|
||||
|
||||
## 相关模块
|
||||
|
||||
- [实体系统](../实体系统/README.md)
|
||||
- [资源管理](../资源管理/README.md)
|
||||
|
||||
---
|
||||
- [使用指南](使用指南.md) — GameObject 池、脚本池、设计特点、性能建议与示例
|
||||
- [实体系统](../实体系统/README.md) — 实体池特化
|
||||
- [资源管理](../资源管理/README.md) — RT 对象资源加载
|
||||
|
||||
## 文档关联
|
||||
|
||||
@@ -104,6 +53,7 @@ RTGameObjectRes
|
||||
| 文档 | 关联原因 |
|
||||
|---|---|
|
||||
| [modules/模块索引.md](../../模块索引.md) | 模块索引是项目知识总入口 |
|
||||
| [modules/frameworks/内存对象管理/使用指南.md](使用指南.md) | 本模块的详细 API 与使用说明 |
|
||||
| [modules/frameworks/实体系统/README.md](../实体系统/README.md) | 实体池是对象池的一种特化 |
|
||||
| [modules/frameworks/资源管理/README.md](../资源管理/README.md) | RT 对象资源加载依赖资源管理 |
|
||||
| [rules/10-架构说明.md](../../../rules/10-架构说明.md) | 架构说明定义总体分层和依赖方向 |
|
||||
|
||||
Reference in New Issue
Block a user