mirror of
https://gitee.com/dgflash/oops-plugin-framework.git
synced 2026-06-23 19:22:47 +08:00
d4f140077e
新增与优化核心模块 🎯 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 类型定义与导出规范 优化接口注释与类型约束，提升开发体验
42 lines
1.2 KiB
TypeScript
42 lines
1.2 KiB
TypeScript
import type { AudioClip } from 'cc';
|
|
import { AudioSource, _decorator } from 'cc';
|
|
import type { IAudioParams } from './IAudio';
|
|
const { ccclass } = _decorator;
|
|
|
|
/** 游戏音效播放器 */
|
|
@ccclass('AudioEffect')
|
|
export class AudioEffect extends AudioSource {
|
|
/** 唯一编号 */
|
|
key: string = null!;
|
|
/** 音效编号 */
|
|
aeid = -1;
|
|
/** 音效果资源路径 */
|
|
path: string | AudioClip = null!;
|
|
/** 音效参数 */
|
|
params: IAudioParams = null!;
|
|
/** 背景音乐播放完成回调 */
|
|
onComplete: Function | null = null;
|
|
|
|
start() {
|
|
this.node.on(AudioSource.EventType.ENDED, this.onAudioEnded, this);
|
|
}
|
|
|
|
private onAudioEnded() {
|
|
this.onComplete && this.onComplete(this);
|
|
}
|
|
|
|
/** 重置音效对象，释放所有引用 */
|
|
reset() {
|
|
this.stop();
|
|
this.clip = null;
|
|
this.path = null!;
|
|
this.params = null!;
|
|
this.onComplete = null; // 清理回调引用，防止内存泄漏
|
|
}
|
|
|
|
/** 组件销毁时清理资源 */
|
|
onDestroy() {
|
|
if (this.node) this.node.off(AudioSource.EventType.ENDED, this.onAudioEnded, this);
|
|
this.reset();
|
|
}
|
|
} |