UI模块

结合ResMgr.ts，用ccc 3.8.x 内置 API 帮我们写一个UIMgr.tsUI管理器，实现：
1、UI界面的创建、显示、隐藏、销毁
2、创建时可以根据参数设置UI是否缓存，提高复用
3、UI属于预制体类型
4、在 constructor 中 使用 director.once的Director.EVENT_AFTER_SCENE_LAUNCH事件执行init
5、在init中获取场景Canvas根节点作为UI父节点，但在编辑器模式下不执行
5、参考ResMgr单例方式，并导出

import { Node, Prefab, instantiate, director, isValid, Director } from 'cc';
import { resMgr } from './ResMgr';
import { EDITOR } from 'cc/env';

/**
 * UI管理器
 * 用于UI界面的创建、显示、隐藏、销毁
 */
export class UIMgr {
    private uiRoot: Node | null = null;
    private uiCache: Map<string, Node> = new Map();

    /** 单例实例 */
    public static readonly instance: UIMgr = new UIMgr();

    // 私有构造函数，防止外部实例化
    private constructor() {
        director.once(Director.EVENT_AFTER_SCENE_LAUNCH, this.init, this);
    }

    /**
     * 初始化UI管理器
     * 在非编辑器模式下，获取场景中的Canvas节点作为UI的父节点
     */
    private init() {
        if (!EDITOR) {
            this.uiRoot = director.getScene().getChildByName('Canvas')!;
        }
    }

    /**
     * 创建UI界面
     * @param {string} prefabPath - 预制体路径，格式为 "bundleName/prefabPath"
     * @param {boolean} cache - 是否缓存UI节点
     * @param {Function} callback - 创建完成时的回调函数
     */
    public createUI(prefabPath: string, cache: boolean = true, callback: (err: Error | null, uiNode: Node | null) => void) {
        if (this.uiCache.has(prefabPath)) {
            callback(null, this.uiCache.get(prefabPath)!);
            return;
        }

        const [bundleName, path] = prefabPath.split('/', 2);

        resMgr.loadAsset(bundleName, path, Prefab, (err, prefab) => {
            if (err) {
                callback(err, null);
                return;
            }

            const uiNode = instantiate(prefab);
            if (this.uiRoot && isValid(this.uiRoot)) {
                this.uiRoot.addChild(uiNode);
            }

            if (cache) {
                this.uiCache.set(prefabPath, uiNode);
            }

            callback(null, uiNode);
        });
    }

    /**
     * 显示UI界面
     * 如果UI未缓存，则创建新的UI
     * @param {string} prefabPath - 预制体路径
     */
    public showUI(prefabPath: string) {
        const uiNode = this.uiCache.get(prefabPath);
        if (uiNode && isValid(uiNode)) {
            uiNode.active = true;
        } else {
            this.createUI(prefabPath, true, (err, newUiNode) => {
                if (!err && newUiNode) {
                    newUiNode.active = true;
                }
            });
        }
    }

    /**
     * 隐藏UI界面
     * @param {string} prefabPath - 预制体路径
     */
    public hideUI(prefabPath: string) {
        const uiNode = this.uiCache.get(prefabPath);
        if (uiNode && isValid(uiNode)) {
            uiNode.active = false;
        }
    }

    /**
     * 销毁UI界面
     * @param {string} prefabPath - 预制体路径
     */
    public destroyUI(prefabPath: string) {
        const uiNode = this.uiCache.get(prefabPath);
        if (uiNode && isValid(uiNode)) {
            uiNode.destroy();
            this.uiCache.delete(prefabPath);
        }
    }
}

/** 导出实例 */
export const uiMgr = UIMgr.instance;