@chiyou/minigame-framework 1.4.0 → 1.4.1

package/package.json

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

package/src/Framework/Definition/AnalyticsDefinition.ts

@@ -32,88 +32,14 @@ export interface UmengConfig {
 
 // ==================== SDK 类型声明 ====================
 
-/** 关卡结束事件类型 */
-export enum StageEventType {
-    /** 关卡完成 */
-    Complete = "complete",
-    /** 关卡失败 */
-    Fail = "fail",
-}
-
-/** 关卡中行为事件类型 */
-export enum StageRunningEventType {
-    /** 使用道具 */
-    Tools = "tools",
-    /** 获得奖励 */
-    Award = "award",
-}
-
-/** 关卡开始参数 */
-export interface StageStartParams {
-    /** 关卡ID（必传，string类型） */
-    stageId: string;
-    /** 关卡名称（必传） */
-    stageName: string;
-}
-
-/** 关卡结束参数 */
-export interface StageEndParams {
-    /** 关卡ID（必传，string类型） */
-    stageId: string;
-    /** 关卡名称（必传） */
-    stageName: string;
-    /** 关卡结束结果（必传，complete/fail） */
-    event: StageEventType;
-    /** 关卡耗时（毫秒，可选） */
-    _um_sdu?: number;
-}
-
-/** 关卡中行为事件参数 */
-export interface StageRunningParams {
-    /** 关卡ID（必传，string类型） */
-    stageId: string;
-    /** 关卡名称（必传） */
-    stageName: string;
-    /** 事件类型（必传，tools/award） */
-    event: StageRunningEventType;
-    /** 事件参数 */
-    params?: StageRunningItemParams;
-}
-
-/** 关卡中行为物品参数 */
-export interface StageRunningItemParams {
-    /** 商品/道具名称（必传） */
-    itemName: string;
-    /** 商品/道具ID（可选） */
-    itemId?: string;
-    /** 商品/道具数量（可选） */
-    itemCount?: number;
-    /** 商品/道具单价（可选） */
-    itemMoney?: number;
-    /** 描述（可选） */
-    desc?: string;
-}
-
-/** 友盟关卡 SDK 接口 */
-export interface UmaSDKStage {
-    /** 关卡开始 */
-    onStart(params: StageStartParams): void;
-    /** 关卡结束 */
-    onEnd(params: StageEndParams): void;
-    /** 关卡中行为 */
-    onRunning(params: StageRunningParams): void;
-}
-
 /**
  * 友盟 SDK 接口定义
  * 
- * 仅包含实际可用的方法（共12个）
+ * 仅包含实际可用的方法（共11个）
  * 已移除：removeUserid, setUserInfo, setAnonymousid, setAppVersion, setSuperProperty（不可用）
  * 已移除：revenue, stage, level, rc（插件方法）
  * 
  * 使用方式：SDK 在 game.js 中初始化后，通过 wx.uma 全局实例访问
- * 
- * 关卡行为上报通过 wx.uma.stage 对象访问
  */
 export interface UmaSDK {
     /** 恢复会话（onShow 时调用） */
@@ -138,8 +64,6 @@ export interface UmaSDK {
     onShareAppMessage(callback: () => object): void;
     /** 调用分享 */
     shareAppMessage(options: object): void;
-    /** 关卡行为上报（stage 对象） */
-    stage: UmaSDKStage;
 }
 
 // ==================== 预定义事件 ID ====================

package/src/Framework/Manager/AnalyticsMgr.ts

@@ -3,10 +3,10 @@ import { LogUtils } from "../Utils/LogUtils";
 import { ServiceLocator } from "../Utils/ServiceLocator";
 import { FwkErrorCode } from "../Definition/FwkErrorDefinition";
 import { PlatformID } from "../Definition/SystemDefinition";
-import { UmengConfig, EventParams, AnalyticsEventId, AnalyticsParamKey, UmaSDK, StageEventType, StageRunningEventType, StageEndParams, StageRunningParams, CommonParams, UmaSDKStage } from "../Definition/AnalyticsDefinition";
+import { UmengConfig, EventParams, AnalyticsEventId, AnalyticsParamKey, UmaSDK, CommonParams } from "../Definition/AnalyticsDefinition";
 import { EventMgr } from "./EventMgr";
 import { FrameworkBase } from "../Definition/FrameworkBase";
-import { SystemMgr } from "./SystemMgr";
+import type { SystemMgr } from "./SystemMgr";
 
 export class AnalyticsMgr extends BaseMgr {
     /** 单例实例 */
@@ -20,8 +20,6 @@ export class AnalyticsMgr extends BaseMgr {
     private _isEnabled: boolean = false;
     /** 当前平台对应的 SDK 实例（通过 wx.uma 全局访问） */
     private _sdk: UmaSDK = null;
-    /** 关卡 SDK 实例 */
-    private _sdkStage: UmaSDKStage = null;
     /** 通用属性（trackEvent 自动合并） */
     private _commonParams: CommonParams = null;
 
@@ -74,12 +72,20 @@ export class AnalyticsMgr extends BaseMgr {
 
         // 根据当前平台是否开启统计来决定是否启用
         const platformID: PlatformID = BaseMgr.Instance.getCurrentPlatformID();
-        const enabled = umengConfig.platformEnableMap.get(platformID);
+        let enabled = umengConfig.platformEnableMap.get(platformID);
+
+        if (enabled) {
+            // 额外检查：本地游戏无网络请求能力，不上报统计
+            const systemMgr = ServiceLocator.Instance.get<SystemMgr>("SystemMgr");
+            if (systemMgr && !systemMgr.supportRequest()) {
+                enabled = false;
+                LogUtils.Instance.info(AnalyticsMgr.TAG, "本地游戏不支持网络请求，统计禁用");
+            }
+        }
 
         if (enabled) {
             // 从全局获取 SDK 实例（在 game.js 中初始化后挂载到 wx.uma）
             this._sdk = this._getGlobalSDK();
-            this._sdkStage = this._sdk?.stage || null;
             this._isEnabled = !!this._sdk;
         } else {
             this._isEnabled = false;
@@ -139,7 +145,6 @@ export class AnalyticsMgr extends BaseMgr {
      * 后续所有 trackEvent 调用自动合并这些属性。
      * 合并规则：通用属性与自定义属性同级平铺，自定义属性可覆盖同名通用属性。
      * 
-     * 注意：仅适用于 trackEvent，不适用于 stage 系列接口。
      * 友盟 SDK 的 setSuperProperty 在小游戏环境不可用，需在框架封装层实现。
      */
     private _initCommonParams(): void {
@@ -310,157 +315,6 @@ export class AnalyticsMgr extends BaseMgr {
         this.trackEvent(AnalyticsEventId.AdClick, params);
     }
 
-    // ==================== 关卡行为上报（友盟 stage 接口） ====================
-
-    /**
-     * 关卡开始
-     * @param stageId 关卡ID（string类型）
-     * @param stageName 关卡名称
-     */
-    public stageOnStart(stageId: string, stageName: string): void {
-        if (!this._isEnabled || !this._sdkStage) return;
-        try {
-            this._sdkStage.onStart({ stageId, stageName });
-            LogUtils.Instance.info(AnalyticsMgr.TAG, "关卡开始", {
-                operation: "stageOnStart",
-                stageId,
-                stageName,
-            });
-        } catch (e) {
-            LogUtils.Instance.error(AnalyticsMgr.TAG, FwkErrorCode.Analytics.SDKCallFailed, {
-                operation: "stageOnStart",
-                reason: String(e),
-                stageId,
-                stageName,
-            });
-        }
-    }
-
-    /**
-     * 关卡结束
-     * @param stageId 关卡ID（string类型）
-     * @param stageName 关卡名称
-     * @param event 结束结果（"complete" | "fail")
-     * @param duration 关卡耗时（毫秒，可选）
-     */
-    public stageOnEnd(stageId: string, stageName: string, event: StageEventType, duration?: number): void {
-        if (!this._isEnabled || !this._sdkStage) return;
-        try {
-            const params: StageEndParams = { stageId, stageName, event };
-            if (duration !== undefined) {
-                params._um_sdu = duration;
-            }
-            this._sdkStage.onEnd(params);
-            LogUtils.Instance.info(AnalyticsMgr.TAG, "关卡结束", {
-                operation: "stageOnEnd",
-                stageId,
-                stageName,
-                event,
-                duration,
-            });
-        } catch (e) {
-            LogUtils.Instance.error(AnalyticsMgr.TAG, FwkErrorCode.Analytics.SDKCallFailed, {
-                operation: "stageOnEnd",
-                reason: String(e),
-                stageId,
-                stageName,
-                event,
-            });
-        }
-    }
-
-    /**
-     * 关卡中行为 - 使用道具
-     * @param stageId 关卡ID（string类型）
-     * @param stageName 关卡名称
-     * @param itemName 道具名称
-     * @param itemId 道具ID（可选）
-     * @param itemCount 道具数量（可选）
-     * @param itemMoney 道具单价（可选）
-     */
-    public stageOnRunningTools(
-        stageId: string,
-        stageName: string,
-        itemName: string,
-        itemId?: string,
-        itemCount?: number,
-        itemMoney?: number
-    ): void {
-        if (!this._isEnabled || !this._sdkStage) return;
-        try {
-            const params: StageRunningParams = {
-                stageId,
-                stageName,
-                event: StageRunningEventType.Tools,
-                params: { itemName, itemId, itemCount, itemMoney },
-            };
-            this._sdkStage.onRunning(params);
-            LogUtils.Instance.info(AnalyticsMgr.TAG, "关卡使用道具", {
-                operation: "stageOnRunningTools",
-                stageId,
-                stageName,
-                itemName,
-                itemId,
-                itemCount,
-                itemMoney,
-            });
-        } catch (e) {
-            LogUtils.Instance.error(AnalyticsMgr.TAG, FwkErrorCode.Analytics.SDKCallFailed, {
-                operation: "stageOnRunningTools",
-                reason: String(e),
-                stageId,
-                stageName,
-                itemName,
-            });
-        }
-    }
-
-    /**
-     * 关卡中行为 - 获得奖励
-     * @param stageId 关卡ID（string类型）
-     * @param stageName 关卡名称
-     * @param itemName 奖励名称
-     * @param itemId 奖励ID（可选）
-     * @param itemCount 奖励数量（可选）
-     * @param itemMoney 奖励单价（可选）
-     */
-    public stageOnRunningAward(
-        stageId: string,
-        stageName: string,
-        itemName: string,
-        itemId?: string,
-        itemCount?: number,
-        itemMoney?: number
-    ): void {
-        if (!this._isEnabled || !this._sdkStage) return;
-        try {
-            const params: StageRunningParams = {
-                stageId,
-                stageName,
-                event: StageRunningEventType.Award,
-                params: { itemName, itemId, itemCount, itemMoney },
-            };
-            this._sdkStage.onRunning(params);
-            LogUtils.Instance.info(AnalyticsMgr.TAG, "关卡获得奖励", {
-                operation: "stageOnRunningAward",
-                stageId,
-                stageName,
-                itemName,
-                itemId,
-                itemCount,
-                itemMoney,
-            });
-        } catch (e) {
-            LogUtils.Instance.error(AnalyticsMgr.TAG, FwkErrorCode.Analytics.SDKCallFailed, {
-                operation: "stageOnRunningAward",
-                reason: String(e),
-                stageId,
-                stageName,
-                itemName,
-            });
-        }
-    }
-
     // ==================== 状态查询 ====================
 
     /** 是否已初始化 */