@chiyou/minigame-framework 1.3.0 → 1.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chiyou/minigame-framework",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "基于 Cocos Creator 3.x 的小游戏开发框架，支持多平台发布",
   "main": "src/index.ts",
   "types": "src/index.ts",

package/src/Framework/Adapter/PlatformAdapter/PlatformAdapterBilibili.ts

@@ -265,12 +265,38 @@ export class PlatformAdapterBilibili extends AbsPlatformAdapter {
     }
 
     public getScreenInfo(): ScreenInfo {
-        let screenInfo: ScreenInfo = new ScreenInfo(0, 0, 0, 0);
+        let screenInfo: ScreenInfo = new ScreenInfo(0, 0, 0, 0, {
+            left: 0, right: 0, top: 0,bottom: 0,
+            width: 0, height: 0
+        });
 
         if (window["bl"] && window["bl"].getSystemInfoSync) {
             let systemInfo: any = window["bl"].getSystemInfoSync();
             if (systemInfo !== null) {
-                screenInfo = new ScreenInfo(screenInfo.windowWidth, screenInfo.windowHeight, systemInfo.screenWidth, systemInfo.screenHeight);
+                screenInfo.screenWidth = systemInfo.screenWidth;
+                screenInfo.screenHeight = systemInfo.screenHeight;
+                screenInfo.windowWidth = systemInfo.windowWidth;
+                screenInfo.windowHeight = systemInfo.windowHeight;
+
+                if (systemInfo.safeArea !== null) {
+                    screenInfo.safeArea = {
+                        left: systemInfo.safeArea.left,
+                        right: systemInfo.safeArea.right,
+                        top: systemInfo.safeArea.top,
+                        bottom: systemInfo.safeArea.bottom,
+                        width: systemInfo.safeArea.width,
+                        height: systemInfo.safeArea.height,
+                    }
+                } else {
+                    screenInfo.safeArea = {
+                        left: 0,
+                        right: systemInfo.screenWidth,
+                        top: 0,
+                        bottom: systemInfo.screenHeight,
+                        width: systemInfo.screenWidth,
+                        height: systemInfo.screenHeight,
+                    }
+                }
             }
         }
 

package/src/Framework/Adapter/PlatformAdapter/PlatformAdapterDesktopBrowser.ts

@@ -113,7 +113,14 @@ export class PlatformAdapterDesktopBrowser extends AbsPlatformAdapter {
     }
 
     public getScreenInfo(): ScreenInfo {
-        let screenInfo: ScreenInfo = new ScreenInfo(screen.width, screen.height, screen.width, screen.height);
+        let screenWidth = screen.width;
+        let screenHeight = screen.height;
+
+        let screenInfo: ScreenInfo = new ScreenInfo(
+            screenWidth, screenHeight, screenWidth, screenHeight, {
+            left: 0, right: screenWidth, top: 0,bottom: screenHeight,
+            width: screenWidth, height: screenHeight
+        });
 
         LogUtils.Instance.info(PlatformAdapterDesktopBrowser.TAG, "获取屏幕信息", {
             operation: "getScreenInfo",

package/src/Framework/Adapter/PlatformAdapter/PlatformAdapterDouYin.ts

@@ -281,12 +281,38 @@ export class PlatformAdapterDouYin extends AbsPlatformAdapter {
     }
 
     public getScreenInfo(): ScreenInfo {
-        let screenInfo: ScreenInfo = new ScreenInfo(0, 0, 0, 0);
+        let screenInfo: ScreenInfo = new ScreenInfo(0, 0, 0, 0, {
+            left: 0, right: 0, top: 0,bottom: 0,
+            width: 0, height: 0
+        });
 
         if (window["tt"] && window["tt"].getSystemInfoSync) {
             let systemInfo: any = window["tt"].getSystemInfoSync();
             if (systemInfo !== null) {
-                screenInfo = new ScreenInfo(systemInfo.windowWidth, systemInfo.windowHeight, systemInfo.screenWidth, systemInfo.screenHeight);
+                screenInfo.screenWidth = systemInfo.screenWidth;
+                screenInfo.screenHeight = systemInfo.screenHeight;
+                screenInfo.windowWidth = systemInfo.windowWidth;
+                screenInfo.windowHeight = systemInfo.windowHeight;
+
+                if (systemInfo.safeArea !== null) {
+                    screenInfo.safeArea = {
+                        left: systemInfo.safeArea.left,
+                        right: systemInfo.safeArea.right,
+                        top: systemInfo.safeArea.top,
+                        bottom: systemInfo.safeArea.bottom,
+                        width: systemInfo.safeArea.width,
+                        height: systemInfo.safeArea.height,
+                    }
+                } else {
+                    screenInfo.safeArea = {
+                        left: 0,
+                        right: systemInfo.screenWidth,
+                        top: 0,
+                        bottom: systemInfo.screenHeight,
+                        width: systemInfo.screenWidth,
+                        height: systemInfo.screenHeight,
+                    }
+                }
             }
         }
 

package/src/Framework/Adapter/PlatformAdapter/PlatformAdapterHonor.ts

@@ -187,12 +187,38 @@ export class PlatformAdapterHonor extends AbsPlatformAdapter {
     }
 
     public getScreenInfo(): ScreenInfo {
-        let screenInfo: ScreenInfo = new ScreenInfo(0, 0, 0, 0);
+        let screenInfo: ScreenInfo = new ScreenInfo(0, 0, 0, 0, {
+            left: 0, right: 0, top: 0,bottom: 0,
+            width: 0, height: 0
+        });
 
-        if (window["qg"] && window["qg"].getWindowInfo) {
-            let windowInfo: any = window["qg"].getWindowInfo();
-            if (windowInfo !== null) {
-                screenInfo = new ScreenInfo(windowInfo.windowWidth, windowInfo.windowHeight, windowInfo.screenWidth, windowInfo.screenHeight);
+        if (window["qg"] && window["qg"].getSystemInfoSync) {
+            let systemInfo: any = window["qg"].getSystemInfoSync();
+            if (systemInfo !== null) {
+                screenInfo.screenWidth = systemInfo.screenWidth;
+                screenInfo.screenHeight = systemInfo.screenHeight;
+                screenInfo.windowWidth = systemInfo.windowWidth;
+                screenInfo.windowHeight = systemInfo.windowHeight;
+
+                if (systemInfo.safeArea !== null) {
+                    screenInfo.safeArea = {
+                        left: systemInfo.safeArea.left,
+                        right: systemInfo.safeArea.right,
+                        top: systemInfo.safeArea.top,
+                        bottom: systemInfo.safeArea.bottom,
+                        width: systemInfo.safeArea.width,
+                        height: systemInfo.safeArea.height,
+                    }
+                } else {
+                    screenInfo.safeArea = {
+                        left: 0,
+                        right: systemInfo.screenWidth,
+                        top: 0,
+                        bottom: systemInfo.screenHeight,
+                        width: systemInfo.screenWidth,
+                        height: systemInfo.screenHeight,
+                    }
+                }
             }
         }
         

package/src/Framework/Adapter/PlatformAdapter/PlatformAdapterHuaWei.ts

@@ -184,7 +184,40 @@ export class PlatformAdapterHuaWei extends AbsPlatformAdapter {
     }
 
     public getScreenInfo(): ScreenInfo {
-        let screenInfo: ScreenInfo = new ScreenInfo(screen.availWidth, screen.availHeight, screen.width, screen.height);
+        let screenInfo: ScreenInfo = new ScreenInfo(0, 0, 0, 0, {
+            left: 0, right: 0, top: 0,bottom: 0,
+            width: 0, height: 0
+        });
+
+        if (window["qg"] && window["qg"].getSystemInfoSync) {
+            let systemInfo: any = window["qg"].getSystemInfoSync();
+            if (systemInfo !== null) {
+                screenInfo.screenWidth = systemInfo.screenWidth;
+                screenInfo.screenHeight = systemInfo.screenHeight;
+                screenInfo.windowWidth = systemInfo.windowWidth;
+                screenInfo.windowHeight = systemInfo.windowHeight;
+
+                if (systemInfo.safeArea !== null) {
+                    screenInfo.safeArea = {
+                        left: systemInfo.safeArea.left,
+                        right: systemInfo.safeArea.right,
+                        top: systemInfo.safeArea.top,
+                        bottom: systemInfo.safeArea.bottom,
+                        width: systemInfo.safeArea.width,
+                        height: systemInfo.safeArea.height,
+                    }
+                } else {
+                    screenInfo.safeArea = {
+                        left: 0,
+                        right: systemInfo.screenWidth,
+                        top: 0,
+                        bottom: systemInfo.screenHeight,
+                        width: systemInfo.screenWidth,
+                        height: systemInfo.screenHeight,
+                    }
+                }
+            }
+        }
 
         LogUtils.Instance.info(PlatformAdapterHuaWei.TAG, "获取屏幕信息", {
             operation: "getScreenInfo",

package/src/Framework/Adapter/PlatformAdapter/PlatformAdapterKuaiShou.ts

@@ -222,12 +222,38 @@ export class PlatformAdapterKuaiShou extends AbsPlatformAdapter {
     }
 
     public getScreenInfo(): ScreenInfo {
-        let screenInfo: ScreenInfo = new ScreenInfo(0, 0, 0, 0);
+        let screenInfo: ScreenInfo = new ScreenInfo(0, 0, 0, 0, {
+            left: 0, right: 0, top: 0,bottom: 0,
+            width: 0, height: 0
+        });
 
         if (window["ks"] && window["ks"].getSystemInfoSync) {
             let systemInfo: any = window["ks"].getSystemInfoSync();
             if (systemInfo !== null) {
-                screenInfo = new ScreenInfo(systemInfo.windowWidth, systemInfo.windowHeight, systemInfo.screenWidth, systemInfo.screenHeight);
+                screenInfo.screenWidth = systemInfo.screenWidth;
+                screenInfo.screenHeight = systemInfo.screenHeight;
+                screenInfo.windowWidth = systemInfo.windowWidth;
+                screenInfo.windowHeight = systemInfo.windowHeight;
+
+                if (systemInfo.safeArea !== null) {
+                    screenInfo.safeArea = {
+                        left: systemInfo.safeArea.left,
+                        right: systemInfo.safeArea.right,
+                        top: systemInfo.safeArea.top,
+                        bottom: systemInfo.safeArea.bottom,
+                        width: systemInfo.safeArea.width,
+                        height: systemInfo.safeArea.height,
+                    }
+                } else {
+                    screenInfo.safeArea = {
+                        left: 0,
+                        right: systemInfo.screenWidth,
+                        top: 0,
+                        bottom: systemInfo.screenHeight,
+                        width: systemInfo.screenWidth,
+                        height: systemInfo.screenHeight,
+                    }
+                }
             }
         }
 

package/src/Framework/Adapter/PlatformAdapter/PlatformAdapterOppo.ts

@@ -187,12 +187,27 @@ export class PlatformAdapterOppo extends AbsPlatformAdapter {
     }
 
     public getScreenInfo(): ScreenInfo {
-        let screenInfo: ScreenInfo = new ScreenInfo(0, 0, 0, 0);
+        let screenInfo: ScreenInfo = new ScreenInfo(0, 0, 0, 0, {
+            left: 0, right: 0, top: 0,bottom: 0,
+            width: 0, height: 0
+        });
 
         if (window["qg"] && window["qg"].getSystemInfoSync) {
             let systemInfo: any = window["qg"].getSystemInfoSync();
             if (systemInfo !== null) {
-                screenInfo = new ScreenInfo(systemInfo.windowWidth, systemInfo.windowHeight, systemInfo.screenWidth, systemInfo.screenHeight);
+                screenInfo.screenWidth = systemInfo.screenWidth;
+                screenInfo.screenHeight = systemInfo.screenHeight;
+                screenInfo.windowWidth = systemInfo.windowWidth;
+                screenInfo.windowHeight = systemInfo.windowHeight;
+
+                screenInfo.safeArea = {
+                    left: 0,
+                    right: systemInfo.screenWidth,
+                    top: 0,
+                    bottom: systemInfo.screenHeight,
+                    width: systemInfo.screenWidth,
+                    height: systemInfo.screenHeight,
+                }
             }
         }
 

package/src/Framework/Adapter/PlatformAdapter/PlatformAdapterTapTap.ts

@@ -202,12 +202,38 @@ export class PlatformAdapterTapTap extends AbsPlatformAdapter {
     }
 
     public getScreenInfo(): ScreenInfo {
-        let screenInfo: ScreenInfo = new ScreenInfo(0, 0, 0, 0);
+        let screenInfo: ScreenInfo = new ScreenInfo(0, 0, 0, 0, {
+            left: 0, right: 0, top: 0,bottom: 0,
+            width: 0, height: 0
+        });
 
-        if (window["tap"] && window["tap"].getSystemInfoSync) {
-            let systemInfo: any = window["tap"].getSystemInfoSync();
-            if (systemInfo !== null) {
-                screenInfo = new ScreenInfo(systemInfo.windowWidth, systemInfo.windowHeight, systemInfo.screenWidth, systemInfo.screenHeight);
+        if (window["tap"] && window["tap"].getWindowInfo) {
+            let windowInfo: any = window["tap"].getWindowInfo();
+            if (windowInfo !== null) {
+                screenInfo.screenWidth = windowInfo.screenWidth;
+                screenInfo.screenHeight = windowInfo.screenHeight;
+                screenInfo.windowWidth = windowInfo.windowWidth;
+                screenInfo.windowHeight = windowInfo.windowHeight;
+
+                if (windowInfo.safeArea !== null) {
+                    screenInfo.safeArea = {
+                        left: windowInfo.safeArea.left,
+                        right: windowInfo.safeArea.right,
+                        top: windowInfo.safeArea.top,
+                        bottom: windowInfo.safeArea.bottom,
+                        width: windowInfo.safeArea.width,
+                        height: windowInfo.safeArea.height,
+                    }
+                } else {
+                    screenInfo.safeArea = {
+                        left: 0,
+                        right: windowInfo.screenWidth,
+                        top: 0,
+                        bottom: windowInfo.screenHeight,
+                        width: windowInfo.screenWidth,
+                        height: windowInfo.screenHeight,
+                    }
+                }
             }
         }
 

package/src/Framework/Adapter/PlatformAdapter/PlatformAdapterVivo.ts

@@ -175,12 +175,40 @@ export class PlatformAdapterVivo extends AbsPlatformAdapter {
     }
 
     public getScreenInfo(): ScreenInfo {
-        let screenInfo: ScreenInfo = new ScreenInfo(0, 0, 0, 0);
+        let screenInfo: ScreenInfo = new ScreenInfo(0, 0, 0, 0, {
+            left: 0, right: 0, top: 0,bottom: 0,
+            width: 0, height: 0
+        });
 
-        if (window["qg"] && window["qg"].getWindowInfo) {
+        if (window["qg"] && window["qg"].getWindowInfo && window["qg"].getSystemInfoSync) {
+            let systemInfo: any = window["qg"].getSystemInfoSync();
             let windowInfo: any = window["qg"].getWindowInfo();
-            if (windowInfo !== null) {
-                screenInfo = new ScreenInfo(windowInfo.windowWidth, windowInfo.windowHeight, windowInfo.windowWidth, windowInfo.windowHeight);
+
+            if (windowInfo !== null && systemInfo !== null) {
+                screenInfo.screenWidth = systemInfo.screenWidth;
+                screenInfo.screenHeight = systemInfo.screenHeight;
+                screenInfo.windowWidth = windowInfo.windowWidth;
+                screenInfo.windowHeight = windowInfo.windowHeight;
+
+                if (windowInfo.safeArea !== null) {
+                    screenInfo.safeArea = {
+                        left: windowInfo.safeArea.left,
+                        right: windowInfo.safeArea.right,
+                        top: windowInfo.safeArea.top,
+                        bottom: windowInfo.safeArea.bottom,
+                        width: windowInfo.safeArea.width,
+                        height: windowInfo.safeArea.height,
+                    }
+                } else {
+                    screenInfo.safeArea = {
+                        left: 0,
+                        right: systemInfo.screenWidth,
+                        top: 0,
+                        bottom: systemInfo.screenHeight,
+                        width: systemInfo.screenWidth,
+                        height: systemInfo.screenHeight,
+                    }
+                }
             }
         }
 

package/src/Framework/Adapter/PlatformAdapter/PlatformAdapterWeiXin.ts

@@ -342,12 +342,38 @@ export class PlatformAdapterWeiXin extends AbsPlatformAdapter {
     }
 
     public getScreenInfo(): ScreenInfo {
-        let screenInfo: ScreenInfo = new ScreenInfo(0, 0, 0, 0);
+        let screenInfo: ScreenInfo = new ScreenInfo(0, 0, 0, 0, {
+            left: 0, right: 0, top: 0,bottom: 0,
+            width: 0, height: 0
+        });
 
         if (window["wx"] && window["wx"].getWindowInfo) {
             let windowInfo: any = window["wx"].getWindowInfo();
             if (windowInfo !== null) {
-                screenInfo = new ScreenInfo(windowInfo.windowWidth, windowInfo.windowHeight, windowInfo.screenWidth, windowInfo.screenHeight);
+                screenInfo.screenWidth = windowInfo.screenWidth;
+                screenInfo.screenHeight = windowInfo.screenHeight;
+                screenInfo.windowWidth = windowInfo.windowWidth;
+                screenInfo.windowHeight = windowInfo.windowHeight;
+
+                if (windowInfo.safeArea !== null) {
+                    screenInfo.safeArea = {
+                        left: windowInfo.safeArea.left,
+                        right: windowInfo.safeArea.right,
+                        top: windowInfo.safeArea.top,
+                        bottom: windowInfo.safeArea.bottom,
+                        width: windowInfo.safeArea.width,
+                        height: windowInfo.safeArea.height,
+                    }
+                } else {
+                    screenInfo.safeArea = {
+                        left: 0,
+                        right: windowInfo.screenWidth,
+                        top: 0,
+                        bottom: windowInfo.screenHeight,
+                        width: windowInfo.screenWidth,
+                        height: windowInfo.screenHeight,
+                    }
+                }
             }
         }
 

package/src/Framework/Adapter/PlatformAdapter/PlatformAdapterXiaoMi.ts

@@ -182,12 +182,38 @@ export class PlatformAdapterXiaoMi extends AbsPlatformAdapter {
     }
 
     public getScreenInfo(): ScreenInfo {
-        let screenInfo: ScreenInfo = new ScreenInfo(0, 0, 0, 0);
+        let screenInfo: ScreenInfo = new ScreenInfo(0, 0, 0, 0, {
+            left: 0, right: 0, top: 0,bottom: 0,
+            width: 0, height: 0
+        });
 
-        if (window["qg"] && window["qg"].getWindowInfo) {
-            let windowInfo: any = window["qg"].getWindowInfo();
-            if (windowInfo !== null) {
-                screenInfo = new ScreenInfo(windowInfo.windowWidth, windowInfo.windowHeight, windowInfo.windowWidth, windowInfo.windowHeight);
+        if (window["qg"] && window["qg"].getSystemInfoSync) {
+            let systemInfo: any = window["qg"].getSystemInfoSync();
+            if (systemInfo !== null) {
+                screenInfo.screenWidth = systemInfo.screenWidth;
+                screenInfo.screenHeight = systemInfo.screenHeight;
+                screenInfo.windowWidth = systemInfo.windowWidth;
+                screenInfo.windowHeight = systemInfo.windowHeight;
+
+                if (systemInfo.safeArea !== null) {
+                    screenInfo.safeArea = {
+                        left: systemInfo.safeArea.left,
+                        right: systemInfo.safeArea.right,
+                        top: systemInfo.safeArea.top,
+                        bottom: systemInfo.safeArea.bottom,
+                        width: systemInfo.safeArea.width,
+                        height: systemInfo.safeArea.height,
+                    }
+                } else {
+                    screenInfo.safeArea = {
+                        left: 0,
+                        right: systemInfo.screenWidth,
+                        top: 0,
+                        bottom: systemInfo.screenHeight,
+                        width: systemInfo.screenWidth,
+                        height: systemInfo.screenHeight,
+                    }
+                }
             }
         }
 

package/src/Framework/Adapter/PlatformAdapter/PlatformAdapterZhiFuBao.ts

@@ -179,12 +179,38 @@ export class PlatformAdapterZhiFuBao extends AbsPlatformAdapter {
     }
 
     public getScreenInfo(): ScreenInfo {
-        let screenInfo: ScreenInfo = new ScreenInfo(0, 0, 0, 0);
+        let screenInfo: ScreenInfo = new ScreenInfo(0, 0, 0, 0, {
+            left: 0, right: 0, top: 0,bottom: 0,
+            width: 0, height: 0
+        });
 
-        if (window["my"] && window["my"].getSystemInfoSync) {
-            let systemInfo: any = window["my"].getSystemInfoSync();
-            if (systemInfo !== null) {
-                screenInfo = new ScreenInfo(systemInfo.windowWidth, systemInfo.windowHeight, systemInfo.screenWidth, systemInfo.screenHeight);
+        if (window["my"] && window["my"].getWindowInfo) {
+            let windowInfo: any = window["my"].getWindowInfo();
+            if (windowInfo !== null) {
+                screenInfo.screenWidth = windowInfo.screenWidth;
+                screenInfo.screenHeight = windowInfo.screenHeight;
+                screenInfo.windowWidth = windowInfo.windowWidth;
+                screenInfo.windowHeight = windowInfo.windowHeight;
+
+                if (windowInfo.safeArea !== null) {
+                    screenInfo.safeArea = {
+                        left: windowInfo.safeArea.left,
+                        right: windowInfo.safeArea.right,
+                        top: windowInfo.safeArea.top,
+                        bottom: windowInfo.safeArea.bottom,
+                        width: windowInfo.safeArea.width,
+                        height: windowInfo.safeArea.height,
+                    }
+                } else {
+                    screenInfo.safeArea = {
+                        left: 0,
+                        right: windowInfo.screenWidth,
+                        top: 0,
+                        bottom: windowInfo.screenHeight,
+                        width: windowInfo.screenWidth,
+                        height: windowInfo.screenHeight,
+                    }
+                }
             }
         }
 

package/src/Framework/Definition/SystemDefinition.ts

@@ -25,17 +25,28 @@ export type AppItem = {
     appIDMap: Map<PlatformID, string>;
 }
 
+export interface ISafeArea {
+    left: number; // 安全区左边界 X
+    right: number; // 安全区右边界 X
+    top: number; // 安全区上边界 Y（刘海高度）
+    bottom: number; // 安全区下边界 Y
+    width: number; // 安全区宽度，单位逻辑像素
+    height: number; // 安全区高度，单位逻辑像素
+}
+
 export class ScreenInfo {
     windowWidth: number;
     windowHeight: number;
     screenWidth: number;
     screenHeight: number;
+    safeArea: ISafeArea;
 
-    constructor(windowWidth: number, windowHeight: number, screenWidth: number, screenHeight: number) {
+    constructor(windowWidth: number, windowHeight: number, screenWidth: number, screenHeight: number, safeArea: ISafeArea) {
         this.windowWidth = windowWidth;
         this.windowHeight = windowHeight;
         this.screenWidth = screenWidth;
         this.screenHeight = screenHeight;
+        this.safeArea = safeArea;
     }
 }
 

package/src/Framework/Definition/UIDefinition.ts

@@ -2,4 +2,10 @@
 export enum ToastDuration {
     Duration_Short = 1,
     Duration_Long = 2,
+}
+
+export enum ToastPosition {
+    Top = 0,
+    Center = 1,
+    Bottom = 2,
 }

package/src/Framework/Manager/AudioMgr.ts

@@ -1,4 +1,4 @@
-import { AudioClip, AudioSource } from "cc";
+import { AudioClip, AudioSource, Node } from "cc";
 import { LogUtils } from "../Utils/LogUtils";
 import { PlatformID } from "../Definition/SystemDefinition";
 import { FrameworkBase } from "../Definition/FrameworkBase";
@@ -15,7 +15,9 @@ export class AudioMgr extends BaseMgr {
     static TAG: string = "AudioMgr";
 
     private effectSwitch: boolean = false;
-    private effectAudioSource: AudioSource = null;
+    private effectPool: AudioSource[] = [];
+    /** 音效池最大同时播放数量 */
+    private static readonly EFFECT_POOL_SIZE: number = 8;
 
     private musicSwitch: boolean = false;
     private musicAudioSource: AudioSource = null;
@@ -39,11 +41,11 @@ export class AudioMgr extends BaseMgr {
      * 初始化音频管理器
      */
     public init(): void {
-        this.effectAudioSource = this.node.addComponent(AudioSource);
         this.musicAudioSource = this.node.addComponent(AudioSource);
 
+        this._initEffectPool();
+
         this.effectSwitch = false;
-        this.effectAudioSource.volume = 0;
 
         this.musicSwitch = false;
         this.musicAudioSource.volume = 0;
@@ -163,7 +165,9 @@ export class AudioMgr extends BaseMgr {
         LogUtils.Instance.info(AudioMgr.TAG, "开启音效");
 
         this.effectSwitch = true;
-        this.effectAudioSource.volume = 1;
+        for (let i = 0; i < this.effectPool.length; i++) {
+            this.effectPool[i].volume = 1;
+        }
     }
 
     /** 关闭音效 */
@@ -175,7 +179,52 @@ export class AudioMgr extends BaseMgr {
         LogUtils.Instance.info(AudioMgr.TAG, "关闭音效");
 
         this.effectSwitch = false;
-        this.effectAudioSource.volume = 0;
+        for (let i = 0; i < this.effectPool.length; i++) {
+            this.effectPool[i].volume = 0;
+        }
+    }
+
+    /**
+     * 初始化音效池（内部方法）
+     */
+    private _initEffectPool(): void {
+        for (let i = 0; i < AudioMgr.EFFECT_POOL_SIZE; i++) {
+            let node: Node = new Node("EffectAudio_" + i);
+            node.setParent(this.node);
+            let audioSource: AudioSource = node.addComponent(AudioSource);
+            audioSource.volume = 0;
+            // 监听 ended 事件，播完后清 clip 以便下次复用
+            audioSource.node.on(AudioSource.EventType.ENDED, () => {
+                audioSource.clip = null;
+            });
+            this.effectPool.push(audioSource);
+        }
+    }
+
+    /**
+     * 从池中找空闲 AudioSource 播放音效（内部方法）
+     */
+    private _playEffectWithPool(clip: AudioClip): void {
+        // 找一个当前未在播放的 AudioSource
+        let audioSource: AudioSource = null;
+        for (let i = 0; i < this.effectPool.length; i++) {
+            if (!this.effectPool[i].playing) {
+                audioSource = this.effectPool[i];
+                break;
+            }
+        }
+
+        // 池已满，跳过此次播放
+        if (audioSource === null) {
+            LogUtils.Instance.warn(AudioMgr.TAG, "音效池已满（8个全部占用），跳过此次播放", {
+                operation: "_playEffectWithPool",
+                poolSize: this.effectPool.length
+            });
+            return;
+        }
+
+        audioSource.clip = clip;
+        audioSource.play();
     }
 
     /**
@@ -201,7 +250,7 @@ export class AudioMgr extends BaseMgr {
                 });
                 return;
             }
-            this.effectAudioSource.playOneShot(audioClip);
+            this._playEffectWithPool(audioClip);
         }
     }
 

package/src/Framework/Manager/InputMgr.ts

@@ -625,6 +625,36 @@ export class InputMgr extends BaseMgr {
         }
     }
 
+    /**
+     * 监听键盘按下（一次性）
+     * 触发一次后自动移除监听
+     * @param keyCode 按键码（KeyCode），KeyCode.NONE 表示监听所有按键
+     * @param callback 回调函数
+     * @param target 回调目标
+     */
+    public onceKeyDown(keyCode: KeyCode, callback: (event: EventKeyboard) => void, target: any): void {
+        let onceCallback = (event: EventKeyboard) => {
+            this.offKeyDown(keyCode, onceCallback, target);
+            callback.apply(target, [event]);
+        };
+        this.onKeyDown(keyCode, onceCallback, target);
+    }
+
+    /**
+     * 监听键盘抬起（一次性）
+     * 触发一次后自动移除监听
+     * @param keyCode 按键码（KeyCode），KeyCode.NONE 表示监听所有按键
+     * @param callback 回调函数
+     * @param target 回调目标
+     */
+    public onceKeyUp(keyCode: KeyCode, callback: (event: EventKeyboard) => void, target: any): void {
+        let onceCallback = (event: EventKeyboard) => {
+            this.offKeyUp(keyCode, onceCallback, target);
+            callback.apply(target, [event]);
+        };
+        this.onKeyUp(keyCode, onceCallback, target);
+    }
+
     /**
      * 判断按键是否处于按下状态
      * @param keyCode 按键码（KeyCode）
@@ -891,6 +921,22 @@ export class InputMgr extends BaseMgr {
         }
     }
 
+    /**
+     * 监听按钮点击（一次性）
+     * 触发一次后自动移除监听
+     * @param button 按钮节点
+     * @param callback 回调函数
+     * @param target 回调目标
+     * @param preventAccidental 是否防误触（连续点击），默认 true
+     */
+    public onceButtonClick(button: Node, callback: () => void, target: any, preventAccidental: boolean = true): void {
+        let onceCallback = () => {
+            this.offButtonClick(button, onceCallback, target);
+            callback.apply(target);
+        };
+        this.onButtonClick(button, onceCallback, target, preventAccidental);
+    }
+
     // ==================== 节点触摸事件（对外） ====================
 
     /**
@@ -1019,6 +1065,21 @@ export class InputMgr extends BaseMgr {
         }
     }
 
+    /**
+     * 监听节点触摸结束（一次性）
+     * 触发一次后自动移除监听
+     * @param node 节点
+     * @param callback 回调函数
+     * @param target 回调目标
+     */
+    public onceNodeTouchEnd(node: Node, callback: (touch: Touch) => void, target: any): void {
+        let onceCallback = (touch: Touch) => {
+            this.offNodeTouchEnd(node, onceCallback, target);
+            callback.apply(target, [touch]);
+        };
+        this.onNodeTouchEnd(node, onceCallback, target);
+    }
+
     /**
      * 移除节点触摸事件
      */

package/src/Framework/Manager/NodePoolMgr.ts

@@ -25,6 +25,8 @@ export interface IPoolStatistics {
     nowActiveCount: number;
     /** 历史最大活跃节点数 */
     maxActiveCount: number;
+    /** 当前可用节点数 */
+    availableCount: number;
     /** 最后访问时间 */
     lastAccessTime: number;
 }
@@ -49,6 +51,7 @@ export class PoolInfo {
             reusedCount: 0,
             nowActiveCount: 0,
             maxActiveCount: 0,
+            availableCount: 0,
             lastAccessTime: Date.now(),
         };
     }
@@ -229,8 +232,9 @@ export class NodePoolMgr extends BaseMgr {
                     reusedCount: 0,
                     nowActiveCount: 0,
                     maxActiveCount: 0,
+                    availableCount: 0,
                     lastAccessTime: Date.now(),
-                }
+                };
             }
         }
 
@@ -475,6 +479,13 @@ export class NodePoolMgr extends BaseMgr {
         }
 
         let poolInfo: PoolInfo = this._poolInfoMap.get(poolName);
+        if (!poolInfo) {
+            LogUtils.Instance.error(NodePoolMgr.TAG, FwkErrorCode.NodePool.NotFound, {
+                operation: "_destoryNode",
+                poolName: poolName,
+                reason: "节点池信息获取失败"
+            });
+        }
 
         if (this.uiMgr === null) {
             this.uiMgr = ServiceLocator.Instance.get<UIMgr>("UIMgr");
@@ -545,6 +556,52 @@ export class NodePoolMgr extends BaseMgr {
         node.scale = Vec3.ONE;
     }
 
+    /**
+     * 检查节点池是否存在
+     * @param poolName 节点池名称
+     */
+    public hasPool(poolName: string): boolean {
+        return this._poolInfoMap.has(poolName);
+    }
+
+    /**
+     * 获取指定节点池的统计信息
+     * @param poolName 节点池名称
+     */
+    public getPoolStats(poolName: string): IPoolStatistics | null {
+        let poolInfo: PoolInfo = this._poolInfoMap.get(poolName);
+        if (!poolInfo) {
+            return null;
+        }
+
+        return {
+            createdCount: poolInfo.statistics.createdCount,
+            reusedCount: poolInfo.statistics.reusedCount,
+            nowActiveCount: poolInfo.statistics.nowActiveCount,
+            maxActiveCount: poolInfo.statistics.maxActiveCount,
+            availableCount: poolInfo.pool.size(),
+            lastAccessTime: poolInfo.statistics.lastAccessTime,
+        };
+    }
+
+    /**
+     * 获取所有节点池的统计信息
+     */
+    public getAllPoolStats(): Map<string, IPoolStatistics> {
+        let result: Map<string, IPoolStatistics> = new Map<string, IPoolStatistics>();
+        this._poolInfoMap.forEach((poolInfo: PoolInfo, poolName: string) => {
+            result.set(poolName, {
+                createdCount: poolInfo.statistics.createdCount,
+                reusedCount: poolInfo.statistics.reusedCount,
+                nowActiveCount: poolInfo.statistics.nowActiveCount,
+                maxActiveCount: poolInfo.statistics.maxActiveCount,
+                availableCount: poolInfo.pool.size(),
+                lastAccessTime: poolInfo.statistics.lastAccessTime,
+            });
+        });
+        return result;
+    }
+
     /** 打印节点池状态（调试用） */
     private _printPoolState(poolName: string): void {
         let poolInfo: PoolInfo = this._poolInfoMap.get(poolName);
@@ -573,6 +630,7 @@ export class NodePoolMgr extends BaseMgr {
             reusedCount: poolInfo.statistics.reusedCount,
             nowActiveCount: poolInfo.statistics.nowActiveCount,
             maxActiveCount: poolInfo.statistics.maxActiveCount,
+            availableCount: poolInfo.pool.size(),
             lastAccessTime: poolInfo.statistics.lastAccessTime
         });
     }

package/src/Framework/Manager/TimerMgr.ts

@@ -1,8 +1,10 @@
 import { FwkErrorCode } from "../Definition/FwkErrorDefinition";
+import { FrameworkBase } from "../Definition/FrameworkBase";
 import { TimerRepeat } from "../Definition/TimerDefinition";
 import { LogUtils } from "../Utils/LogUtils";
 import { ServiceLocator } from "../Utils/ServiceLocator";
 import { BaseMgr } from "./BaseMgr";
+import { EventMgr } from "./EventMgr";
 
 interface ITimer {
     tick: number;
@@ -19,6 +21,7 @@ export class TimerMgr extends BaseMgr {
     static TAG: string = "TimerMgr";
 
     private timers: ITimer[] = [];
+    private _paused: boolean = false;
 
     onLoad(): void {
         super.onLoad();
@@ -31,6 +34,10 @@ export class TimerMgr extends BaseMgr {
         }
 
         ServiceLocator.Instance.register("TimerMgr", this);
+
+        // 监听生命周期事件，切后台暂停定时器
+        EventMgr.Instance.on(FrameworkBase.Message.LifeCycle_onGameHide, this._onGameHide, this);
+        EventMgr.Instance.on(FrameworkBase.Message.LifeCycle_onGameShow, this._onGameShow, this);
     }
 
     /**
@@ -38,10 +45,50 @@ export class TimerMgr extends BaseMgr {
      */
     public init(): void {
         this.timers = [];
+        this._paused = false;
 
         LogUtils.Instance.info(TimerMgr.TAG, "初始化完成");
     }
 
+    /**
+     * 暂停所有定时器
+     */
+    public pauseAll(): void {
+        if (this._paused) return;
+        this._paused = true;
+        LogUtils.Instance.info(TimerMgr.TAG, "定时器已暂停");
+    }
+
+    /**
+     * 恢复所有定时器
+     */
+    public resumeAll(): void {
+        if (!this._paused) return;
+        this._paused = false;
+        LogUtils.Instance.info(TimerMgr.TAG, "定时器已恢复");
+    }
+
+    /**
+     * 定时器是否暂停中
+     */
+    public isPaused(): boolean {
+        return this._paused;
+    }
+
+    private _onGameHide(): void {
+        this.pauseAll();
+    }
+
+    private _onGameShow(): void {
+        this.resumeAll();
+    }
+
+    onDestroy(): void {
+        EventMgr.Instance.off(FrameworkBase.Message.LifeCycle_onGameHide, this._onGameHide, this);
+        EventMgr.Instance.off(FrameworkBase.Message.LifeCycle_onGameShow, this._onGameShow, this);
+        super.onDestroy();
+    }
+
     /**
      * 添加定时器
      * @param delay 延迟时间（秒）
@@ -118,6 +165,8 @@ export class TimerMgr extends BaseMgr {
     }
 
     protected update(dt: number): void {
+        if (this._paused) return;
+
         for (let index = 0; index < this.timers.length; index++) {
             const item = this.timers[index];
             item.tick += dt;

package/src/Framework/Manager/UIMgr.ts

@@ -1,10 +1,12 @@
-import { Component, Node, Button, Prefab, instantiate, screen, UITransform, v3, view, ResolutionPolicy, math, Tween, tween, Label, Color, Sprite, SpriteFrame, BlockInputEvents, Texture2D } from 'cc';
+import { Component, Node, Button, Prefab, instantiate, screen, UITransform, v3, view, ResolutionPolicy, math, Tween, tween, Label, Color, Sprite, SpriteFrame, BlockInputEvents, Texture2D, Vec3 } from 'cc';
 import { FwkErrorCode } from '../Definition/FwkErrorDefinition';
 import { LogUtils } from '../Utils/LogUtils';
-import { ToastDuration } from '../Definition/UIDefinition';
+import { ToastDuration, ToastPosition } from '../Definition/UIDefinition';
 import { BaseMgr } from './BaseMgr';
 import { ServiceLocator } from '../Utils/ServiceLocator';
 import type { ResMgr } from './ResMgr';
+import type { SystemMgr } from './SystemMgr';
+import type { InputMgr } from './InputMgr';
 
 /** UI 控制器基类 */
 export class UICtrl extends Component {
@@ -125,6 +127,8 @@ export class UIMgr extends BaseMgr {
     private toastHistoryMaxCount: number = 10;
 
     private resMgr: ResMgr = null;
+    private inputMgr: InputMgr = null;
+    private systemMgr: SystemMgr = null;
 
     /** 打印 UI 映射（调试用） */
     public print(): void {
@@ -283,6 +287,10 @@ export class UIMgr extends BaseMgr {
             this.resMgr = ServiceLocator.Instance.get<ResMgr>("ResMgr");
         }
 
+        if (this.inputMgr === null) {
+            this.inputMgr = ServiceLocator.Instance.get<InputMgr>("InputMgr");
+        }
+
         if (!this.resMgr) {
             return null;
         }
@@ -434,12 +442,18 @@ export class UIMgr extends BaseMgr {
      * 显示 Toast
      * @param content 显示内容
      * @param toastDuration 显示时长
+     * @param position 显示位置（ToastPosition 枚举或世界坐标 Vec3），默认居中
      */
-    public showToast(content: string, toastDuration: ToastDuration = ToastDuration.Duration_Short): void {
+    public showToast(content: string, toastDuration: ToastDuration = ToastDuration.Duration_Short, position?: ToastPosition | Vec3): void {
         if (this.node_toastRoot === null) {
             return;
         }
 
+        // 延迟加载 SystemMgr（避免循环依赖）
+        if (this.systemMgr === null) {
+            this.systemMgr = ServiceLocator.Instance.get<SystemMgr>("SystemMgr");
+        }
+
         // 记录 Toast 历史
         this.toastHistory.push(content);
         if (this.toastHistory.length > this.toastHistoryMaxCount) {
@@ -463,6 +477,33 @@ export class UIMgr extends BaseMgr {
 
         this.node_toastRoot.active = true;
         this.node_toastRoot.getComponent(UITransform).width = textWidth + 80;
+
+        // 设置 Toast 位置
+        if (position !== undefined) {
+            if (position instanceof Vec3) {
+                // Vec3 世界坐标，转换为节点坐标
+                let localPos: Vec3 = this.node_toastRoot.getComponent(UITransform).convertToNodeSpaceAR(position);
+                this.node_toastRoot.setPosition(localPos.x, localPos.y);
+            } else {
+                // ToastPosition 枚举
+                let x: number = 0;
+                let y: number = 0;
+                if (this.systemMgr) {
+                    let screenInfo = this.systemMgr.getScreenInfo();
+                    let screenH: number = screenInfo.windowHeight;
+                    let edgeOffset: number = 150; // 距屏幕边缘的距离
+                    if (position === ToastPosition.Top) {
+                        y = screenH / 2 - edgeOffset;
+                    } else if (position === ToastPosition.Bottom) {
+                        y = -screenH / 2 + edgeOffset;
+                    }
+                    // Center: x=0, y=0
+                }
+                // systemMgr 为空时默认居中（x=0, y=0）
+                this.node_toastRoot.setPosition(x, y);
+            }
+        }
+
         this.tween_toast = tween(this.node_toastRoot)
             .delay(showTime)
             .call(() => {
@@ -483,13 +524,10 @@ export class UIMgr extends BaseMgr {
     /**
      * 打开 Dialog
      * @param ui_name UI 名称
-     * @param maskColor 遮罩颜色
-     * @return Dialog 节点
+     * @param maskColor 遮罩颜色（默认半透明黑）
+     * @param closeOnMaskClick 点击遮罩是否关闭 Dialog（默认 false）
      */
-    public openDialog(ui_name: string, maskColor?: Color): Node {
-        if (!maskColor) {
-            maskColor = new Color(51, 51, 51, 230);
-        }
+    public openDialog(ui_name: string, maskColor: Color = new Color(51, 51, 51, 230), closeOnMaskClick: boolean = false): Node {
 
         const whitePixelData = new Uint8Array([maskColor.r, maskColor.g, maskColor.b, maskColor.a]);
         const texture = new Texture2D();
@@ -519,6 +557,18 @@ export class UIMgr extends BaseMgr {
         if (node_dialog) {
             this.node_dialogRoot.addChild(node_agent);
             this.node_dialogRoot.active = true;
+
+            // 点击遮罩关闭 Dialog
+            if (closeOnMaskClick) {
+                let maskTouchCallback = () => {
+                    this.closeDialog(ui_name, node_dialog);
+                };
+                // 将回调存到 node_mask 上，方便 closeDialog 时清理
+                (node_mask as any)._maskTouchCallback = maskTouchCallback;
+                if (this.inputMgr) {
+                    this.inputMgr.onNodeTouchEnd(node_mask, maskTouchCallback, this);
+                }
+            }
         } else {
             node_agent.destroy();
         }
@@ -546,6 +596,14 @@ export class UIMgr extends BaseMgr {
 
         if (hasNode) {
             let node_agent: Node = node.parent;
+            // 清理点击遮罩关闭的监听器（如果存在）
+            let node_mask: Node = node_agent.getChildByName("Node_Mask");
+            if (node_mask && (node_mask as any)._maskTouchCallback) {
+                if (this.inputMgr) {
+                    this.inputMgr.offNodeTouchEnd(node_mask, (node_mask as any)._maskTouchCallback, this);
+                }
+                (node_mask as any)._maskTouchCallback = null;
+            }
             this.destroy_ui(ui_name, node);
             node_agent.destroy();
         }
@@ -574,6 +632,14 @@ export class UIMgr extends BaseMgr {
                 if (child.name !== "Node_Mask") {
                     let uiName = this._nodeToUIName(child);
                     if (uiName) {
+                        // 清理点击遮罩关闭的监听器（如果存在）
+                        let node_mask: Node = agent.getChildByName("Node_Mask");
+                        if (node_mask && (node_mask as any)._maskTouchCallback) {
+                            if (this.inputMgr) {
+                                this.inputMgr.offNodeTouchEnd(node_mask, (node_mask as any)._maskTouchCallback, this);
+                            }
+                            (node_mask as any)._maskTouchCallback = null;
+                        }
                         this.destroy_ui(uiName, child);
                         closedCount++;
                         break;

package/src/Framework/Utils/LogUtils.ts

@@ -9,6 +9,7 @@ export class LogUtils {
     static TAG: string = "LogUtils";
 
     private isDebug: boolean = false;
+    private _timers: Map<string, number> = new Map();
 
     /**
      * 初始化日志模块
@@ -133,6 +134,32 @@ export class LogUtils {
         return `[${level}][${tag}][${timestamp}]: ${content}`;
     }
 
+    /**
+     * 开始计时
+     * @param label 计时标签
+     */
+    public timeStart(label: string): void {
+        if (!this.isDebug) return;
+        this._timers.set(label, Date.now());
+        console.log(this.formatLog("TIMER", label, "计时开始"));
+    }
+
+    /**
+     * 结束计时并输出耗时
+     * @param label 计时标签（需与 timeStart 匹配）
+     */
+    public timeEnd(label: string): void {
+        if (!this.isDebug) return;
+        const startTime = this._timers.get(label);
+        if (startTime === undefined) {
+            console.warn(this.formatLog("TIMER", label, "未找到计时起点"));
+            return;
+        }
+        const elapsed = Date.now() - startTime;
+        this._timers.delete(label);
+        console.log(this.formatLog("TIMER", label, `耗时 ${elapsed}ms`));
+    }
+
     /**
      * 格式化值
      */

package/src/Framework/Utils/ObjectUtils.ts

@@ -23,4 +23,115 @@ export class ObjectUtils {
 
         return keysA.every(key => ObjectUtils.deepEqual(a[key], b[key]));
     }
+
+    // ======================== Base64 编解码 ========================
+
+    private static readonly BASE64_CHARS: string = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+
+    /**
+     * 将字符串转为 UTF-8 字节数组
+     */
+    private static utf8ToBytes(str: string): number[] {
+        const bytes: number[] = [];
+        for (let i = 0; i < str.length; i++) {
+            const code = str.charCodeAt(i);
+            if (code < 0x80) {
+                bytes.push(code);
+            } else if (code < 0x800) {
+                bytes.push(0xC0 | (code >> 6));
+                bytes.push(0x80 | (code & 0x3F));
+            } else if (code >= 0xD800 && code <= 0xDBFF) {
+                // 代理对（emoji 等）
+                const hi = code;
+                const lo = str.charCodeAt(++i);
+                const codePoint = ((hi - 0xD800) << 10) + (lo - 0xDC00) + 0x10000;
+                bytes.push(0xF0 | (codePoint >> 18));
+                bytes.push(0x80 | ((codePoint >> 12) & 0x3F));
+                bytes.push(0x80 | ((codePoint >> 6) & 0x3F));
+                bytes.push(0x80 | (codePoint & 0x3F));
+            } else {
+                bytes.push(0xE0 | (code >> 12));
+                bytes.push(0x80 | ((code >> 6) & 0x3F));
+                bytes.push(0x80 | (code & 0x3F));
+            }
+        }
+        return bytes;
+    }
+
+    /**
+     * 将 UTF-8 字节数组转为字符串
+     */
+    private static utf8FromBytes(bytes: number[]): string {
+        let result = "";
+        let i = 0;
+        while (i < bytes.length) {
+            const b1 = bytes[i++];
+            if (b1 < 0x80) {
+                result += String.fromCharCode(b1);
+            } else if (b1 < 0xE0) {
+                const b2 = bytes[i++];
+                result += String.fromCharCode(((b1 & 0x1F) << 6) | (b2 & 0x3F));
+            } else if (b1 < 0xF0) {
+                const b2 = bytes[i++];
+                const b3 = bytes[i++];
+                result += String.fromCharCode(((b1 & 0x0F) << 12) | ((b2 & 0x3F) << 6) | (b3 & 0x3F));
+            } else {
+                const b2 = bytes[i++];
+                const b3 = bytes[i++];
+                const b4 = bytes[i++];
+                const codePoint = ((b1 & 0x07) << 18) | ((b2 & 0x3F) << 12) | ((b3 & 0x3F) << 6) | (b4 & 0x3F);
+                // 转为代理对
+                const offset = codePoint - 0x10000;
+                result += String.fromCharCode(0xD800 + (offset >> 10), 0xDC00 + (offset & 0x3FF));
+            }
+        }
+        return result;
+    }
+
+    /**
+     * Base64 编码（纯 JS 实现，兼容所有小游戏/快应用平台，支持中文和 emoji）
+     * @param str 要编码的字符串
+     * @returns Base64 编码后的字符串
+     */
+    public static base64Encode(str: string): string {
+        const bytes = ObjectUtils.utf8ToBytes(str);
+        const chars = ObjectUtils.BASE64_CHARS;
+        let result = "";
+        for (let i = 0; i < bytes.length; i += 3) {
+            const a = bytes[i];
+            const b = i + 1 < bytes.length ? bytes[i + 1] : 0;
+            const c = i + 2 < bytes.length ? bytes[i + 2] : 0;
+            result += chars[(a >> 2) & 0x3F];
+            result += chars[((a << 4) | (b >> 4)) & 0x3F];
+            result += i + 1 < bytes.length ? chars[((b << 2) | (c >> 6)) & 0x3F] : "=";
+            result += i + 2 < bytes.length ? chars[c & 0x3F] : "=";
+        }
+        return result;
+    }
+
+    /**
+     * Base64 解码（纯 JS 实现，兼容所有小游戏/快应用平台，支持中文和 emoji）
+     * @param str Base64 编码的字符串
+     * @returns 解码后的原始字符串
+     */
+    public static base64Decode(str: string): string {
+        const chars = ObjectUtils.BASE64_CHARS;
+        const bytes: number[] = [];
+        // 去除空白字符
+        str = str.replace(/\s/g, "");
+        for (let i = 0; i < str.length; i += 4) {
+            const a = chars.indexOf(str[i]);
+            const b = chars.indexOf(str[i + 1]);
+            const c = str[i + 2] === "=" ? 0 : chars.indexOf(str[i + 2]);
+            const d = str[i + 3] === "=" ? 0 : chars.indexOf(str[i + 3]);
+            bytes.push((a << 2) | (b >> 4));
+            if (str[i + 2] !== "=") {
+                bytes.push(((b & 0xF) << 4) | (c >> 2));
+            }
+            if (str[i + 3] !== "=") {
+                bytes.push(((c & 0x3) << 6) | d);
+            }
+        }
+        return ObjectUtils.utf8FromBytes(bytes);
+    }
 }