mirror of
https://gitee.com/dgflash/oops-plugin-framework.git
synced 2026-05-08 03:16:49 +08:00
774 lines
26 KiB
TypeScript
774 lines
26 KiB
TypeScript
/*
|
||
* @Author: dgflash
|
||
* @Date: 2022-04-14 17:08:01
|
||
* @LastEditors: dgflash
|
||
* @LastEditTime: 2022-12-13 11:36:00
|
||
*/
|
||
import type { Asset, EventKeyboard, EventTouch, Sprite, __private } from 'cc';
|
||
import { Button, Component, EventHandler, Input, Node, Prefab, SpriteFrame, _decorator, input, instantiate, isValid } from 'cc';
|
||
import { oops } from '../../core/Oops';
|
||
import type { AudioEffect } from '../../core/common/audio/AudioEffect';
|
||
import type { IAudioParams } from '../../core/common/audio/IAudio';
|
||
import { EventDispatcher } from '../../core/common/event/EventDispatcher';
|
||
import type { ListenerFunc, ListenerFuncTyped } from '../../core/common/event/EventMessage';
|
||
import { EventMessage } from '../../core/common/event/EventMessage';
|
||
import type { AssetType, CompleteCallback, Paths, ProgressCallback } from '../../core/common/loader/ResLoader';
|
||
import { resLoader } from '../../core/common/loader/ResLoader';
|
||
import { ViewUtil } from '../../core/utils/ViewUtil';
|
||
|
||
const { ccclass } = _decorator;
|
||
|
||
/** 加载资源类型 */
|
||
enum ResType {
|
||
Load,
|
||
LoadDir
|
||
}
|
||
|
||
/** 资源加载记录 */
|
||
interface ResRecord {
|
||
/** 资源包名 */
|
||
bundle: string,
|
||
/** 资源路径 */
|
||
path: string,
|
||
/** 引用计数 */
|
||
refCount: number,
|
||
/** 资源编号 */
|
||
resId?: number
|
||
}
|
||
|
||
/**
|
||
* 游戏显示对象组件模板
|
||
* 1、当前对象加载的资源，会在对象释放时，自动释放引用的资源
|
||
* 2、当前对象支持启动游戏引擎提供的各种常用逻辑事件
|
||
*/
|
||
@ccclass('GameComponent')
|
||
export class GameComponent extends Component {
|
||
//#region 全局事件管理
|
||
private _event: EventDispatcher | null = null;
|
||
/** 全局事件管理器 */
|
||
private get event(): EventDispatcher {
|
||
if (this._event == null) this._event = new EventDispatcher();
|
||
return this._event;
|
||
}
|
||
|
||
/** 标记是否已注册键盘事件 */
|
||
private _keyboardEnabled = false;
|
||
/** 标记是否已注册按钮事件 */
|
||
private _buttonEnabled = false;
|
||
|
||
//#region 强类型事件方法（提供给 Agent 自动生成用）
|
||
|
||
/**
|
||
* 注册全局事件（强类型）
|
||
* @param event 事件名（枚举）
|
||
* @param listener 处理事件的侦听器函数
|
||
* @param object 侦听函数绑定的this对象
|
||
*/
|
||
watch<K extends keyof OopsFramework.TypedEventMap>(event: K, listener: ListenerFuncTyped<K, OopsFramework.TypedEventMap[K]>, object: any): void {
|
||
this.event.on(event as string, listener as ListenerFunc, object);
|
||
}
|
||
|
||
/**
|
||
* 监听一次事件，事件响应后，该监听自动移除（强类型）
|
||
* @param event 事件名（枚举）
|
||
* @param listener 事件触发回调方法
|
||
* @param object 侦听函数绑定的this对象
|
||
*/
|
||
watchOnce<K extends keyof OopsFramework.TypedEventMap>(event: K, listener: ListenerFuncTyped<K, OopsFramework.TypedEventMap[K]>, object: any): void {
|
||
this.event.once(event as string, listener as ListenerFunc, object);
|
||
}
|
||
|
||
/**
|
||
* 移除全局事件（强类型）
|
||
* @param event 事件名（枚举）
|
||
* @param listener 处理事件的侦听器函数（可选）
|
||
* @param object 侦听函数绑定的this对象（可选）
|
||
*/
|
||
unwatch<K extends keyof OopsFramework.TypedEventMap>(event: K, listener?: ListenerFuncTyped<K, OopsFramework.TypedEventMap[K]>, object?: any): void {
|
||
this.event.off(event as string, listener as ListenerFunc, object);
|
||
}
|
||
|
||
/**
|
||
* 触发强类型全局事件
|
||
* @param event 事件名（枚举）
|
||
* @param data 事件数据
|
||
*/
|
||
emit<K extends keyof OopsFramework.TypedEventMap>(event: K, data?: OopsFramework.TypedEventMap[K]): void {
|
||
this.event.emit(event, data);
|
||
}
|
||
|
||
/**
|
||
* 触发强类型异步全局事件（严格类型检查）
|
||
* @param event 事件名（枚举）
|
||
* @param data 事件数据（必须完全匹配类型定义）
|
||
*/
|
||
emitAsync<K extends keyof OopsFramework.TypedEventMap>(event: K, data: OopsFramework.TypedEventMap[K]): Promise<void> {
|
||
return this.event.emitAsync(event, data);
|
||
}
|
||
|
||
//#endregion
|
||
|
||
//#region 弱类型事件方法
|
||
/**
|
||
* 注册全局事件
|
||
* @param event 事件名
|
||
* @param listener 处理事件的侦听器函数
|
||
* @param object 侦听函数绑定的this对象
|
||
*/
|
||
on(event: string, listener: ListenerFunc, object: any): void {
|
||
this.event.on(event, listener, object);
|
||
}
|
||
|
||
/**
|
||
* 监听一次事件，事件响应后，该监听自动移除
|
||
* @param event 事件名
|
||
* @param listener 事件触发回调方法
|
||
* @param object 侦听函数绑定的this对象
|
||
*/
|
||
once(event: string, listener: ListenerFunc, object: any): void {
|
||
this.event.once(event, listener, object);
|
||
}
|
||
|
||
/**
|
||
* 移除全局事件
|
||
* @param event 事件名
|
||
* @param listener 处理事件的侦听器函数（可选）
|
||
* @param object 侦听函数绑定的this对象（可选）
|
||
*/
|
||
off(event: string, listener?: ListenerFunc, object?: object): void {
|
||
this.event.off(event, listener, object);
|
||
}
|
||
|
||
/**
|
||
* 触发全局事件
|
||
* @param event 事件名
|
||
* @param args 事件参数
|
||
*/
|
||
dispatchEvent(event: string, ...args: any[]): void {
|
||
this.event.dispatchEvent(event, ...args);
|
||
}
|
||
|
||
/**
|
||
* 触发全局事件,支持同步与异步处理
|
||
* @param event 事件名
|
||
* @param args 事件参数
|
||
*/
|
||
dispatchEventAsync(event: string, ...args: any[]): Promise<void> {
|
||
return this.event.dispatchEventAsync(event, ...args);
|
||
}
|
||
//#endregion
|
||
|
||
//#endregion
|
||
|
||
//#region 预制节点管理
|
||
|
||
/** 摊平的节点集合（所有节点不能重名） */
|
||
nodes: Map<string, Node> = null!;
|
||
|
||
/** 通过节点名获取预制上的节点，整个预制不能有重名节点 */
|
||
getNode(name: string): Node | undefined {
|
||
if (this.nodes) {
|
||
return this.nodes.get(name);
|
||
}
|
||
return undefined;
|
||
}
|
||
|
||
/** 平摊所有节点存到Map<string, Node>中通过get(name: string)方法获取 */
|
||
nodeTreeInfoLite() {
|
||
this.nodes = new Map();
|
||
ViewUtil.nodeTreeInfoLite(this.node, this.nodes);
|
||
}
|
||
|
||
/**
|
||
* 从资源缓存中找到预制资源名并创建一个显示对象
|
||
* @param path 资源路径
|
||
* @param bundleName 资源包名
|
||
* @returns 预制节点，加载失败返回 null
|
||
*/
|
||
async createPrefabNode(path: string, bundleName: string = oops.res.defaultBundleName): Promise<Node | null> {
|
||
const prefab = await this.load(bundleName, path, Prefab);
|
||
if (!prefab) {
|
||
console.warn('[OopsFramework]', `预制体加载失败: ${path}`);
|
||
return null;
|
||
}
|
||
return instantiate(prefab);
|
||
}
|
||
//#endregion
|
||
|
||
//#region 资源加载管理
|
||
/** 资源路径 */
|
||
private resPaths: Map<ResType, Map<string, ResRecord>> = null!; // 资源使用记录
|
||
|
||
/**
|
||
* 获取资源
|
||
* @param path 资源路径
|
||
* @param type 资源类型
|
||
* @param bundleName 远程资源包名
|
||
*/
|
||
getRes<T extends Asset>(path: string, type?: __private.__types_globals__Constructor<T> | null, bundleName?: string): T | null {
|
||
return oops.res.get(path, type, bundleName);
|
||
}
|
||
|
||
/**
|
||
* 添加资源使用记录
|
||
* @param type 资源类型
|
||
* @param bundleName 资源包名
|
||
* @param paths 资源路径
|
||
*/
|
||
private addPathToRecord<T>(type: ResType, bundleName: string, paths?: string | string[] | AssetType<T> | ProgressCallback | CompleteCallback | null): void {
|
||
if (this.resPaths == null) this.resPaths = new Map();
|
||
|
||
let rps = this.resPaths.get(type);
|
||
if (rps == null) {
|
||
rps = new Map();
|
||
this.resPaths.set(type, rps);
|
||
}
|
||
|
||
// 确定真实的 bundle 和 path
|
||
let realBundle: string;
|
||
let realPaths: string[];
|
||
|
||
if (paths instanceof Array) {
|
||
realBundle = bundleName;
|
||
realPaths = paths;
|
||
}
|
||
else if (typeof paths === 'string') {
|
||
realBundle = bundleName;
|
||
realPaths = [paths];
|
||
}
|
||
else {
|
||
realBundle = oops.res.defaultBundleName;
|
||
realPaths = [bundleName];
|
||
}
|
||
|
||
// 统一处理路径数组
|
||
for (const realPath of realPaths) {
|
||
const key = this.getResKey(realBundle, realPath);
|
||
const rp = rps.get(key);
|
||
if (rp) {
|
||
rp.refCount++;
|
||
}
|
||
else {
|
||
rps.set(key, { path: realPath, bundle: realBundle, refCount: 1 });
|
||
}
|
||
}
|
||
}
|
||
|
||
private getResKey(realBundle: string, realPath: string): string {
|
||
const key = `${realBundle}:${realPath}`;
|
||
return key;
|
||
}
|
||
|
||
/**
|
||
* 移除资源使用记录（用于加载失败时回滚）
|
||
* @param type 资源类型
|
||
* @param bundleName 资源包名
|
||
* @param paths 资源路径
|
||
*/
|
||
private removePathFromRecord(type: ResType, bundleName: string, path: string): void {
|
||
if (!this.resPaths) return;
|
||
|
||
const rps = this.resPaths.get(type);
|
||
if (!rps) return;
|
||
|
||
const key = this.getResKey(bundleName, path);
|
||
const record = rps.get(key);
|
||
if (record) {
|
||
record.refCount--;
|
||
if (record.refCount <= 0) {
|
||
rps.delete(key);
|
||
}
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 加载一个资源
|
||
* @param bundleName 远程包名
|
||
* @param paths 资源路径
|
||
* @param type 资源类型
|
||
* @param onProgress 加载进度回调
|
||
*/
|
||
async load<T extends Asset>(bundleName: string, paths: Paths | AssetType<T>, type?: AssetType<T>): Promise<T> {
|
||
let realBundle: string;
|
||
let realPath: string;
|
||
|
||
if (typeof paths === 'string') {
|
||
realBundle = bundleName;
|
||
realPath = paths;
|
||
}
|
||
else {
|
||
realBundle = oops.res.defaultBundleName;
|
||
realPath = bundleName;
|
||
}
|
||
|
||
this.addPathToRecord(ResType.Load, bundleName, paths);
|
||
try {
|
||
const result = await oops.res.load(bundleName, paths, type);
|
||
if (!result) {
|
||
this.removePathFromRecord(ResType.Load, realBundle, realPath);
|
||
}
|
||
return result;
|
||
}
|
||
catch (error) {
|
||
this.removePathFromRecord(ResType.Load, realBundle, realPath);
|
||
throw error;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 加载指定资源包中的多个任意类型资源（回调模式）
|
||
* @param bundleName 远程包名或资源路径数组
|
||
* @param paths 资源路径数组或进度回调
|
||
* @param onProgress 加载进度回调
|
||
* @param onComplete 加载完成回调
|
||
*/
|
||
loadAny(bundleName: string | string[], paths: string[] | ProgressCallback, onProgress?: ProgressCallback | CompleteCallback, onComplete?: CompleteCallback): void {
|
||
const originalComplete = onComplete as ((err: Error | null, data: Asset[]) => void) | undefined;
|
||
const pathsToTrack: { bundle: string; path: string }[] = [];
|
||
|
||
if (typeof bundleName === 'string' && Array.isArray(paths)) {
|
||
this.addPathToRecord(ResType.Load, bundleName, paths);
|
||
pathsToTrack.push(...paths.map(p => ({ bundle: bundleName, path: p })));
|
||
}
|
||
else if (Array.isArray(bundleName)) {
|
||
this.addPathToRecord(ResType.Load, resLoader.defaultBundleName, bundleName);
|
||
pathsToTrack.push(...bundleName.map(p => ({ bundle: resLoader.defaultBundleName, path: p })));
|
||
}
|
||
else if (typeof bundleName === 'string' && typeof paths === 'function') {
|
||
this.addPathToRecord(ResType.Load, resLoader.defaultBundleName, bundleName);
|
||
pathsToTrack.push({ bundle: resLoader.defaultBundleName, path: bundleName });
|
||
}
|
||
|
||
const wrappedComplete = (err: Error | null, data: Asset[]) => {
|
||
if (err || !data) {
|
||
pathsToTrack.forEach(({ bundle, path }) => {
|
||
this.removePathFromRecord(ResType.Load, bundle, path);
|
||
});
|
||
}
|
||
originalComplete?.(err, data);
|
||
};
|
||
|
||
oops.res.loadAny(bundleName, paths, onProgress, wrappedComplete);
|
||
}
|
||
|
||
/**
|
||
* 加载文件夹中的资源（回调模式）
|
||
* @param bundleName 远程包名
|
||
* @param dir 文件夹名
|
||
* @param type 资源类型
|
||
* @param onProgress 加载进度回调
|
||
* @param onComplete 加载完成回调
|
||
*/
|
||
loadDir<T extends Asset>(bundleName: string, dir: string, type: AssetType<T>, onProgress: ProgressCallback, onComplete: CompleteCallback): void;
|
||
loadDir<T extends Asset>(bundleName: string, dir: string, onProgress: ProgressCallback, onComplete: CompleteCallback): void;
|
||
loadDir<T extends Asset>(bundleName: string, dir: string, onComplete?: CompleteCallback): void;
|
||
loadDir<T extends Asset>(bundleName: string, dir: string, type: AssetType<T>, onComplete?: CompleteCallback): void;
|
||
loadDir<T extends Asset>(dir: string, type: AssetType<T>, onProgress: ProgressCallback, onComplete: CompleteCallback): void;
|
||
loadDir<T extends Asset>(dir: string, onProgress: ProgressCallback, onComplete: CompleteCallback): void;
|
||
loadDir<T extends Asset>(dir: string, onComplete?: CompleteCallback): void;
|
||
loadDir<T extends Asset>(dir: string, type: AssetType<T>, onComplete?: CompleteCallback): void;
|
||
loadDir<T extends Asset>(
|
||
bundleName: string,
|
||
dir?: string | AssetType<T> | ProgressCallback | CompleteCallback,
|
||
type?: AssetType<T> | ProgressCallback | CompleteCallback,
|
||
onProgress?: ProgressCallback | CompleteCallback,
|
||
onComplete?: CompleteCallback,
|
||
): void {
|
||
let realDir: string;
|
||
let realBundle: string;
|
||
if (typeof dir === 'string') {
|
||
realDir = dir;
|
||
realBundle = bundleName;
|
||
}
|
||
else {
|
||
realDir = bundleName;
|
||
realBundle = oops.res.defaultBundleName;
|
||
}
|
||
|
||
this.addPathToRecord(ResType.LoadDir, realBundle, realDir);
|
||
|
||
const originalComplete = onComplete as ((err: Error | null, data: T[]) => void) | undefined;
|
||
const wrappedComplete = (err: Error | null, data: T[]) => {
|
||
if (err || !data) {
|
||
this.removePathFromRecord(ResType.LoadDir, realBundle, realDir);
|
||
}
|
||
originalComplete?.(err, data);
|
||
};
|
||
|
||
oops.res.loadDir(bundleName, dir, type, onProgress, wrappedComplete);
|
||
}
|
||
|
||
/**
|
||
* 手动释放指定资源
|
||
* @param path 资源路径
|
||
* @param bundleName 资源包名
|
||
* @param releaseAll 是否释放所有引用计数（默认只释放一次）
|
||
*/
|
||
releaseRes(path: string, bundleName: string = resLoader.defaultBundleName, releaseAll = false) {
|
||
if (!this.resPaths) return;
|
||
|
||
const rps = this.resPaths.get(ResType.Load);
|
||
if (!rps) return;
|
||
|
||
const key = this.getResKey(bundleName, path);
|
||
const record = rps.get(key);
|
||
if (record) {
|
||
if (releaseAll) {
|
||
// 释放所有引用
|
||
for (let i = 0; i < record.refCount; i++) {
|
||
oops.res.release(record.path, record.bundle);
|
||
}
|
||
rps.delete(key);
|
||
}
|
||
else {
|
||
// 只释放一次引用
|
||
oops.res.release(record.path, record.bundle);
|
||
record.refCount--;
|
||
if (record.refCount <= 0) {
|
||
rps.delete(key);
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
/** 释放所有加载的资源 */
|
||
release() {
|
||
if (this.resPaths) {
|
||
const rps = this.resPaths.get(ResType.Load);
|
||
if (rps) {
|
||
rps.forEach((value: ResRecord) => {
|
||
// 根据引用计数释放资源
|
||
for (let i = 0; i < value.refCount; i++) {
|
||
oops.res.release(value.path, value.bundle);
|
||
}
|
||
});
|
||
rps.clear();
|
||
this.resPaths.delete(ResType.Load);
|
||
}
|
||
}
|
||
}
|
||
|
||
/** 释放所有文件夹资源 */
|
||
releaseDir() {
|
||
if (this.resPaths) {
|
||
const rps = this.resPaths.get(ResType.LoadDir);
|
||
if (rps) {
|
||
rps.forEach((value: ResRecord) => {
|
||
// 释放文件夹资源（根据引用计数多次释放）
|
||
for (let i = 0; i < value.refCount; i++) {
|
||
oops.res.releaseDir(value.path, value.bundle);
|
||
}
|
||
});
|
||
rps.clear();
|
||
this.resPaths.delete(ResType.LoadDir);
|
||
}
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 获取资源引用计数
|
||
* @param path 资源路径
|
||
* @param bundleName 资源包名
|
||
* @returns 引用计数，未找到返回0
|
||
*/
|
||
getResRefCount(path: string, bundleName: string = resLoader.defaultBundleName): number {
|
||
if (!this.resPaths) return 0;
|
||
|
||
const rps = this.resPaths.get(ResType.Load);
|
||
if (!rps) return 0;
|
||
|
||
const key = this.getResKey(bundleName, path);
|
||
const record = rps.get(key);
|
||
return record ? record.refCount : 0;
|
||
}
|
||
|
||
/**
|
||
* 获取所有加载的资源信息（用于调试）
|
||
* @returns 资源记录数组
|
||
*/
|
||
getAllResRecords(): ResRecord[] {
|
||
const records: ResRecord[] = [];
|
||
if (!this.resPaths) return records;
|
||
|
||
const rps = this.resPaths.get(ResType.Load);
|
||
if (rps) {
|
||
rps.forEach((value: ResRecord) => {
|
||
records.push({ ...value });
|
||
});
|
||
}
|
||
|
||
return records;
|
||
}
|
||
|
||
/**
|
||
* 打印资源使用情况（用于调试）
|
||
*/
|
||
printResUsage() {
|
||
if (!this.resPaths) {
|
||
console.log('[资源管理] 暂无资源记录');
|
||
return;
|
||
}
|
||
|
||
const loadRps = this.resPaths.get(ResType.Load);
|
||
const dirRps = this.resPaths.get(ResType.LoadDir);
|
||
|
||
console.log('========== 资源使用情况 ==========');
|
||
console.log(`组件: ${this.node.name}`);
|
||
|
||
if (loadRps && loadRps.size > 0) {
|
||
console.log(`\n[普通资源] 共 ${loadRps.size} 个:`);
|
||
loadRps.forEach((value: ResRecord, key: string) => {
|
||
console.log(` - ${key} (引用计数: ${value.refCount})`);
|
||
});
|
||
}
|
||
|
||
if (dirRps && dirRps.size > 0) {
|
||
console.log(`\n[文件夹资源] 共 ${dirRps.size} 个:`);
|
||
dirRps.forEach((value: ResRecord, key: string) => {
|
||
console.log(` - ${key} (引用计数: ${value.refCount})`);
|
||
});
|
||
}
|
||
|
||
console.log('==================================');
|
||
}
|
||
|
||
/**
|
||
* 设置图片资源
|
||
* @param target 目标精灵对象
|
||
* @param path 图片资源地址
|
||
* @param bundle 资源包名
|
||
* @returns 是否设置成功
|
||
* @remarks 资源引用计数由 load 方法自动管理，加载失败时会自动回滚
|
||
*/
|
||
async setSprite(target: Sprite, path: string, bundle: string = resLoader.defaultBundleName): Promise<boolean> {
|
||
const spriteFrame = await this.load(bundle, path, SpriteFrame);
|
||
if (!spriteFrame) {
|
||
return false;
|
||
}
|
||
if (!isValid(target)) {
|
||
this.releaseRes(path, bundle);
|
||
return false;
|
||
}
|
||
target.spriteFrame = spriteFrame;
|
||
return true;
|
||
}
|
||
//#endregion
|
||
|
||
//#region 音频播放管理
|
||
/**
|
||
* 播放背景音乐（不受自动释放资源管理）
|
||
* @param url 资源地址
|
||
* @param params 背景音乐资源播放参数
|
||
*/
|
||
playMusic(url: string, params?: IAudioParams) {
|
||
oops.audio.music.loadAndPlay(url, params);
|
||
}
|
||
|
||
/**
|
||
* 播放音效
|
||
* @param url 资源地址
|
||
* @param params 音效播放参数
|
||
* @returns 音效实例，播放失败返回 null
|
||
* @remarks 注意：音效资源由 AudioEffectPool 自动管理，不需要在此组件中记录
|
||
*/
|
||
playEffect(url: string, params?: IAudioParams): Promise<AudioEffect | null> {
|
||
return new Promise((resolve) => {
|
||
if (params == null) {
|
||
params = { bundle: resLoader.defaultBundleName };
|
||
}
|
||
else if (params.bundle == null) {
|
||
params.bundle = resLoader.defaultBundleName;
|
||
}
|
||
|
||
oops.audio.playEffect(url, params).then((ae) => {
|
||
resolve(ae ?? null);
|
||
});
|
||
});
|
||
}
|
||
//#endregion
|
||
|
||
//#region 游戏逻辑事件
|
||
/**
|
||
* 批量设置当前界面按钮事件
|
||
* @param bindRootEvent 是否对预制根节点绑定触摸事件
|
||
* @example
|
||
* 注：按钮节点Label1、Label2必须绑定UIButton等类型的按钮组件才会生效，方法名必须与节点名一致
|
||
* this.setButton();
|
||
*
|
||
* Label1(event: EventTouch) { console.log(event.target.name); }
|
||
* Label2(event: EventTouch) { console.log(event.target.name); }
|
||
*/
|
||
protected setButton(bindRootEvent = true) {
|
||
this._buttonEnabled = true;
|
||
|
||
// 自定义按钮批量绑定触摸事件
|
||
if (bindRootEvent) {
|
||
this.node.on(Node.EventType.TOUCH_END, (event: EventTouch) => {
|
||
const self: any = this;
|
||
const func = self[event.target.name];
|
||
if (func) {
|
||
func.call(this, event);
|
||
}
|
||
// 不触发界面根节点触摸事件、不触发长按钮组件的触摸事件
|
||
// else if (event.target != this.node && event.target.getComponent(ButtonTouchLong) == null) {
|
||
// console.warn(`名为【${event.target.name}】的按钮事件方法不存在`);
|
||
// }
|
||
}, this);
|
||
}
|
||
|
||
// Cocos Creator Button组件批量绑定触摸事件（使用UIButton支持放连点功能）
|
||
const regex = /<([^>]+)>/;
|
||
const match = this.name.match(regex);
|
||
if (!match || !match[1]) {
|
||
console.warn('[OopsFramework]', `组件名 "${this.name}" 不符合 "<组件名>" 格式，跳过按钮事件绑定`);
|
||
return;
|
||
}
|
||
const componentName = match[1];
|
||
const buttons = this.node.getComponentsInChildren<Button>(Button);
|
||
buttons.forEach((b: Button) => {
|
||
const node = b.node;
|
||
const self: any = this;
|
||
const func = self[node.name];
|
||
if (func) {
|
||
const event = new EventHandler();
|
||
event.target = this.node;
|
||
event.handler = b.node.name;
|
||
event.component = componentName;
|
||
b.clickEvents.push(event);
|
||
}
|
||
// else {
|
||
// console.warn(`名为【${node.name}】的按钮事件方法不存在`);
|
||
// }
|
||
});
|
||
}
|
||
|
||
/**
|
||
* 批量设置全局事件
|
||
* @example
|
||
* this.setEvent("onGlobal");
|
||
* this.dispatchEvent("onGlobal", "全局事件");
|
||
*
|
||
* onGlobal(event: string, args: any) { console.log(args) };
|
||
*/
|
||
protected setEvent(...args: string[]) {
|
||
const self: any = this;
|
||
for (const name of args) {
|
||
const func = self[name];
|
||
if (func)
|
||
this.on(name, func, this);
|
||
else
|
||
console.error(`名为【${name}】的全局事方法不存在`);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 键盘事件开关
|
||
* @param on 打开键盘事件为true
|
||
*/
|
||
setKeyboard(on: boolean) {
|
||
if (on) {
|
||
this._keyboardEnabled = true;
|
||
input.on(Input.EventType.KEY_DOWN, this.onKeyDown, this);
|
||
input.on(Input.EventType.KEY_UP, this.onKeyUp, this);
|
||
input.on(Input.EventType.KEY_PRESSING, this.onKeyPressing, this);
|
||
}
|
||
else {
|
||
this._keyboardEnabled = false;
|
||
input.off(Input.EventType.KEY_DOWN, this.onKeyDown, this);
|
||
input.off(Input.EventType.KEY_UP, this.onKeyUp, this);
|
||
input.off(Input.EventType.KEY_PRESSING, this.onKeyPressing, this);
|
||
}
|
||
}
|
||
|
||
/** 键按下 */
|
||
protected onKeyDown(event: EventKeyboard) { }
|
||
|
||
/** 键放开 */
|
||
protected onKeyUp(event: EventKeyboard) { }
|
||
|
||
/** 键长按 */
|
||
protected onKeyPressing(event: EventKeyboard) { }
|
||
|
||
/** 监听游戏从后台进入事件 */
|
||
protected setGameShow() {
|
||
this.on(EventMessage.GAME_SHOW, this.onGameShow, this);
|
||
}
|
||
|
||
/** 监听游戏切到后台事件 */
|
||
protected setGameHide() {
|
||
this.on(EventMessage.GAME_HIDE, this.onGameHide, this);
|
||
}
|
||
|
||
/** 监听游戏画笔尺寸变化事件 */
|
||
protected setGameResize() {
|
||
this.on(EventMessage.GAME_RESIZE, this.onGameResize, this);
|
||
}
|
||
|
||
/** 监听游戏全屏事件 */
|
||
protected setGameFullScreen() {
|
||
this.on(EventMessage.GAME_FULL_SCREEN, this.onGameFullScreen, this);
|
||
}
|
||
|
||
/** 监听游戏旋转屏幕事件 */
|
||
protected setGameOrientation() {
|
||
this.on(EventMessage.GAME_ORIENTATION, this.onGameOrientation, this);
|
||
}
|
||
|
||
/** 游戏从后台进入事件回调 */
|
||
protected onGameShow(): void { }
|
||
|
||
/** 游戏切到后台事件回调 */
|
||
protected onGameHide(): void { }
|
||
|
||
/** 游戏画笔尺寸变化事件回调 */
|
||
protected onGameResize(): void { }
|
||
|
||
/** 游戏全屏事件回调 */
|
||
protected onGameFullScreen(): void { }
|
||
|
||
/** 游戏旋转屏幕事件回调 */
|
||
protected onGameOrientation(): void { }
|
||
//#endregion
|
||
|
||
/** 移除自己 */
|
||
remove() {
|
||
oops.gui.removeByNode(this.node);
|
||
}
|
||
|
||
protected onDestroy() {
|
||
// 清理键盘事件
|
||
if (this._keyboardEnabled) {
|
||
input.off(Input.EventType.KEY_DOWN, this.onKeyDown, this);
|
||
input.off(Input.EventType.KEY_UP, this.onKeyUp, this);
|
||
input.off(Input.EventType.KEY_PRESSING, this.onKeyPressing, this);
|
||
this._keyboardEnabled = false;
|
||
}
|
||
|
||
// 清理按钮事件
|
||
if (this._buttonEnabled) {
|
||
this.node.off(Node.EventType.TOUCH_END);
|
||
this._buttonEnabled = false;
|
||
}
|
||
|
||
// 释放消息对象
|
||
if (this._event) {
|
||
this._event.clear();
|
||
this._event = null;
|
||
}
|
||
|
||
// 节点引用数据清除
|
||
if (this.nodes) {
|
||
this.nodes.clear();
|
||
this.nodes = null!;
|
||
}
|
||
|
||
// 自动释放资源
|
||
if (this.resPaths) {
|
||
this.release();
|
||
this.releaseDir();
|
||
this.resPaths.clear();
|
||
this.resPaths = null!;
|
||
}
|
||
}
|
||
}
|