24 Commits

Author SHA1 Message Date
dgflash
d4f140077e feat (core): 完善框架核心功能模块 - 音频、对象池、资源加载与组件系统
新增与优化核心模块
🎯 GUI 交互增强
ButtonInterceptor:按钮点击事件劫持器
劫持 EventHandler.emitEvents / ButtonSimple.onClick 核心方法
支持多类型按钮音效配置注册,按按钮类型自动匹配音效
单例模式管理,支持全局动态激活 / 停用拦截功能
🧩 对象池管理系统
GameNodePool:通用游戏节点对象池管理器
基于预制体(Prefab)UUID 实现池化隔离管理
支持特效、UI 元素等高频对象预加载、复用与回收
全局单例访问,统一管控对象创建 / 销毁逻辑
🔊 音频管理系统
AudioManager:音频核心管理器
独立背景音乐(AudioMusic)+ 音效池(AudioEffectPool)双模块
支持全局音量控制、播放状态恢复与场景切换管理
AudioEffect:基础音效播放器
AudioEnum:音频类型、音效分类枚举定义
📦 资源加载系统
ResLoader:资源加载核心控制器
资源包(Bundle)统一管理 + 并发加载限流控制
远程资源本地缓存、自动释放与内存优化
完整加载进度回调 + 错误异常处理机制
ResTypes:资源类型规范定义
ResErrors:资源加载错误码与异常处理
ResUtils:资源路径、格式转换等工具方法
🧱 模块化组件系统
GameComponent:游戏显示对象组件基类
集成资源自动引用计数(RC)管理
模块化部件(GamePartRegistry)插拔式架构
内置音频、按钮、事件、键盘、节点、对象池、资源七大部件
部件封装:
GamePartAudio:音频功能部件
GamePartButton:按钮交互部件
GamePartEvent:全局事件部件
GamePartKeyboard:键盘输入部件
GamePartNode:节点操作部件
GamePartNodePool:对象池调用部件
GamePartRes:资源加载部件
📝 类型定义完善
新增 IAudio 音频数据与播放参数接口
统一全模块 TS 类型定义与导出规范
优化接口注释与类型约束,提升开发体验
2026-05-29 22:55:13 +08:00
dgflash
3c3b7f4f64 refactor(gui): 提取屏幕适配逻辑到独立 ScreenAdapter 类
- 新增 ScreenAdapter 类,负责屏幕分辨率适配和安全区域适配
- LayerManager 移除 windowAspectRatio/designAspectRatio/mobileSafeArea 属性
- LayerManager 移除 initScreenAdapter() 方法
- LayerManager 添加 screenAdapter 属性,通过组合方式使用

BREAKING CHANGE: 如需访问屏幕适配属性,改为通过 oops.gui.adapter
2026-05-03 21:18:01 +08:00
dgflash
13cfa37bf3 框架配置数据支持强类型 2026-02-24 21:50:47 +08:00
dgflash
e4241ad217 所有“修改为‘统一标准 2025-12-13 23:32:56 +08:00
dgflash
37900d8219 修改框架配置格式,支持分组设置游戏配置,方便开发、测试、生产环境切换 2025-09-15 14:40:28 +08:00
dgflash
b4ea586d1a Gui框架支持通过gui.register注册界面配置 2025-09-09 17:19:57 +08:00
dgflash
dfe27e7442 GameConfig对象支持自定义全局参数分组功能 2025-09-08 16:17:31 +08:00
dgflash
2377040fef 添加移动设备安全区域适配功能开关 2024-11-19 11:32:22 +08:00
dgflash
313e940046 添加框架脚本文件夹注释 2024-11-12 18:30:10 +08:00
dgflash
1267b81d98 1. 资源管理模块新增预加、多资源包配置、资源包自动管理加载功能
2. 优化资源管理代码
3. 优化显示对象模板GameComponent对象代码
2024-10-03 17:58:49 +08:00
dgflash
5937f2faf5 1、优化语法
2、修复更新后的API注释
2024-09-04 21:23:53 +08:00
dgflash
86dc12af87 添加默认语言配置 2024-08-16 22:18:27 +08:00
dgflash
dec5385718 1、窗口加载超时提示与超时时间自定义
2、支持onAdded方法实现预处理自定义逻辑完成后在显示界面
2024-08-04 15:42:48 +08:00
dgflash
d092dce67e 1、优化框架启动配置在H5模式下因弱网加载失败进不了游戏问题,框架会自动反复重试加载配置文件
2、配置数据获取后,删除内存中的配置资源
2024-06-14 18:06:23 +08:00
donggang
318a004987 升级cc3.8.3 2024-05-16 17:20:06 +08:00
donggang
d531a43cb5 GameComponent添加引擎系统事件监听方法 2024-02-28 16:22:30 +08:00
dgflash
cc0d243a37 1、修改框架配置config.js到项目根目录下
2、添加框架默认远程资源加载的配置信息
2023-02-15 09:17:54 +08:00
dgflash
aac0bf064a 优化代码 2022-11-05 12:11:14 +08:00
dgflash
589eb6d59d 废弃config修改为oops.config 2022-11-01 15:50:04 +08:00
dgflash
de2a95c48c 提供游戏配置数据访问属性 2022-11-01 15:29:01 +08:00
dgflash
8b72bf580a 更新公共模块文档 2022-09-06 17:37:38 +08:00
dgflash
a68a8ff5ae 整理核心模块API文档 2022-09-02 10:16:11 +08:00
dgflash
0398d5dea4 修复Config.ts中部分库引用路径错误问题 2022-09-01 19:19:41 +08:00
dgflash
27138767c6 游戏通用配置模块提到框架中成为复用功能模块 2022-08-05 17:21:45 +08:00