drgame-cc 1.0.18 → 1.0.20

package/drscript/ExitWin.ts

@@ -29,8 +29,6 @@ export default class ExitWin extends cc.Component {
 
     onEnable() {
         PlatformAdapter.showWindow(this.node);
-        PlatformAdapter.registerButton(this.btnCancel);
-        PlatformAdapter.registerButton(this.btnExit);
     }
 
     onDisable() {

package/drscript/GameAnalytics.ts

@@ -0,0 +1,162 @@
+import { ActionType, Reporter } from "./ad-sdk/ad-sdk";
+
+export enum GameAnalyticsPlatform {
+    XiaomiTv = "xiaomi",
+    Lewo = "lewo",
+}
+
+export enum AnalyticsEvent {
+    GameLoading = "game_loading",
+    StartGameButton = "start_game_button",
+    WatchVideoContinueButton = "watch_video_continue_button",
+    ReplayButton = "replay_button",
+    RewardVideoAd = "reward_video_ad",
+}
+
+export enum AnalyticsAction {
+    Exposure = "exposure",
+    Click = "click",
+}
+
+export interface GameAnalyticsConfig {
+    platform?: GameAnalyticsPlatform | string;
+    app_item?: string;
+    content_type?: string;
+    content_id?: string;
+    content_title?: string;
+    user_id?: string;
+}
+
+interface AnalyticsEventDefinition {
+    elementPosition: string;
+    exposureEventName?: string;
+    clickEventName?: string;
+}
+
+const APP_ITEM_BY_PLATFORM: { [platform: string]: string } = {
+    xiaomi: "25",
+    lewo: "29",
+};
+
+const REPORT_URL = "https://sup.daoran.tv/bi-api/api/game/lewo/batch";
+
+export default class GameAnalytics {
+    private static initialized: boolean = false;
+    private static loadingReported: boolean = false;
+    private static reportedExposures: { [event: string]: boolean } = {};
+
+    private static readonly definitions: { [event: string]: AnalyticsEventDefinition } = {
+        game_loading: {
+            elementPosition: "game_loading",
+            exposureEventName: "game_loading_expose",
+        },
+        start_game_button: {
+            elementPosition: "start_game_button",
+            exposureEventName: "start_game_expose",
+            clickEventName: "start_game_click",
+        },
+        watch_video_continue_button: {
+            elementPosition: "watch_video_continue_button",
+            exposureEventName: "watch_video_continue_expose",
+            clickEventName: "watch_video_continue_click",
+        },
+        replay_button: {
+            elementPosition: "replay_button",
+            exposureEventName: "replay_expose",
+            clickEventName: "replay_click",
+        },
+        reward_video_ad: {
+            elementPosition: "reward_video_ad",
+            exposureEventName: "ad_expose",
+        },
+    };
+
+    public static init(config: GameAnalyticsConfig = {}): void {
+        if (this.initialized) {
+            if (config.user_id !== undefined) this.setUserId(config.user_id);
+            return;
+        }
+
+        try {
+            const platform = config.platform || GameAnalyticsPlatform.XiaomiTv;
+            Reporter.init({
+                report_url: REPORT_URL,
+                app_item: config.app_item || this.getAppItem(platform),
+                content_type: config.content_type || "独立游戏",
+                content_id: config.content_id || "rexueqiangshou",
+                content_title: config.content_title || "热血枪手",
+            });
+            this.initialized = true;
+            if (config.user_id !== undefined) this.setUserId(config.user_id);
+        } catch (error) {
+            console.warn("[GameAnalytics] init failed", error);
+        }
+    }
+
+    public static setUserId(userId: string): void {
+        this.init();
+        if (!this.initialized) return;
+        try {
+            Reporter.setCommonInfo({ user_id: userId || "" });
+        } catch (error) {
+            console.warn("[GameAnalytics] set user id failed", error);
+        }
+    }
+
+    public static reportLoadingOnce(): void {
+        if (this.loadingReported) return;
+        this.loadingReported = true;
+        this.report(AnalyticsEvent.GameLoading, AnalyticsAction.Exposure);
+    }
+
+    public static reportExposureOnce(event: AnalyticsEvent): void {
+        if (this.reportedExposures[event]) return;
+        this.reportedExposures[event] = true;
+        this.report(event, AnalyticsAction.Exposure);
+    }
+
+    public static report(
+        event: AnalyticsEvent,
+        action: AnalyticsAction,
+        adRequestId?: string
+    ): void {
+        this.init();
+        if (!this.initialized) return;
+
+        const definition = this.definitions[event];
+        const eventName = definition && action === AnalyticsAction.Exposure
+            ? definition.exposureEventName
+            : definition && definition.clickEventName;
+        if (!definition || !eventName) {
+            console.warn("[GameAnalytics] unsupported event/action", event, action);
+            return;
+        }
+
+        try {
+            const reportItem: any = {
+                element_position: definition.elementPosition,
+                action_type: action === AnalyticsAction.Exposure
+                    ? ActionType.Exposure
+                    : ActionType.Click,
+                event_name: eventName,
+            };
+            if (event === AnalyticsEvent.RewardVideoAd) {
+                reportItem.ad_request_id = adRequestId || "";
+            }
+            Reporter.report(reportItem);
+        } catch (error) {
+            console.warn("[GameAnalytics] report failed", error);
+        }
+    }
+
+    static getAppItem(platform: string): string {
+        const normalizedPlatform = (platform || "").toLowerCase();
+        const appItem = APP_ITEM_BY_PLATFORM[normalizedPlatform];
+        if (appItem) return appItem;
+        console.warn(
+            "[GameAnalytics] unknown platform, fallback to Xiaomi TV app_item=25",
+            platform
+        );
+        return APP_ITEM_BY_PLATFORM[GameAnalyticsPlatform.XiaomiTv];
+    }
+}

package/drscript/PlatformAdapter.ts

@@ -2,10 +2,11 @@
 import { BtnExtra } from "./BtnExtra";
 import TvUi from "./core/TvUi";
 import { EVideoScene } from "./Define";
+import GameAnalytics, { AnalyticsAction, AnalyticsEvent, GameAnalyticsPlatform } from "./GameAnalytics";
 import { showRewardVideo } from "./Info";
 import { Loader } from "./Loader";
 import ToastManager from "./toast/ToastManager";
-
+import { Util } from "./Util";
 /** 平台适配器,名字有点长防止和Platform，Adapter冲突 */
 export class PlatformAdapter {
     private static readonly cpId = "xhbj";
@@ -13,10 +14,13 @@ export class PlatformAdapter {
     private static readonly designWidth = 1920;
     private static readonly designHeight = 1080;
     /** 初始化 */
-    public static async init() {
+    public static async init(cnName: string) {
+        var platform = GameAnalyticsPlatform.XiaomiTv;//平台由sdk处理
+        var appItem = GameAnalytics.getAppItem(platform);
+        var contentId = Util.getChineseInitials(cnName);
         await ToastManager.Inst.init();
         TvUi.init({
-            cpId: this.cpId,
+            cpId: contentId,
             version: this.version,
             designWidth: this.designWidth,
             designHeight: this.designHeight,
@@ -27,7 +31,7 @@ export class PlatformAdapter {
                 defaultIconKey: "default"
             },
             adSdk: {
-                platform: "xiaomi"
+                platform: platform
             },
             ads: {
                 reward: {
@@ -56,6 +60,15 @@ export class PlatformAdapter {
                 }
             }
         });
+
+        GameAnalytics.init({
+            platform: GameAnalyticsPlatform.XiaomiTv,
+            app_item: appItem,
+            content_type: "游戏", // 游戏（乐窝的游戏，这个字段都固定上报游戏）
+            content_id: contentId, // 游戏ID（具体乐窝的游戏ID）
+            content_title: znName, // 游戏名（具体的乐窝游戏名）
+        });
+
     }
 
     /**
@@ -72,7 +85,7 @@ export class PlatformAdapter {
      * 注册按钮事件,有BtnExtra组件会自动切换按钮图片
      * @param button 按钮组件
      */
-    public static registerButton(button: cc.Button) {
+    public static registerButton(button: cc.Node) {
         var sprite = button.getComponent(cc.Sprite);
         var btnExtra = button.getComponent(BtnExtra);
         var onFocus = () => {
@@ -95,8 +108,8 @@ export class PlatformAdapter {
      */
     public static registerButtonByName(name: string, parent: cc.Node = null) {
         if (!parent) parent = cc.director.getScene();
-        let button = this.findChildByName(parent, name).getComponent(cc.Button);
-        if (!button) return;
+        let button = this.findChildByName(parent, name);
+
         this.registerButton(button);
     }
 
@@ -108,13 +121,12 @@ export class PlatformAdapter {
      */
     public static focusButtonByName(name: string, parent: cc.Node = null) {
         if (!parent) parent = cc.director.getScene();
-        let button = this.findChildByName(parent, name).getComponent(cc.Button);
-        if (!button) return;
-        TvUi.focus.focus(button.node);
+        let button = this.findChildByName(parent, name);
+        TvUi.focus.focus(button);
     }
 
-    public static focusButton(btn: cc.Button) {
-        TvUi.focus.focus(btn.node);
+    public static focusButton(btn: cc.Node) {
+        TvUi.focus.focus(btn);
     }
 
     /**
@@ -143,6 +155,7 @@ export class PlatformAdapter {
     public static showWindow(window: cc.Node) {
         TvUi.focus.pushScope(window.uuid, window);
         TvUi.focus.registerButtons(window);
+        this.findBtnExtra(window);
     }
 
     /** 关闭界面取消注册按钮事件 */
@@ -153,8 +166,8 @@ export class PlatformAdapter {
 
     /** 刷新界面按钮事件, 用于界面按钮变化(列表，下拉)后,需要刷新按钮事件 */
     public static refreshWindow(window: cc.Node) {
-        cc.Node.EventType.TOUCH_START
         TvUi.focus.registerButtons(window);
+        this.findBtnExtra(window);
     }
 
     public static async showExitWin() {
@@ -164,6 +177,18 @@ export class PlatformAdapter {
         exitWin.setPosition(cc.v2(cc.winSize.width / 2, cc.winSize.height / 2));
     }
 
+    private static findBtnExtra(node: cc.Node) {
+        for (let i = 0; i < node.children.length; i++) {
+            var child = node.children[i];
+            if (child.isValid === false || !child.activeInHierarchy) continue;
+            let btnExtra = child.getComponent(BtnExtra);
+            if (btnExtra) {
+                this.registerButton(child);
+            }
+            this.findBtnExtra(child);
+        }
+    }
+
     /** 设置启动页进度条 */
     public static setProgress(progress: number, tip: string) {
         if (window["setProgress"]) window["setProgress"](progress, tip);
@@ -173,4 +198,14 @@ export class PlatformAdapter {
     public static closeLoading() {
         if (window["closeLoading"]) window["closeLoading"]();
     }
+
+    /**
+     * 上报事件
+     * @param event 事件类型
+     * @param action 事件操作 曝光or点击 默认点击
+     * @param adRequestId 广告请求ID
+     */
+    public static report(event: AnalyticsEvent, action: AnalyticsAction = AnalyticsAction.Click, adRequestId?: string) {
+        GameAnalytics.report(event, action, adRequestId);
+    }
 }

package/drscript/Util.ts

@@ -0,0 +1,11 @@
+import { pinyin } from "pinyin-pro";
+
+export class Util {
+    public static getChineseInitials(str: string): string {
+        return pinyin(str, {
+            pattern: 'first',
+            toneType: 'none',
+            type: 'array'
+        }).join('').toLowerCase();
+    }
+}

package/drscript/ad-sdk/reporters/reporter.js

@@ -68,6 +68,25 @@ var Reporter = {
       this._commonInfo.device_id = supersetLewo.createDeviceId();
     }
 
+    supersetLewo.initUserInfo({
+      os_type: "",          // 系统类型安卓
+      os_version: "",            // 安卓版本15
+      app_version: "1.0.0",        // APP版本号
+      app_item: config.app_item,              // 渠道编码
+      app_name: config.content_title,      // APP展示名称
+      app_project: config.content_id,          // 产品内部编码
+      province: "",             // 省份编码
+      city: "",                // 城市编码
+      uid: "",            // 登录用户UID，未登录填空""
+      user_id: "",         // 会员/游客ID，无则填空""
+      device_id: this._commonInfo.device_id,               // 设备唯一ID，没有或不传则自动生成
+      device_brand: "",      // 手机品牌小写
+      device_model: "",    // 手机完整型号
+      network_type: "",    // 蜂窝流量网络
+      carrier: ""              // 运营商
+      // device_id 不传，内部自动生成UUID填充，无需手动传入
+    });
+
     this._initialized = true;
     console.log('[Reporter] Initialized, reportUrl:', supersetLewo.config.reportUrl);
   },

package/drscript/ad-sdk/reporters/superset-lewo.js

@@ -1,35 +1,47 @@
 var supersetLewo = (function () {
-  // ========== 私有常量与缓存（闭包内部，外部无法访问） ==========
+  // ========== 私有常量与缓存（闭包私有，外部不可访问） ==========
+  // 设备ID本地存储Key：localStorage + cookie共用
   var STORAGE_KEY = 'analytics.device_id.uuid_v4';
+  // 内存缓存设备UUID，避免重复读取存储
   var memoryCache = null;
+  // 全局缓存用户/设备公共信息，上报顶层user字段统一复用
+  var globalUserInfo = {};
+
+  var initInfoFlag = false;
 
   /**
-   * 生成标准 UUID v4
-   * 优先使用原生 crypto API，逐级降级
+   * 生成标准 UUID v4 设备唯一标识
+   * 优先级：原生crypto.randomUUID > crypto.getRandomValues > Math.random伪随机兜底
+   * @returns {string} 小写标准UUID v4字符串
    */
   function createUuidV4() {
+    // 浏览器原生高性能UUID接口
     if (globalThis.crypto?.randomUUID) {
       return globalThis.crypto.randomUUID().toLowerCase();
     }
-
+    // 支持加密随机字节，手动构造v4规范UUID
     if (globalThis.crypto?.getRandomValues) {
       var bytes = new Uint8Array(16);
       globalThis.crypto.getRandomValues(bytes);
-      // UUID v4 版本与变种位
+      // UUID v4 固定版本位 0x40、变种位 0x80
       bytes[6] = (bytes[6] & 0x0f) | 0x40;
       bytes[8] = (bytes[8] & 0x3f) | 0x80;
-
+      // 字节转两位十六进制字符串
       var hex = Array.from(bytes, function (val) {
         return val.toString(16).padStart(2, '0');
       }).join('');
+      // 拼接标准UUID分隔格式
       return hex.slice(0, 8) + '-' + hex.slice(8, 12) + '-' +
         hex.slice(12, 16) + '-' + hex.slice(16, 20) + '-' + hex.slice(20);
     }
-
-    // 最低降级：Math.random 伪随机（熵低，仅统计场景兜底）
+    // 最低兼容兜底：Math.random生成伪随机UUID（熵较低，仅无加密API场景使用）
     return generatePseudoUuid();
   }
 
+  /**
+   * Math.random 伪随机UUID生成器，兼容极老浏览器
+   * @returns {string} 伪随机UUID v4格式字符串
+   */
   function generatePseudoUuid() {
     return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
       var r = (Math.random() * 16) | 0;
@@ -39,254 +51,259 @@ var supersetLewo = (function () {
   }
 
   /**
-   * 安全获取 Cookie（自动转义key，避免正则特殊字符 . + * 等失效）
+   * 安全读取Cookie，自动转义正则特殊字符，防止匹配失效
+   * @param {string} name cookie键名
+   * @returns {string|null} cookie值，无则返回null
    */
   function getCookie(name) {
     try {
+      // 转义 . * + ? $ 等正则特殊符号
       var escapedName = name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
       var reg = new RegExp('(^| )' + escapedName + '=([^;]+)');
       var match = document.cookie.match(reg);
       return match ? match[2] : null;
     } catch (e) {
+      // cookie读取异常直接返回空
       return null;
     }
   }
 
   /**
-   * 设置 Cookie：自动适配 HTTPS/HTTP，动态控制 Secure
+   * 设置持久化Cookie，有效期1年，自动适配HTTPS Secure标识
+   * @param {string} name cookie键名
+   * @param {string} value cookie存储值
    */
   function setCookie(name, value) {
     try {
       var isHttps = window.location.protocol === 'https:';
       var parts = [
         name + '=' + value,
-        'max-age=31536000',
-        'path=/',
-        'SameSite=Lax'
+        'max-age=31536000', // 有效期365天
+        'path=/', // 全站生效
+        'SameSite=Lax' // 防跨站劫持
       ];
-      if (isHttps) {
-        parts.push('Secure');
-      }
+      // HTTPS环境追加Secure标识
+      if (isHttps) parts.push('Secure');
       document.cookie = parts.join(';');
-    } catch (e) {
-    }
+    } catch (e) { }
+  }
+
+  /**
+   * 时间格式化工具，统一输出 yyyy-MM-dd HH:mm:ss
+   * @returns {string} 格式化后的标准时间字符串
+   */
+  function formatTime() {
+    var date_t = new Date();
+    var y_t = date_t.getFullYear();
+    var m_t = String(date_t.getMonth() + 1).padStart(2, '0');
+    var d_t = String(date_t.getDate()).padStart(2, '0');
+    var h_t = String(date_t.getHours()).padStart(2, '0');
+    var min_t = String(date_t.getMinutes()).padStart(2, '0');
+    var sec_t = String(date_t.getSeconds()).padStart(2, '0');
+    return y_t + "-" + m_t + "-" + d_t + " " + h_t + ":" + min_t + ":" + sec_t;
+  }
+
+  /**
+   * 填充单条埋点事件默认字段，缺失字段自动补空/默认行为类型，自动填充事件时间
+   * @param {Object} eventItem 业务传入的单条埋点原始参数
+   * @returns {Object} 补全默认值后的标准事件对象
+   */
+  function fillEventDefault(eventItem) {
+    // 事件字段默认模板，对齐后端data数组字段规范
+    var defaultEvent = {
+      element_position: "",    // 产品定义元素位置编码（唯一标识）
+      position_name: "",       // 元素位置中文名称
+      page_code: "",           // OMS后台页面编码，无则空字符串
+      page_name: "",           // OMS后台页面名称，无则空字符串
+      floor_id: "",            // OMS后台楼层ID
+      floor_name: "",          // OMS后台楼层名称
+      element_type: "",        // 元素枚举：page/vlist/plist/res/act/link等
+      element_name: "",        // 元素内部名称/标题
+      content_id: "",          // 最小颗粒度内容ID（游戏/视频ID）
+      content_title: "",       // 内容标题名称
+      ext_attr1: "",           // 扩展属性1，存放自定义附属信息
+      ext_attr2: "",           // 扩展属性2，存放附属ID类参数
+      action_type: "曝光",     // 行为枚举：曝光/点击/开始播放/结束播放/分享/订购/启动/退出/切后台
+      action_value: "",        // 行为附属值：播放时长填秒数、订购填金额(单位分)、无附属数据填空
+      event_time: ""           // 事件发生时间，不传则自动生成当前标准时间
+    };
+    // 业务参数覆盖默认模板
+    var merged = Object.assign({}, defaultEvent, eventItem);
+    // 未传入时间自动填充当前客户端时间
+    if (!merged.event_time) merged.event_time = formatTime();
+    return merged;
   }
 
-  // ========== 对外暴露对象 ==========
+  // ========== 对外暴露公共API ==========
   return {
-    // ===================== 公共配置 =====================
+    // 全局埋点配置项
     config: {
-      // 上报接口地址
-      reportUrl: 'https://sup.daoran.tv/bi-api/api/game/lewo/batch',
-      // reportUrl: '/bi-api/api/game/lewo/batch',
-      // 默认请求头
-      defaultHeaders: [
-        // { name: 'md5', value: "GYWmhK2MfuQtDc9Cj8Fbw9hGoJwQ+f3WTgHRahD1TRiA6TpexZSORQ==" }
-      ],
-      defaultContentType: 'application/json;charset=UTF-8',
-      // 默认行为类型
-      defaultActionType: '曝光'
-    },
-
-    // ===================== 公共上报字段模板（全部改为下划线字段，对齐后端接口图片参数） =====================
-    defaultReportItem: {
-      user_id: '',          // 用户唯一标识（需要用户登录，产生UID）
-      device_id: '',        // 设备唯一标识（设备号，如果无，则需要生成）
-      app_item: '',         // 渠道，如29，x5
-      content_type: '游戏', // 游戏（乐窝的游戏，这个字段都固定上报游戏）
-      content_id: '',       // 游戏ID（具体乐窝的游戏ID）
-      content_title: '',    // 游戏名（具体的乐窝游戏名）
-      element_position: '', // 元素位置（埋点范围表对应的 元素位置列）
-      action_type: '',      // 曝光/点击
-      event_name: '',       // 具体事件名（新增，友盟需要按照上面表格传值，通过元素位置和行为生成事件名字）
-      event_time: '',       // 客户端事件时间（格式建议：yyyy-MM-dd HH:mm:ss）
-      ad_request_id: ''     // 广告请求ID，仅广告相关事件需要
+      reportUrl: 'https://sup.daoran.tv/bi-api/api/game/lewo/batch', // 批量上报接口地址
+      // reportUrl: '/bi-api/api/game/lewo/batch', // 批量上报接口地址
+      defaultHeaders: [], // 默认全局请求头数组
+      defaultContentType: 'application/json;charset=UTF-8' // 请求体类型
     },
 
-    // ===================== 工具方法 =====================
     /**
-     * 合并默认上报字段，补全默认值
-     * @param {Object} item 传入的下划线格式上报数据
-     * @returns {Object} 合并后的完整上报项（下划线字段）
+     * 设置全局用户/设备公共信息（上报顶层user对象，全局复用）
+     * 页面初始化、登录、切换渠道、切换网络时调用一次即可
+     * @param {Object} userObj 用户设备公共参数集合
+     * userObj字段说明：
+     * os_type: 操作系统类型 android / ios 全小写
+     * os_version: 系统版本纯数字，如15、17.1
+     * app_version: APP完整版本号 7.3.0
+     * app_item: 渠道编码/项目编码
+     * app_name: APP展示名称
+     * app_project: 产品内部短编码
+     * province: 省份数字编码
+     * city: 城市数字编码
+     * uid: 登录用户全局UID，游客/未登录填空字符串
+     * user_id: 会员ID / cocos游客ID，无则空
+     * device_brand: 设备品牌全小写 huawei/xiaomi/apple
+     * device_model: 设备完整型号
+     * network_type: 网络类型 wifi / cellular(蜂窝流量)
+     * carrier: 运营商 移动/联通/电信/广电/未知
+     * device_id: 可选，不传内部自动生成UUID v4设备标识
      */
-    mergeReportItem: function (item) {
-      var merged = {};
-      var defaultItem = this.defaultReportItem;
-      // 拷贝默认值，传入值优先覆盖
-      for (var key in defaultItem) {
-        if (defaultItem.hasOwnProperty(key)) {
-          merged[key] = item[key] !== undefined ? item[key] : defaultItem[key];
-        }
+    initUserInfo: function (userObj) {
+      if (initInfoFlag) { return }
+      initInfoFlag = true;
+      // 未传入设备ID时，自动生成持久化UUID填充
+      if (!userObj.device_id) {
+        userObj.device_id = this.createDeviceId();
       }
-      // 自动生成事件时间（未传时）
-      if (!merged.event_time) {
-        merged.event_time = this.handleTime();
+      // 合并覆盖全局缓存，保留旧字段，新参数覆盖
+      globalUserInfo = Object.assign({}, globalUserInfo, userObj);
+
+      try {
+        // 1. 异步加载 H5 专属 SDK
+        (function (w, d, s, q, i) {
+          w[q] = w[q] || [];
+          var f = d.getElementsByTagName(s)[0],
+            j = d.createElement(s);
+          j.async = true;
+          j.id = 'beacon-aplus';
+          // ✅ 使用 H5 网页专属 SDK 地址
+          j.src = 'https://d.alicdn.com/alilog/mlog/aplus/' + i + '.js';
+          f.parentNode.insertBefore(j, f);
+        })(window, document, 'script', 'aplus_queue', '203467608');
+
+        // ========= 基础配置 =========
+        // 2. 设置 AppKey (请确保与友盟后台 H5/Web 应用的 AppKey 一致)
+        aplus_queue.push({
+          action: 'aplus.setMetaInfo',
+          arguments: ['appKey', '6a55f95f6f259537c7c966c8'] // 替换你的Umini AppKey
+        });
+        // 3. 声明终端类型为 PC (关键配置)
+        aplus_queue.push({
+          action: 'aplus.setMetaInfo',
+          arguments: ['aplus-terminal', 'pc']
+        });
+        // 4. 采集模式配置
+        // 传统多页网站(PC)建议改为 'AUTO'；如果是 Vue/React 单页应用(SPA)保持 'MAN'
+        aplus_queue.push({
+          action: 'aplus.setMetaInfo',
+          arguments: ['aplus-waiting', 'AUTO']
+        });
+        // 调试模式，上线务必改为false
+        aplus_queue.push({
+          action: 'aplus.setMetaInfo',
+          arguments: ['DEBUG', false]
+        });
+
+        // ✅【必须补充】显式初始化SDK
+        aplus_queue.push({
+          action: 'aplus.init'
+        });
+
+        // ⚠️【重点】aplus-idtype 说明
+        // 如果你使用业务自己device_id/uuid：值填 uuid
+        // 微信openid：openid；支付宝：alipay_id；字节：anonymousid
+        // 暂时不确定类型，可以先注释这一行，避免配置错误
+        /*
+        aplus_queue.push({
+          action: 'aplus.setMetaInfo',
+          arguments: ['aplus-idtype', 'uuid']
+        });
+        */
+      } catch (e) {
+
       }
-      // 填充默认行为类型
-      if (!merged.action_type) {
-        merged.action_type = this.config.defaultActionType;
+
+      try {
+        // 设置用户唯一ID（登录/游客都可以设置）
+        var u_user_id = userObj.uid || userObj.device_id || '';
+        // console.log('u_user_id', userObj, u_user_id)
+        aplus_queue.push({
+          action: 'aplus.setMetaInfo',
+          arguments: ['userId', u_user_id]
+        });
+      } catch (e) {
+
       }
-      console.log('mergeReportItem-result', merged);
-      return merged;
+
     },
 
     /**
-     * 时间格式化：yyyy-MM-dd HH:mm:ss
+     * 获取当前全局缓存的user公共信息（拷贝返回，防止外部篡改缓存）
+     * @returns {Object} 完整user公参对象
      */
-    handleTime: function () {
-      var date_t = new Date();
-      var y_t = date_t.getFullYear();
-      var m_t = date_t.getMonth() + 1;
-      m_t = m_t < 10 ? "0" + m_t : m_t;
-      var d_t = date_t.getDate();
-      d_t = d_t < 10 ? "0" + d_t : d_t;
-      var h_t = date_t.getHours();
-      h_t = h_t < 10 ? "0" + h_t : h_t;
-      var min_t = date_t.getMinutes();
-      min_t = min_t < 10 ? "0" + min_t : min_t;
-      var sec_t = date_t.getSeconds();
-      sec_t = sec_t < 10 ? "0" + sec_t : sec_t;
-      return y_t + "-" + m_t + "-" + d_t + " " + h_t + ":" + min_t + ":" + sec_t;
+    getUserInfo: function () {
+      return Object.assign({}, globalUserInfo);
     },
 
-    // ===================== 设备ID相关新增方法 =====================
     /**
-     * 获取或创建设备唯一ID（持久化，优先内存缓存 > localStorage > cookie）
-     * @returns {string} uuid v4 device_id
+     * 获取或生成持久化设备唯一ID
+     * 读取优先级：内存缓存 > localStorage > cookie > 新建UUID
+     * @returns {string} 小写标准UUID v4 device_id
      */
     createDeviceId: function () {
-      if (memoryCache) {
-        return memoryCache;
-      }
-
-      // 1. 尝试从 LocalStorage 读取
+      // 内存存在直接返回，减少存储读取
+      if (memoryCache) return memoryCache;
+      // 第一步读取localStorage
       try {
-        var existing = localStorage.getItem(STORAGE_KEY);
-        if (existing) {
-          existing = existing.trim();
-          memoryCache = existing.toLowerCase();
+        var storageId = localStorage.getItem(STORAGE_KEY);
+        if (storageId?.trim()) {
+          memoryCache = storageId.toLowerCase();
           return memoryCache;
         }
-      } catch (e) {
-      }
-
-      // 2. 尝试从 Cookie 读取
-      var existingCookie = getCookie(STORAGE_KEY);
-      if (existingCookie) {
-        existingCookie = existingCookie.trim();
-        memoryCache = existingCookie.toLowerCase();
-        // 尝试同步回 LocalStorage
-        try {
-          localStorage.setItem(STORAGE_KEY, memoryCache);
-        } catch (e) {
-        }
+      } catch (e) { }
+      // 第二步读取cookie
+      var cookieId = getCookie(STORAGE_KEY);
+      if (cookieId?.trim()) {
+        memoryCache = cookieId.toLowerCase();
+        // 同步写入localStorage，双存储统一
+        try { localStorage.setItem(STORAGE_KEY, memoryCache); } catch (e) { }
         return memoryCache;
       }
-
-      // 3. 重新生成并存储
+      // 无存储记录，新建UUID并持久化
       var newId = createUuidV4();
       memoryCache = newId;
-
-      try {
-        localStorage.setItem(STORAGE_KEY, newId);
-      } catch (e) {
-      }
+      try { localStorage.setItem(STORAGE_KEY, newId); } catch (e) { }
       setCookie(STORAGE_KEY, newId);
-
       return newId;
     },
 
     /**
-     * 重置/清除设备ID（清除内存缓存、localStorage、cookie）
+     * 重置清除本地全部设备ID缓存（退出账号/清除游客标识场景使用）
+     * 清空内存、localStorage、cookie三处存储
      */
     resetDeviceId: function () {
       memoryCache = null;
-      try {
-        localStorage.removeItem(STORAGE_KEY);
-      } catch (e) {
-      }
+      // 删除本地存储
+      try { localStorage.removeItem(STORAGE_KEY); } catch (e) { }
+      // 过期销毁cookie
       try {
         var isHttps = window.location.protocol === 'https:';
-        var cookieParts = [
-          STORAGE_KEY + '=',
-          'max-age=0',
-          'path=/',
-          'SameSite=Lax'
-        ];
-        if (isHttps) {
-          cookieParts.push('Secure');
-        }
+        var cookieParts = [STORAGE_KEY + '=', 'max-age=0', 'path=/', 'SameSite=Lax'];
+        if (isHttps) cookieParts.push('Secure');
         document.cookie = cookieParts.join(';');
-      } catch (e) {
-      }
-    },
-
-    // ===================== 核心上报方法 =====================
-    /**
-     * 单次日志上报
-     * @param {Object} obj 下划线格式的上报数据
-     */
-    superBatchReport: function (obj) {
-      var mergedItem = this.mergeReportItem(obj);
-      // 已为下划线字段，直接上报，移除驼峰转译逻辑
-      var dataObj = {
-        data: [mergedItem]
-      };
-      this.supersetAjax(dataObj);
+      } catch (e) { }
     },
 
     /**
-     * 批量曝光上报
-     * @param {Array} dataList 上报数据列表（下划线格式）
-     * @param {Object} commonInfo 可选-公共字段（设备信息，统一填充到所有条目）
-     */
-    batchReporting: function (dataList, commonInfo) {
-      console.log('BatchReporting', dataList);
-      var exposureFlag = false;
-      for (var i = 0; i < dataList.length; i++) {
-        var item = dataList[i];
-        if (item.exposureFlag) {
-          exposureFlag = true;
-          break;
-        }
-      }
-
-      if (!exposureFlag) {
-        var dataObj = {
-          "data": []
-        };
-        commonInfo = commonInfo || {};
-
-        for (var i = 0; i < dataList.length; i++) {
-          var item = dataList[i];
-          dataList[i].exposureFlag = true;
-
-          // 合并公共字段 + 当前条目字段
-          var reportItem = {};
-          for (var cKey in commonInfo) {
-            if (commonInfo.hasOwnProperty(cKey)) {
-              reportItem[cKey] = commonInfo[cKey];
-            }
-          }
-          for (var iKey in item) {
-            if (item.hasOwnProperty(iKey)) {
-              reportItem[iKey] = item[iKey];
-            }
-          }
-
-          // 合并默认值，直接下划线结构推入数组
-          var mergedItem = this.mergeReportItem(reportItem);
-          dataObj.data.push(mergedItem);
-        }
-
-        console.log(dataObj);
-        this.supersetAjax(dataObj);
-      }
-    },
-
-    /**
-     * 上报请求封装
-     * @param {Object} dataObj 完整的请求体
+     * 上报请求中转封装，调用底层ES5 ajax
+     * @param {Object} dataObj 完整上报报文 {user:{}, data:[]}
      */
     supersetAjax: function (dataObj) {
       this.ajax({
@@ -296,17 +313,17 @@ var supersetLewo = (function () {
         dataType: 'json',
         headers: [],
         success: function (xhr, rsp) {
-
+          // 上报成功回调，业务可自行扩展
         },
         error: function (xhr, rsp) {
-
+          console.error('[supersetLewo 埋点上报失败]', rsp);
         }
       });
     },
 
     /**
-     * 基础ajax封装
-     * @param {Object} config 请求配置
+     * ES5 底层原生XMLHttpRequest AJAX封装（还原最初版本逻辑，无Promise/Beacon）
+     * @param {Object} config 请求配置对象
      */
     ajax: function (config) {
       var url = config.url;
@@ -320,6 +337,7 @@ var supersetLewo = (function () {
       var fnError = config.error || function () { };
       var xmlhttp;
 
+      // 兼容IE低版本XMLHttpRequest
       if (window.XMLHttpRequest) {
         xmlhttp = new XMLHttpRequest();
       } else {
@@ -330,16 +348,14 @@ var supersetLewo = (function () {
         if (xmlhttp.readyState == 4) {
           var rsp = xmlhttp.responseText || xmlhttp.responseXML;
           var parseError = false;
-          // 增加JSON解析异常捕获，避免响应格式错误导致页面报错
+          // JSON解析异常捕获，防止页面报错
           if (dataType == 'json' && typeof rsp == 'string') {
             try {
               rsp = JSON.parse(rsp);
             } catch (e) {
               parseError = true;
-              return;
             }
           }
-
           if (parseError) {
             fnError(xmlhttp, rsp);
           } else if (xmlhttp.status == 200) {
@@ -351,61 +367,185 @@ var supersetLewo = (function () {
       };
 
       xmlhttp.open(type, url, dataAsync);
+      // 追加自定义请求头
       for (var i = 0; i < headers.length; ++i) {
         xmlhttp.setRequestHeader(headers[i].name, headers[i].value);
       }
       xmlhttp.setRequestHeader('Content-Type', contentType);
+      // 对象转JSON字符串发送
       data = JSON.stringify(data);
       xmlhttp.send(data);
-    }
+    },
+
+    /**
+     * 单条埋点事件上报
+     * @param {Object} eventParam 单条事件埋点参数，字段对齐data数组规范
+     */
+    superBatchReport: function (eventParam) {
+      // 填充缺失默认字段与事件时间
+      var eventItem = fillEventDefault(eventParam);
+      // 组装标准上报报文
+      var reportBody = {
+        user: this.getUserInfo(), // 全局公共用户设备信息
+        data: [eventItem] // 单事件数组
+      };
+      this.supersetAjax(reportBody);
+
+      // return
+
+      try {
+        var action_type = eventParam.action_type == '点击' ? 'CLICK' : 'EXPOSURE'
+        var eventName = eventParam.element_position + '_' + action_type
+
+        // console.log('um-action_type', action_type)
+        // console.log('um-eventName', eventName)
+        // console.log('um-aplus_queue', aplus_queue)
+        aplus_queue.push({
+          action: 'aplus.record',
+          // 第二个参数事件类型：CLICK / EXPOSURE / PAGE等，常规点击用CLICK
+          arguments: [eventName, action_type, eventParam]
+        });
+      } catch (e) {
+        console.log("superBatchReport-umeng error", e)
+      }
+    },
+
+    /**
+     * 批量多条埋点事件上报（一次性上报多个行为，减少请求次数）
+     * @param {Array} eventList 多条埋点事件对象数组
+     */
+    batchReporting: function (eventList) {
+      // 非数组/空数组直接终止上报
+      if (!Array.isArray(eventList) || eventList.length === 0) return;
+      // 批量填充每条事件默认参数
+      var filledData = [];
+      for (var i = 0; i < eventList.length; i++) {
+        filledData.push(fillEventDefault(eventList[i]));
+      }
+      // 组装批量上报报文
+      var reportBody = {
+        user: this.getUserInfo(),
+        data: filledData
+      };
+      this.supersetAjax(reportBody);
+    },
+
   };
 })();
 
-// 单次上报调用示例（入参直接使用下划线key，方法名保持驼峰不变）
-/*supersetLewo.superBatchReport({
-  user_id: '',          // 用户唯一标识（需要用户登录，产生UID）
-  device_id: supersetLewo.createDeviceId(),       // 设备唯一标识（设备号，如果无，则需要生成）
-  app_item: '29',         // 渠道，如29，x5
-  content_type: '游戏',     // 游戏（乐窝的游戏，这个字段都固定上报游戏）
-  content_id: '',       // 游戏ID（具体乐窝的游戏ID）
-  content_title: '',    // 游戏名（具体的乐窝游戏名）
-  element_position: '', // 元素位置（埋点范围表对应的 元素位置列）
-  action_type: '曝光',      // 曝光/点击
-  event_name: '',       // 具体事件名（新增，友盟需要按照上面表格传值，通过元素位置和行为生成事件名字）
-  ad_request_id: '',   // 广告请求ID，仅广告相关事件需要
-  event_time: '',       // 客户端事件时间（格式建议：yyyy-MM-dd HH:mm:ss）
+// ===================== 使用示例（带详细注释） =====================
+/**
+ * 示例1：页面初始化/登录后 设置全局用户设备公共信息，初始化友盟埋点SDK
+ * 仅需初始化一次，后续所有superBatchReport/batchReporting自动携带user参数
+ */
+// console.log("initUserInfo");
+/*supersetLewo.initUserInfo({
+  os_type: "windows",          // 系统类型安卓
+  os_version: "1",            // 安卓版本15
+  app_version: "1.0.0",        // APP版本号
+  app_item: "",              // 渠道编码
+  app_name: "",      // APP展示名称
+  app_project: "",          // 产品内部编码
+  province: "100",             // 省份编码
+  city: "",                // 城市编码
+  uid: "",            // 登录用户UID，未登录填空""
+  user_id: "",         // 会员/游客ID，无则填空""
+  device_id: "",               // 设备唯一ID，没有或不传则自动生成
+  device_brand: "",      // 手机品牌小写
+  device_model: "",    // 手机完整型号
+  network_type: "",    // 蜂窝流量网络
+  carrier: ""              // 运营商
+  // device_id 不传，内部自动生成UUID填充，无需手动传入
 });*/
-
-
-// 批量上报调用示例（方法名驼峰，参数下划线）
-/*supersetLewo.batchReporting([
+console.log("initUserInfo", supersetLewo.getUserInfo());
+
+/**
+ * 示例2：单条埋点上报 - 首页曝光事件
+ * 调用superBatchReport，仅传入当前事件独有字段，公共user自动拼接
+ */
+
+/*setTimeout(function () {
+  supersetLewo.superBatchReport({
+    element_position: "Main_Start",    // 元素位置编码
+    position_name: "游戏主页",         // 中文位置名称
+    page_code: "",              // OMS后台页面编码，无则空
+    page_name: "",              // OMS后台页面名称，无则空
+    element_type: "page",              // 元素类型页面
+    element_name: "gamestart",         // 元素标识名
+    content_id: "10001",               // 当前页面绑定内容ID
+    content_title: "我和美女有个约会",  // 内容标题
+    action_type: "曝光",               // 行为：曝光
+    action_value: "",                   // 行为值，时长填秒数，订购填金额（单位：分）；无时间跨度行为填空
+    event_time: ''               // event_time不传，内部自动生成当前时间
+  });
+}, 2000);*/
+
+
+/**
+ * 示例3：单条埋点上报 - 游戏卡片点击事件
+ */
+/*
+supersetLewo.superBatchReport({
+  element_position: "Game_Card_List",
+  position_name: "游戏列表卡片",
+  element_type: "vlist",
+  element_name: "game_item",
+  content_id: "10002",
+  content_title: "开心消消乐",
+  action_type: "点击",
+  action_value: ""
+});
+*/
+
+/**
+ * 示例4：批量埋点上报，一次性上报曝光+点击两条事件，减少http请求
+ * 调用batchReporting，传入事件数组
+ */
+/*
+supersetLewo.batchReporting([
+  // 第一条：首页曝光
   {
-    user_id: 'test123',
-    device_id: supersetLewo.createDeviceId(),
-    app_item: '29',
-    content_type: '游戏',
-    content_id: '1',
-    content_title: '2',
-    element_position: '3',
-    action_type: '曝光',
-    event_name: '4',
-    ad_request_id: '',
-    event_time: '',
+    element_position: "Main_Start",
+    position_name: "游戏主页",
+    element_type: "page",
+    content_id: "10001",
+    content_title: "我和美女有个约会",
+    action_type: "曝光"
   },
+  // 第二条：游戏卡片点击
   {
-    user_id: 'test123444',
-    device_id: supersetLewo.createDeviceId(),
-    app_item: '29',
-    content_type: '游戏',
-    content_id: '1',
-    content_title: '2',
-    element_position: '3',
-    action_type: '曝光',
-    event_name: '4',
-    ad_request_id: '',
-    event_time: '',
+    element_position: "Game_Card_List",
+    position_name: "游戏列表卡片",
+    element_type: "vlist",
+    content_id: "10002",
+    content_title: "开心消消乐",
+    action_type: "点击"
   }
-])*/
+]);
+*/
+
+/**
+ * 示例5：播放结束埋点（携带播放时长action_value，单位秒）
+ */
+/*
+supersetLewo.superBatchReport({
+  element_position: "Game_Play_Page",
+  position_name: "游戏播放页",
+  element_type: "page",
+  content_id: "10003",
+  content_title: "夏日沙滩派对",
+  action_type: "结束播放",
+  action_value: "125" // 播放总时长125秒
+});
+*/
+
+/**
+ * 示例6：清除游客设备ID（切换账号/清除本地标识使用）
+ */
+/*
+supersetLewo.resetDeviceId();
+*/
+
 
 // CommonJS 模块导出（不改动上方 IIFE 逻辑）
 if (typeof module !== 'undefined' && module.exports) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drgame-cc",
-  "version": "1.0.18",
+  "version": "1.0.20",
   "description": "道然游戏适配包",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -32,8 +32,9 @@
     "rimraf": "^5.0.0"
   },
   "dependencies": {
-    "typescript": "5.9.3",
-    "fs-extra": "^11.2.0"
+    "fs-extra": "^11.2.0",
+    "pinyin-pro": "^3.28.2",
+    "typescript": "^5.0.0"
   },
   "peerDependencies": {
     "typescript": "^5.0.0"