106 lines
3.7 KiB
Markdown
106 lines
3.7 KiB
Markdown
|
# 业务功能 → StrayFog 框架能力映射
|
||
|
|
|
||
|
|
> 本文档是 PlayBalloons 业务参考的“接口文档”。>
|
||
|
|
> 它不描述业务实现细节，而是说明每个业务功能用到了 StrayFog 框架的哪些能力，以及应该参考哪些框架文档。
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 来源说明
|
||
|
|
|
||
|
|
以下业务功能来自 PlayBalloons 实际项目，仅作参考，不是 StrayFog 框架本身。
|
||
|
|
|
||
|
|
原始业务文档位于 [features/](features/) 目录。
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 业务功能映射表
|
||
|
|
|
||
|
|
| 业务功能 | 涉及 StrayFog 框架能力 | 参考文档 | 状态 |
|
||
|
|
|---|---|---|---|
|
||
|
|
| 登录 | 单例管理器、网络协议、UI 窗口、事件链 | 网络框架、UI 框架、Hotfix 启动 | 可提炼示例 |
|
||
|
|
| 背包 | 单例、RB_Tree 存储、事件驱动、增量同步 | 事件框架、网络框架、数据/配置框架 | 可提炼示例 |
|
||
|
|
| 商店 | 网络协议、Map 数据结构、UI 窗口 | 网络框架、UI 框架、数据/配置框架 | 部分接入 |
|
||
|
|
| PVE 战斗 | 场景、实体、波次管理、伤害管理器 | 实体框架、场景框架、网络框架 | 半接入 |
|
||
|
|
| 塔养成 | 单例、编队数据、实体属性联动 | 实体框架、数据/配置框架 | 未完整实装 |
|
||
|
|
| GM 调试 | GM 协议包装、参数配置、模块化窗口生命周期 | 网络框架、UI 框架 | 可提炼示例 |
|
||
|
|
| 奖励展示 | 通用 Tips、事件监听、资源组件 | UI 框架、事件框架、资源框架 | 可提炼示例 |
|
||
|
|
| 地图进度 | 地图加载、波次配置、进度奖励 | 场景框架、数据/配置框架 | 半接入 |
|
||
|
|
| PVP | — | — | 未发现实现 |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 可复用模式索引
|
||
|
|
|
||
|
|
从业务文档中提炼出的通用模式，可作为使用 StrayFog 框架实现类似系统的参考：
|
||
|
|
|
||
|
|
### 1. 单例管理器 + 初始化模式
|
||
|
|
|
||
|
|
```text
|
||
|
|
HFGameStart.InitManager()
|
||
|
|
-> 各业务 Manager.Instance 初始化
|
||
|
|
-> Manager 监听 STC 事件
|
||
|
|
```
|
||
|
|
|
||
|
|
对应框架能力：
|
||
|
|
- [Hotfix 启动](../../modules/frameworks/Hotfix启动.md)
|
||
|
|
- [对象池](../../modules/frameworks/内存对象管理/README.md)
|
||
|
|
|
||
|
|
### 2. 事件驱动数据流
|
||
|
|
|
||
|
|
```text
|
||
|
|
服务器消息 S2C
|
||
|
|
-> 反射创建 STC 事件
|
||
|
|
-> 业务 Manager 监听并更新数据
|
||
|
|
-> 派发 CTC 事件通知 UI
|
||
|
|
```
|
||
|
|
|
||
|
|
对应框架能力：
|
||
|
|
- [事件系统](../../modules/frameworks/事件系统/README.md)
|
||
|
|
- [网络系统](../../modules/frameworks/网络系统.md)
|
||
|
|
|
||
|
|
### 3. GM 命令统一包装
|
||
|
|
|
||
|
|
```text
|
||
|
|
GM 窗口
|
||
|
|
-> 选择 msgId 和参数
|
||
|
|
-> 包装成 GMC2S
|
||
|
|
-> 发送真实业务 Network_MsgId
|
||
|
|
```
|
||
|
|
|
||
|
|
对应框架能力：
|
||
|
|
- [网络系统](../../modules/frameworks/网络系统.md)
|
||
|
|
- [UI 窗口系统](../../modules/frameworks/UI窗口系统/README.md)
|
||
|
|
|
||
|
|
### 4. 通用弹窗 / Tips 展示
|
||
|
|
|
||
|
|
```text
|
||
|
|
业务逻辑调用 HFFunCatalogue.Tips.ShowCommonRewardTips(rewardItems)
|
||
|
|
-> 打开通用奖励窗口
|
||
|
|
-> 窗口内资源组件监听背包事件刷新
|
||
|
|
```
|
||
|
|
|
||
|
|
对应框架能力：
|
||
|
|
- [UI 窗口系统](../../modules/frameworks/UI窗口系统/README.md)
|
||
|
|
- [事件系统](../../modules/frameworks/事件系统/README.md)
|
||
|
|
- [资源管理](../../modules/frameworks/资源管理/README.md)
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 使用说明
|
||
|
|
|
||
|
|
1. AI 阅读时应先读框架文档，再读业务参考。
|
||
|
|
2. 业务参考中的具体类名、协议号不可直接套用到其他项目。
|
||
|
|
3. 如需新增业务参考，放入 `business-reference/<project>/features/`，并在本文件补充映射。
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 文档关联
|
||
|
|
|
||
|
|
> 当本文档发生变更时，应同步检查以下关联文档，避免信息不一致。
|
||
|
|
|
||
|
|
| 文档 | 关联原因 |
|
||
|
|
|---|---|
|
||
|
|
| [业务参考总入口.md](业务参考总入口.md) | 业务参考总入口指向本映射文档 |
|
||
|
|
| [features/*.md](features/) | 每个业务功能文档都应在映射表中有对应行 |
|
||
|
|
| [modules/模块索引.md](../../modules/模块索引.md) | 模块索引可链接到业务参考区 |
|