lms
ee1ff7f444
- 删除 01~05 旧中文教程目录 - 将 03 核心功能教程拆分为各 framework 模块的子文档 - 06 工具脚本移入 modules/frameworks/编辑器工具/UI工具/ - 非框架内容合并进 rules/20-开发规则.md 与 rules/40-工作流清单.md - 更新所有交叉链接与文档关联表 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2.5 KiB
2.5 KiB
资源管理使用指南
一、AssetBundle 资源加载
1.1 加载资源示例
public class ResourceLoader : MonoBehaviour
{
public void LoadPlayerModel(int resId, Action<GameObject> onLoaded)
{
// 通过 HFFunCatalogue 统一入口加载资源
// resId: 从 Res 配置表中读取的资源 ID
HFFunCatalogue.Asset.LoadAsset(resId, (res, obj) =>
{
if (obj != null)
{
GameObject model = res.GetAsset<GameObject>();
onLoaded?.Invoke(model);
}
else
{
Debug.LogError($"加载失败: resId={resId}");
}
});
}
}
1.2 实体资源加载示例
// 在 Entity 中加载资源
HFFunCatalogue.Asset.LoadAsset(data.EntityRes.Id, (res, obj) => {
if (!entity.isDeath)
{
var Boddy = res.GetAsset<GameObject>();
data.SetBoddy(Boddy);
}
});
二、资源管理 API
2.1 常用方法
| 类别 | 管理器 | 常用方法 |
|---|---|---|
| 资源 | HFABMgr |
LoadAsset(), OnStartLoad() |
2.2 资源加载流程
资源加载流程:
OnStartLoad(request)
│
▼
检查缓存 → 获取/创建 HFAssetLoader
│
▼
loader.AddRequest(request)
│
▼
loader.LoadAsset() → 异步加载
│
▼
加载完成 → 回调处理
三、资源管理注意事项
3.1 性能优化建议
- 及时释放不再使用的资源
- 使用异步加载避免卡顿
- 合理使用资源缓存
版本: v1.0
生效日期: 2026年
适用范围: GiftGameX 项目业务开发人员
文档关联
当本文档发生变更时，应同步检查以下关联文档，避免信息不一致。
| 文档 | 关联原因 |
|---|---|
| 资源管理入口 | 本文件是资源管理模块的子文档 |
| UI 窗口系统 | UI 资源加载依赖资源管理 |
| 实体系统 | 实体资源加载依赖资源管理 |
| 场景系统 | 场景资源加载依赖资源管理 |
| modules/模块索引.md | 模块索引是项目知识总入口 |
| rules/10-架构说明.md | 架构说明定义总体分层和依赖方向 |
| rules/30-模块登记规则.md | 模块登记规则定义分类和状态口径 |