Files
oops-plugin-framework/assets/module/common/part/GamePartKeyboard.ts
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

81 lines
2.6 KiB
TypeScript

import type { EventKeyboard } from 'cc';
import { Input, input } from 'cc';
import { GamePartBase } from '../GamePartBase';
/** 键盘事件回调 */
export interface KeyboardCallbacks {
onKeyDown?: (event: EventKeyboard) => void;
onKeyUp?: (event: EventKeyboard) => void;
onKeyPressing?: (event: EventKeyboard) => void;
}
/** 键盘输入 */
export class GamePartKeyboard extends GamePartBase {
private _enabled = false;
private _callbacks: KeyboardCallbacks | null = null;
/**
* 键盘事件开关
* @param on 是否开启
* @param callbacks 开启时传入对应键事件回调(可只传需要的项)
*/
setKeyboard(on: boolean, callbacks?: KeyboardCallbacks): void {
if (on) {
if (callbacks) {
this._callbacks = callbacks;
}
if (!this._callbacks) {
console.warn('[OopsFramework]', 'setKeyboard(true) 需传入 callbacks');
return;
}
this._register(this._callbacks);
this._enabled = true;
}
else {
if (this._enabled && this._callbacks) {
this._unregister(this._callbacks);
}
this._enabled = false;
this._callbacks = null;
}
}
/** 销毁键盘模块 */
override destroy(): void {
if (this._enabled && this._callbacks) {
this._unregister(this._callbacks);
this._enabled = false;
this._callbacks = null;
}
}
/** 注册键盘事件
* @param callbacks 键盘事件回调
*/
private _register(callbacks: KeyboardCallbacks): void {
if (callbacks.onKeyDown) {
input.on(Input.EventType.KEY_DOWN, callbacks.onKeyDown, this.comp);
}
if (callbacks.onKeyUp) {
input.on(Input.EventType.KEY_UP, callbacks.onKeyUp, this.comp);
}
if (callbacks.onKeyPressing) {
input.on(Input.EventType.KEY_PRESSING, callbacks.onKeyPressing, this.comp);
}
}
/** 注销键盘事件
* @param callbacks 键盘事件回调
*/
private _unregister(callbacks: KeyboardCallbacks): void {
if (callbacks.onKeyDown) {
input.off(Input.EventType.KEY_DOWN, callbacks.onKeyDown, this.comp);
}
if (callbacks.onKeyUp) {
input.off(Input.EventType.KEY_UP, callbacks.onKeyUp, this.comp);
}
if (callbacks.onKeyPressing) {
input.off(Input.EventType.KEY_PRESSING, callbacks.onKeyPressing, this.comp);
}
}
}