@chiyou/minigame-framework 1.2.69 → 1.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chiyou/minigame-framework",
-  "version": "1.2.69",
+  "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/EventDefinition.ts

@@ -0,0 +1,7 @@
+/**
+ * 事件监听者信息（调试用）
+ */
+export interface EventListenerInfo {
+    callback: Function;
+    target: any;
+}

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/TimerDefinition.ts

@@ -0,0 +1,9 @@
+/**
+ * 定时器重复次数枚举
+ */
+export enum TimerRepeat {
+    /** 只执行一次 */
+    Once = 1,
+    /** 无限循环 */
+    Infinite = -1,
+}

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);
         }
     }