mirror of
https://gitee.com/dgflash/oops-plugin-framework.git
synced 2026-09-07 04:07:19 +08:00
新增与优化核心模块 🎯 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 类型定义与导出规范 优化接口注释与类型约束,提升开发体验
78 lines
2.4 KiB
TypeScript
78 lines
2.4 KiB
TypeScript
/** 对象工具 */
|
||
export class ObjectUtil {
|
||
/**
|
||
* 判断指定的值是否为对象
|
||
* @param value 值
|
||
*/
|
||
static isObject(value: any): boolean {
|
||
return Object.prototype.toString.call(value) === '[object Object]';
|
||
}
|
||
|
||
/**
|
||
* 深拷贝
|
||
* @param target 目标
|
||
*/
|
||
static deepCopy(target: any): any {
|
||
if (target == null || typeof target !== 'object') {
|
||
return target;
|
||
}
|
||
|
||
let result: any = null;
|
||
|
||
if (target instanceof Date) {
|
||
result = new Date();
|
||
result.setTime(target.getTime());
|
||
return result;
|
||
}
|
||
|
||
if (target instanceof Array) {
|
||
result = [];
|
||
for (let i = 0, length = target.length; i < length; i++) {
|
||
result[i] = this.deepCopy(target[i]);
|
||
}
|
||
return result;
|
||
}
|
||
|
||
if (target instanceof Object) {
|
||
result = {};
|
||
for (const key in target) {
|
||
if (target.hasOwnProperty(key)) {
|
||
result[key] = this.deepCopy(target[key]);
|
||
}
|
||
}
|
||
return result;
|
||
}
|
||
|
||
console.warn(`不支持的类型:${result}`);
|
||
}
|
||
|
||
/**
|
||
* 拷贝对象
|
||
* @param target 目标
|
||
*/
|
||
static copy(target: object): object {
|
||
return JSON.parse(JSON.stringify(target));
|
||
}
|
||
|
||
/**
|
||
* @function 检测是否为非法对象,比如"",null, undefined, NaN, [], {}
|
||
* @param {any} obj 任意基础数据对象,如:number、string、array、object等
|
||
* @returns boolean 非法为trre, 否则为false
|
||
*/
|
||
static isIllegalObject(obj: any): boolean {
|
||
// 检查是否为空或未定义
|
||
if (obj == null || obj == undefined) return true;
|
||
// 检查是否是特殊值
|
||
if (obj === Infinity || obj === -Infinity) return true;
|
||
// 检测是否包含空格的字符串
|
||
if (typeof obj === 'string' && obj.trim() === '') return true;
|
||
// 检查是否是无效的数字
|
||
if (Number.isNaN(obj)) return true;
|
||
// 检查是否是空数组
|
||
if (Array.isArray(obj) && obj.length <= 0) return true;
|
||
// 检查是否是空对象
|
||
if (typeof (obj) === 'object' && Object.keys(obj).length <= 0) return true;
|
||
return false;
|
||
}
|
||
}
|