keytops-game-framework 2.1.0 → 2.1.1

package/dist/app/module/analytics/index.d.ts

@@ -15,6 +15,13 @@ export * from "./social/SocialAnalyticsAble";
 export * from "./tutorial/TutorialAnalyticsAble";
 export * from "./pay/PayAnalyticsAble";
 export * from "./firebase/FirebaseAnalyticsSender";
+/**
+ * 自定义统计能力构造器。
+ *
+ * 自定义能力通过构造参数复用 AnalyticsManager 的基础统计能力，
+ * 从而共享 Sender、公共属性、用户属性和调试配置。
+ */
+export type AnalyticsAbilityConstructor<T> = new (baseAble: AnalyticsAble) => T;
 declare class AnalyticsManager {
     private hasRelayUrl;
     private hasAliDirectConfig;
@@ -59,6 +66,13 @@ declare class AnalyticsManager {
      * 支付漏斗统计能力
      */
     get pay(): PayAnalyticsAble;
+    private _abilityMap;
+    /**
+     * 获取由 AnalyticsManager 代管的自定义统计能力。
+     *
+     * 同一个构造器只会创建一个实例；自定义能力应通过构造参数接收基础统计能力。
+     */
+    getAbility<T>(abilityClass: AnalyticsAbilityConstructor<T>): T;
     /**
      * 启用统计（基础统计能力）
      * @param debugMode 调试模式，是否打印日志信息，默认为false

package/dist/index.js

@@ -6734,6 +6734,7 @@ class AnalyticsManager {
         this._social = null;
         this._tutorial = null;
         this._pay = null;
+        this._abilityMap = new Map();
         this._assignmentSender = null;
     }
     hasRelayUrl(config) {
@@ -6845,6 +6846,22 @@ class AnalyticsManager {
         }
         return this._pay;
     }
+    /**
+     * 获取由 AnalyticsManager 代管的自定义统计能力。
+     *
+     * 同一个构造器只会创建一个实例；自定义能力应通过构造参数接收基础统计能力。
+     */
+    getAbility(abilityClass) {
+        if (!this.base.inited) {
+            throw new Error("请先通过enable初始化基础统计能力");
+        }
+        let instance = this._abilityMap.get(abilityClass);
+        if (!instance) {
+            instance = new abilityClass(this.base);
+            this._abilityMap.set(abilityClass, instance);
+        }
+        return instance;
+    }
     /**
      * 启用统计（基础统计能力）
      * @param debugMode 调试模式，是否打印日志信息，默认为false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keytops-game-framework",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "cocos creator game framework library",
   "main": "./dist/index.js",
   "module": "./dist/index.js",