2026-07-07 18:36:15 +08:00
|
|
|
# 相机系统
|
|
|
|
|
|
|
|
|
|
## 分类
|
|
|
|
|
|
|
|
|
|
- 核心框架
|
|
|
|
|
|
|
|
|
|
## 目的
|
|
|
|
|
|
|
|
|
|
管理多相机注册、相机堆栈排序、渲染顺序控制，为 UI、场景、特效等提供分层渲染能力。
|
|
|
|
|
|
|
|
|
|
## 核心类
|
|
|
|
|
|
|
|
|
|
| 类 | 职责 |
|
|
|
|
|
|---|---|
|
|
|
|
|
| `HFCameraManager` | 相机管理器单例，维护相机列表和主相机引用 |
|
|
|
|
|
| `HFMainCamera` | 主相机，管理 CameraStack |
|
|
|
|
|
| `AbsHFCameraItem` | 相机项抽象基类，子类实现具体相机逻辑 |
|
|
|
|
|
|
|
|
|
|
## 使用规则
|
|
|
|
|
|
|
|
|
|
- 相机项必须继承 `AbsHFCameraItem`。
|
|
|
|
|
- `Weight` 决定堆栈内渲染顺序，值越大越靠后渲染。
|
|
|
|
|
- 添加和移除相机需成对出现，避免残留。
|
|
|
|
|
- UI 相机通常使用 `CameraClearFlags.Depth` 和较高 depth。
|
|
|
|
|
|
2026-07-15 14:39:16 +08:00
|
|
|
## 详细文档
|
2026-07-07 18:36:15 +08:00
|
|
|
|
2026-07-15 14:39:16 +08:00
|
|
|
- [使用指南](使用指南.md) — 自定义相机、堆栈管理、API 详情与示例
|
|
|
|
|
- [UI 窗口系统](../UI窗口系统/README.md) — UI 与相机的协作
|
|
|
|
|
- [资源管理](../资源管理/README.md) — 相机资源加载
|
2026-07-07 18:36:15 +08:00
|
|
|
|
|
|
|
|
## 文档关联
|
|
|
|
|
|
|
|
|
|
> 当本文档发生变更时，应同步检查以下关联文档，避免信息不一致。
|
|
|
|
|
|
|
|
|
|
| 文档 | 关联原因 |
|
|
|
|
|
|---|---|
|
|
|
|
|
| [modules/模块索引.md](../../模块索引.md) | 模块索引是项目知识总入口 |
|
2026-07-15 14:39:16 +08:00
|
|
|
| [modules/frameworks/相机系统/使用指南.md](使用指南.md) | 本模块的详细 API 与使用说明 |
|
2026-07-07 18:36:15 +08:00
|
|
|
| [modules/frameworks/UI窗口系统/README.md](../UI窗口系统/README.md) | UI 窗口系统常与相机系统协作 |
|
2026-07-15 14:39:16 +08:00
|
|
|
| [modules/frameworks/资源管理/README.md](../资源管理/README.md) | 相机资源加载依赖资源管理 |
|
2026-07-07 18:36:15 +08:00
|
|
|
| [rules/10-架构说明.md](../../../rules/10-架构说明.md) | 架构说明定义总体分层和依赖方向 |
|
|
|
|
|
| [rules/30-模块登记规则.md](../../../rules/30-模块登记规则.md) | 模块登记规则定义分类和状态口径 |
|
