oops-plugin-framework/assets/module/common/ModuleUtil.ts

import {Node, __private} from "cc";
import {oops} from "../../core/Oops";
import {UICallbacks} from "../../core/gui/layer/Defines";
import {ViewUtil} from "../../core/utils/ViewUtil";
import {ecs} from "../../libs/ecs/ECS";
import {CompType} from "../../libs/ecs/ECSModel";
import {CCComp} from "./CCComp";
import {CCVMParentComp} from "./CCVMParentComp";

export class ModuleUtil {
    /**
     * 添加界面组件
     * @param ent      模块实体
     * @param ctor     界面逻辑组件
     * @param uiId     界面资源编号
     * @param uiArgs   界面参数
     */
    public static addViewUi<T extends CCVMParentComp | CCComp>(
        ent: ecs.Entity,
        ctor: __private.__types_globals__Constructor<T> | __private.__types_globals__AbstractedConstructor<T>,
        uiId: number,
        uiArgs: any = null) {
        const uic: UICallbacks = {
            onAdded: (node: Node, params: any) => {
                const comp = node.getComponent(ctor) as ecs.Comp;
                ent.add(comp);
            }
        };
        oops.gui.open(uiId, uiArgs, uic);
    }

    /**
     * 异步添加视图层组件
     * @param ent      模块实体
     * @param ctor     界面逻辑组件
     * @param uiId     界面资源编号
     * @param uiArgs   界面参数
     * @returns 界面节点
     */
    public static addViewUiAsync<T extends CCVMParentComp | CCComp>(
        ent: ecs.Entity,
        ctor: __private.__types_globals__Constructor<T> | __private.__types_globals__AbstractedConstructor<T>,
        uiId: number,
        uiArgs: any = null): Promise<Node | null> {
        return new Promise<Node | null>((resolve, reject) => {
            const uic: UICallbacks = {
                onAdded: (node: Node, params: any) => {
                    const comp = node.getComponent(ctor) as ecs.Comp;
                    ent.add(comp);
                    resolve(node);
                },
                onLoadFailure: () => {
                    resolve(null);
                }
            };
            oops.gui.open(uiId, uiArgs, uic);
        });
    }

    /**
     * 通过资源内存中获取预制上的组件添加到ECS实体中
     * @param ent      模块实体
     * @param ctor     界面逻辑组件
     * @param parent   显示对象父级
     * @param url      显示资源地址
     */
    public static addView<T extends CCVMParentComp | CCComp>(
        ent: ecs.Entity,
        ctor: __private.__types_globals__Constructor<T> | __private.__types_globals__AbstractedConstructor<T>,
        parent: Node,
        url: string) {
        const node = ViewUtil.createPrefabNode(url);
        const comp = node.getComponent(ctor)!;
        ent.add(comp);
        node.parent = parent;
    }

    /**
     * 业务实体上移除界面组件
     * @param ent        模块实体
     * @param ctor       界面逻辑组件
     * @param uiId       界面资源编号
     * @param isDestroy  是否释放界面缓存（默认为释放界面缓存）
     */
    public static removeViewUi(ent: ecs.Entity, ctor: CompType<ecs.IComp>, uiId: number, isDestroy: boolean = true) {
        ent.remove(ctor, isDestroy);
        oops.gui.remove(uiId, isDestroy);
    }
}