mirror of
https://gitee.com/dgflash/oops-plugin-framework.git
synced 2026-05-09 22:02:45 +08:00
388 lines
12 KiB
TypeScript
388 lines
12 KiB
TypeScript
import { Camera, Node, ResolutionPolicy, SafeArea, screen, view, warn } from "cc";
|
||
import { resLoader } from "../../common/loader/ResLoader";
|
||
import { oops } from "../../Oops";
|
||
import { gui } from "../Gui";
|
||
import { LayerDialog } from "./LayerDialog";
|
||
import { LayerCustomType, LayerTypeCls, UIConfigMap, Uiid } from "./LayerEnum";
|
||
import { LayerGame } from "./LayerGame";
|
||
import { LayerHelper } from "./LayerHelper";
|
||
import { LayerNotify } from "./LayerNotify";
|
||
import { LayerPopUp } from "./LayerPopup";
|
||
import { LayerUI } from "./LayerUI";
|
||
import { LayerUIElement, UICallbacks } from "./LayerUIElement";
|
||
import { UIConfig } from "./UIConfig";
|
||
|
||
/** 界面层级管理器 */
|
||
export class LayerManager {
|
||
/** 界面根节点 */
|
||
root!: Node;
|
||
/** 界面摄像机 */
|
||
camera!: Camera;
|
||
/** 游戏界面特效层 */
|
||
game!: LayerGame;
|
||
/** 新手引导层 */
|
||
guide!: Node;
|
||
|
||
/** 窗口宽高比例 */
|
||
windowAspectRatio: number = 0;
|
||
/** 设计宽高比例 */
|
||
designAspectRatio: number = 0;
|
||
/** 是否开启移动设备安全区域适配 */
|
||
mobileSafeArea: boolean = false;
|
||
|
||
/** 消息提示控制器，请使用show方法来显示 */
|
||
private notify!: LayerNotify;
|
||
/** 界面层集合 - 无自定义类型 */
|
||
private uiLayers: Map<string, LayerUI> = new Map();
|
||
/** 界面层组件集合 */
|
||
private clsLayers: Map<string, any> = new Map();
|
||
|
||
constructor() {
|
||
this.clsLayers.set(LayerTypeCls.UI, LayerUI);
|
||
this.clsLayers.set(LayerTypeCls.PopUp, LayerPopUp);
|
||
this.clsLayers.set(LayerTypeCls.Dialog, LayerDialog);
|
||
this.clsLayers.set(LayerTypeCls.Notify, LayerNotify);
|
||
this.clsLayers.set(LayerTypeCls.Game, LayerGame);
|
||
this.clsLayers.set(LayerTypeCls.Node, null);
|
||
}
|
||
|
||
/**
|
||
* 注册自定义界面层对象
|
||
* @param type 自定义界面层类型
|
||
* @param cls 自定义界面层对象
|
||
*/
|
||
registerLayerCls(type: string, cls: any) {
|
||
if (this.clsLayers.has(type)) {
|
||
console.error("已存在自定义界面层类型", type);
|
||
return;
|
||
}
|
||
this.clsLayers.set(type, cls);
|
||
}
|
||
|
||
/**
|
||
* 初始化界面层
|
||
* @param root 界面根节点
|
||
*/
|
||
private initLayer(root: Node, config: any) {
|
||
if (config == null) {
|
||
console.error("请升级到最新版本框架,界面层级管理修改为数据驱动。参考模板项目中的config.json配置文件");
|
||
return;
|
||
}
|
||
this.root = root;
|
||
this.initScreenAdapter();
|
||
this.camera = this.root.getComponentInChildren(Camera)!;
|
||
|
||
// 创建界面层
|
||
for (let i = 0; i < config.length; i++) {
|
||
let data = config[i];
|
||
let layer: Node = null!;
|
||
if (data.type == LayerTypeCls.Node) {
|
||
switch (data.name) {
|
||
case LayerCustomType.Guide:
|
||
this.guide = this.create_node(data.name);
|
||
layer = this.guide;
|
||
break
|
||
}
|
||
}
|
||
else {
|
||
let cls = this.clsLayers.get(data.type);
|
||
if (cls) {
|
||
layer = new cls(data.name);
|
||
}
|
||
else {
|
||
console.error("未识别的界面层类型", data.type);
|
||
}
|
||
}
|
||
root.addChild(layer);
|
||
|
||
if (layer instanceof LayerUI)
|
||
this.uiLayers.set(data.name, layer);
|
||
else if (layer instanceof LayerNotify)
|
||
this.notify = layer;
|
||
else if (layer instanceof LayerGame)
|
||
this.game = layer;
|
||
}
|
||
}
|
||
|
||
/** 初始化屏幕适配 */
|
||
private initScreenAdapter() {
|
||
const drs = view.getDesignResolutionSize();
|
||
const ws = screen.windowSize;
|
||
this.windowAspectRatio = ws.width / ws.height;
|
||
this.designAspectRatio = drs.width / drs.height;
|
||
|
||
let finalW: number = 0;
|
||
let finalH: number = 0;
|
||
|
||
if (this.windowAspectRatio > this.designAspectRatio) {
|
||
finalH = drs.height;
|
||
finalW = finalH * ws.width / ws.height;
|
||
oops.log.logView("适配屏幕高度", "【横屏】");
|
||
}
|
||
else {
|
||
finalW = drs.width;
|
||
finalH = finalW * ws.height / ws.width;
|
||
oops.log.logView("适配屏幕宽度", "【竖屏】");
|
||
}
|
||
view.setDesignResolutionSize(finalW, finalH, ResolutionPolicy.UNKNOWN);
|
||
|
||
if (this.mobileSafeArea) {
|
||
this.root.addComponent(SafeArea);
|
||
oops.log.logView("开启移动设备安全区域适配");
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 初始化所有UI的配置对象
|
||
* @param configs 配置对象
|
||
* @deprecated 后续将界面配置通过界面视图组件注册，使用gui.register注册每一个界面
|
||
*/
|
||
init(configs: UIConfigMap): void {
|
||
// this.configs = configs;
|
||
gui.initConfigs(configs);
|
||
}
|
||
|
||
/**
|
||
* 设置窗口打开失败回调
|
||
* @param callback 回调方法
|
||
*/
|
||
setOpenFailure(callback: Function) {
|
||
this.uiLayers.forEach((layer: LayerUI) => {
|
||
layer.onOpenFailure = callback;
|
||
})
|
||
}
|
||
|
||
/**
|
||
* 渐隐飘过提示
|
||
* @param content 文本表示
|
||
* @param useI18n 是否使用多语言
|
||
* @example
|
||
* oops.gui.toast("提示内容");
|
||
*/
|
||
toast(content: string, useI18n: boolean = false) {
|
||
this.notify.toast(content, useI18n)
|
||
}
|
||
|
||
/** 打开等待提示 */
|
||
waitOpen() {
|
||
this.notify.waitOpen();
|
||
}
|
||
|
||
/** 关闭等待提示 */
|
||
waitClose() {
|
||
this.notify.waitClose();
|
||
}
|
||
|
||
private getInfo(uiid: Uiid): { key: string; config: UIConfig } {
|
||
let key = "";
|
||
let config: UIConfig = null!;
|
||
|
||
// 确定 key 和 config
|
||
if (typeof uiid === 'object') {
|
||
if (uiid.bundle == null) uiid.bundle = resLoader.defaultBundleName;
|
||
key = uiid.bundle + "_" + uiid.prefab;
|
||
config = gui.getConfig(key);
|
||
if (config == null) {
|
||
config = uiid;
|
||
gui.setConfig(key, uiid);
|
||
}
|
||
}
|
||
else {
|
||
key = uiid.toString();
|
||
config = gui.getConfig(key);
|
||
if (config == null) {
|
||
console.error(`打开编号为【${uiid}】的界面失败，配置信息不存在`);
|
||
}
|
||
}
|
||
return { key, config };
|
||
}
|
||
|
||
/**
|
||
* 同步打开一个窗口
|
||
* @param uiid 窗口唯一编号
|
||
* @param uiArgs 窗口参数
|
||
* @param callbacks 回调对象
|
||
* @example
|
||
var uic: UICallbacks = {
|
||
onAdded: (node: Node, params: any) => {
|
||
var comp = node.getComponent(LoadingViewComp) as ecs.Comp;
|
||
}
|
||
onRemoved:(node: Node | null, params: any) => {
|
||
|
||
}
|
||
};
|
||
oops.gui.open(UIID.Loading, null, uic);
|
||
*/
|
||
open(uiid: Uiid, uiArgs: any = null, callbacks?: UICallbacks): void {
|
||
let info = this.getInfo(uiid);
|
||
let layer = this.uiLayers.get(info.config.layer);
|
||
if (layer) {
|
||
layer.add(info.key, info.config, uiArgs, callbacks);
|
||
}
|
||
else {
|
||
console.error(`打开编号为【${uiid}】的界面失败，界面层不存在`);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 异步打开一个窗口
|
||
* @param uiid 窗口唯一编号
|
||
* @param uiArgs 窗口参数
|
||
* @example
|
||
* var node = await oops.gui.openAsync(UIID.Loading);
|
||
*/
|
||
async openAsync(uiid: Uiid, uiArgs: any = null): Promise<Node | null> {
|
||
return new Promise<Node | null>((resolve, reject) => {
|
||
const callbacks: UICallbacks = {
|
||
onAdded: (node: Node, params: any) => {
|
||
resolve(node);
|
||
},
|
||
onLoadFailure: () => {
|
||
resolve(null);
|
||
}
|
||
};
|
||
this.open(uiid, uiArgs, callbacks);
|
||
});
|
||
}
|
||
|
||
/**
|
||
* 移除指定标识的窗口
|
||
* @param uiid 窗口唯一标识
|
||
* @param isDestroy 移除后是否释放（默认释放内存）
|
||
* @example
|
||
* oops.gui.remove(UIID.Loading);
|
||
*/
|
||
remove(uiid: Uiid, isDestroy: boolean = true) {
|
||
let info = this.getInfo(uiid);
|
||
let layer = this.uiLayers.get(info.config.layer);
|
||
if (layer) {
|
||
layer.remove(info.config.prefab, isDestroy);
|
||
}
|
||
else {
|
||
console.error(`移除编号为【${uiid}】的界面失败，界面层不存在`);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 通过界面节点移除
|
||
* @param node 窗口节点
|
||
* @param isDestroy 移除后是否释放资源（默认释放内存）
|
||
* @example
|
||
* oops.gui.removeByNode(cc.Node);
|
||
*/
|
||
removeByNode(node: Node, isDestroy: boolean = true) {
|
||
if (node instanceof Node) {
|
||
let comp = node.getComponent(LayerUIElement);
|
||
if (comp && comp.params) {
|
||
// 释放显示的界面
|
||
if (node.parent) {
|
||
let uiid = gui.getConfig(comp.params.uiid);
|
||
this.remove(uiid, isDestroy);
|
||
}
|
||
// 释放缓存中的界面
|
||
else if (isDestroy) {
|
||
let layer = this.uiLayers.get(comp.params.config.layer);
|
||
if (layer) {
|
||
// @ts-ignore 注：不对外使用
|
||
layer.removeCache(comp.params.config.prefab);
|
||
}
|
||
}
|
||
}
|
||
else {
|
||
warn(`当前删除的 Node 不是通过界面管理器添加的`);
|
||
node.destroy();
|
||
}
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 场景替换
|
||
* @param removeUiId 移除场景编号
|
||
* @param openUiId 新打开场景编号
|
||
* @param uiArgs 新打开场景参数
|
||
*/
|
||
replace(removeUiId: Uiid, openUiId: Uiid, uiArgs: any = null) {
|
||
const callbacks: UICallbacks = {
|
||
onAdded: (node: Node, params: any) => {
|
||
this.remove(removeUiId);
|
||
}
|
||
};
|
||
this.open(openUiId, uiArgs, callbacks);
|
||
}
|
||
|
||
/**
|
||
* 异步场景替换
|
||
* @param removeUiId 移除场景编号
|
||
* @param openUiId 新打开场景编号
|
||
* @param uiArgs 新打开场景参数
|
||
*/
|
||
replaceAsync(removeUiId: Uiid, openUiId: Uiid, uiArgs: any = null): Promise<Node | null> {
|
||
return new Promise<Node | null>(async (resolve, reject) => {
|
||
const node = await this.openAsync(openUiId, uiArgs);
|
||
if (node) {
|
||
this.remove(removeUiId);
|
||
resolve(node);
|
||
}
|
||
else {
|
||
resolve(null);
|
||
}
|
||
});
|
||
}
|
||
|
||
/**
|
||
* 缓存中是否存在指定标识的窗口
|
||
* @param uiid 窗口唯一标识
|
||
* @example
|
||
* oops.gui.has(UIID.Loading);
|
||
*/
|
||
has(uiid: Uiid): boolean {
|
||
let info = this.getInfo(uiid);
|
||
let result = false;
|
||
let layer = this.uiLayers.get(info.config.layer);
|
||
if (layer) {
|
||
result = layer.has(info.config.prefab);
|
||
}
|
||
else {
|
||
console.error(`验证编号为【${uiid}】的界面失败，界面层不存在`);
|
||
}
|
||
|
||
return result;
|
||
}
|
||
|
||
/**
|
||
* 缓存中是否存在指定标识的窗口
|
||
* @param uiid 窗口唯一标识
|
||
* @example
|
||
* oops.gui.has(UIID.Loading);
|
||
*/
|
||
get(uiid: Uiid): Node {
|
||
let info = this.getInfo(uiid);
|
||
let result: Node = null!;
|
||
let layer = this.uiLayers.get(info.config.layer);
|
||
if (layer) {
|
||
result = layer.get(info.config.prefab);
|
||
}
|
||
else {
|
||
console.error(`获取编号为【${uiid}】的界面失败，界面层不存在`);
|
||
}
|
||
return result;
|
||
}
|
||
|
||
/**
|
||
* 清除所有窗口
|
||
* @param isDestroy 移除后是否释放
|
||
* @example
|
||
* oops.gui.clear();
|
||
*/
|
||
clear(isDestroy: boolean = true) {
|
||
this.uiLayers.forEach((layer: LayerUI) => {
|
||
layer.clear(isDestroy);
|
||
})
|
||
}
|
||
|
||
private create_node(name: string) {
|
||
const node = new Node(name);
|
||
LayerHelper.setFullScreen(node);
|
||
return node;
|
||
}
|
||
} |