drgame-cc 1.0.62 → 1.0.63

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

@@ -0,0 +1,515 @@
+/**
+ * 数据上报模块 - 统一封装层
+ *
+ * 内部使用 supersetLewo 上报脚本，对外提供简洁的调用接口：
+ *   Reporter.init(config)             — 初始化
+ *   Reporter.report(data, immediate)  — 单次上报（默认加入队列批量发送）
+ *   Reporter.reportBatch(list)        — 批量上报
+ *   Reporter.flushQueue()             — 立即刷新队列
+ *   Reporter.reportAppStart()         — 启动事件
+ *   Reporter.reportSwitchBackground() — 切后台事件
+ *   Reporter.reportSwitchBack()       — 切回事件
+ *   Reporter.reportAppExit()          — 退出事件（自动计算游戏时长）
+ *   Reporter.updateUserInfo(info)     — 登录后更新用户信息
+ */
+
+import supersetLewo from './superset-lewo';
+import {
+    IReporterConfig,
+    IReportItem,
+} from '../types/interfaces';
+
+// ────────────────────────────────────────
+// 上报动作类型
+// ────────────────────────────────────────
+
+export const ActionType = {
+    /** 曝光 */
+    Exposure: '曝光',
+    /** 点击 */
+    Click: '点击',
+    /** 开始播放 */
+    StartPlay: '开始播放',
+    /** 结束播放（需上报时长 action_value） */
+    EndPlay: '结束播放',
+    /** 分享 */
+    Share: '分享',
+    /** 订购（需上报成功订购金额） */
+    Order: '订购',
+    /** 启动 */
+    Start: '启动',
+    /** 退出 */
+    Exit: '退出',
+    /** 切后台 */
+    SwitchBackground: '切后台',
+    /** 切回 */
+    SwitchBack: '切回',
+} as const;
+
+export interface IBatchConfig {
+    /** 每批最大条数 */
+    perNum: number;
+    /** 发送间隔（秒） */
+    spaceSec: number;
+}
+
+// ────────────────────────────────────────
+// 内部队列管理（无需修改 supersetLewo）
+// ────────────────────────────────────────
+
+/** 配置接口地址 */
+const CONFIG_URL = 'https://sup.daoran.tv/bi-api/api/config/get';
+
+/** 事件队列 */
+const _eventQueue: IReportItem[] = [];
+/** 定时器句柄 */
+let _batchTimer: any = null;
+/** 每批最大条数 */
+let _perNum = 10;
+/** 发送间隔（秒） */
+let _spaceSec = 30;
+/** 队列模式是否已启用 */
+let _queueEnabled = false;
+
+/** 会话启动时间戳（毫秒），用于计算游戏时长 */
+let _sessionStartTime = 0;
+
+/** 额外用户信息（登录后填充，合并到上报 user 对象） */
+const _extraUserInfo: Record<string, string> = {};
+
+/**
+ * 修补 supersetLewo.getUserInfo，使登录后的额外字段能合并到 user 对象
+ * 避免修改 superset-lewo 源文件
+ */
+(function _patchGetUserInfo() {
+    const originalGetUserInfo = supersetLewo.getUserInfo;
+    supersetLewo.getUserInfo = function () {
+        const info = originalGetUserInfo();
+        // 合并额外字段（如 user_id、user_type 等）
+        for (const key in _extraUserInfo) {
+            if (_extraUserInfo.hasOwnProperty(key)) {
+                info[key] = _extraUserInfo[key];
+            }
+        }
+        return info;
+    };
+})();
+
+/**
+ * 刷新队列 —— 将队列中所有事件打包发送
+ */
+function _flushQueue() {
+    if (_eventQueue.length === 0) return;
+    const batch = _eventQueue.splice(0, _perNum);
+    supersetLewo.batchReporting(batch);
+}
+
+/**
+ * 添加单条事件到队列
+ */
+function _addToQueue(eventItem: IReportItem) {
+    _eventQueue.push(eventItem);
+    if (_eventQueue.length >= _perNum) {
+        _flushQueue();
+    }
+}
+
+/**
+ * 批量添加事件到队列
+ */
+function _addBatchToQueue(eventList: IReportItem[]) {
+    if (!Array.isArray(eventList) || eventList.length === 0) return;
+    for (let i = 0; i < eventList.length; i++) {
+        _eventQueue.push(eventList[i]);
+    }
+    if (_eventQueue.length >= _perNum) {
+        _flushQueue();
+    }
+}
+
+/**
+ * 启用队列定时刷新
+ */
+function _startQueueTimer() {
+    if (_queueEnabled) return;
+    _queueEnabled = true;
+    _batchTimer = setInterval(_flushQueue, _spaceSec * 1000);
+}
+
+/**
+ * 停止队列定时刷新
+ */
+function _stopQueueTimer() {
+    _queueEnabled = false;
+    if (_batchTimer) {
+        clearInterval(_batchTimer);
+        _batchTimer = null;
+    }
+}
+
+// ────────────────────────────────────────
+// Reporter 实现
+// ────────────────────────────────────────
+
+export interface ReporterLike {
+    _initialized: boolean;
+    _commonInfo: Record<string, any>;
+    init(config: IReporterConfig): void;
+    fetchReportConfig(callback?: (config: IBatchConfig) => void): void;
+    report(data: IReportItem, immediate?: boolean): void;
+    reportBatch(dataList: IReportItem[], commonInfo?: IReportItem, immediate?: boolean): void;
+    flushQueue(): void;
+    createDeviceId(): string;
+    resetDeviceId(): void;
+    setCommonInfo(info: Record<string, any>): void;
+    getCommonInfo(): Record<string, any>;
+    updateUserInfo(userInfo: Record<string, string>): void;
+    reportAppStart(): void;
+    reportSwitchBackground(): void;
+    reportSwitchBack(): void;
+    reportAppExit(): void;
+    readonly instance: any;
+}
+
+const Rep: ReporterLike = {
+    /** 是否已初始化 */
+    _initialized: false,
+
+    /** 公共字段缓存（初始化时设置，每次上报自动合并） */
+    _commonInfo: {},
+
+    /**
+     * 从后端获取批量上报配置
+     */
+    fetchReportConfig: function (callback?: (config: IBatchConfig) => void) {
+        supersetLewo.ajax({
+            url: CONFIG_URL,
+            type: 'get',
+            dataType: 'json',
+            data: {},
+            success: function (_xhr, rsp) {
+                if (rsp && rsp.code === 200 && rsp.data) {
+                    const cfg = rsp.data;
+                    _perNum = cfg.perNum || 10;
+                    _spaceSec = cfg.spaceSec || 30;
+                    if (typeof callback === 'function') {
+                        callback({ perNum: _perNum, spaceSec: _spaceSec });
+                    }
+                } else {
+                    if (typeof callback === 'function') {
+                        callback({ perNum: 10, spaceSec: 30 });
+                    }
+                }
+            },
+            error: function (_xhr, rsp) {
+                console.warn('[Reporter] fetchReportConfig failed, use defaults', rsp);
+                if (typeof callback === 'function') {
+                    callback({ perNum: 10, spaceSec: 30 });
+                }
+            }
+        });
+    },
+
+    /**
+     * 初始化上报模块
+     */
+    init: function (config: IReporterConfig) {
+        config = config || {};
+
+        // 设置上报地址（未传则使用 supersetLewo 默认值）
+        if (config.report_url) {
+            supersetLewo.config.reportUrl = config.report_url;
+        }
+
+        // 设置请求头
+        if (config.headers && config.headers.length > 0) {
+            supersetLewo.config.defaultHeaders = config.headers as any;
+        }
+
+        // 设置默认行为类型
+        if (config.default_action_type) {
+            (supersetLewo.config as any).defaultActionType = config.default_action_type;
+        }
+
+        // 缓存公共字段
+        this._commonInfo = {
+            app_item: config.app_item || '',
+            content_type: config.content_type || '游戏',
+            content_id: config.content_id || '',
+            content_title: config.content_title || '',
+        };
+
+        // 自动填充 device_id
+        if (!this._commonInfo.device_id) {
+            this._commonInfo.device_id = supersetLewo.createDeviceId();
+        }
+
+        supersetLewo.initUserInfo({
+            os_type: config.os_type || "",                // 操作系统类型 android/ios
+            os_version: config.os_version || "",          // 操作系统版本号
+            app_version: config.app_version || "1.0.0",   // APP版本号
+            app_item: config.app_item || "",              // 渠道编码（项目编码）
+            app_name: config.app_name || config.content_title || "",  // APP名称
+            app_project: config.app_project || config.content_id || "", // 产品编码
+            province: config.province || "",              // 省份编码
+            city: config.city || "",                      // 城市编码
+            uid: config.uid || "",                        // 注册登录用户全局UID；游客/未登录填空字符串
+            user_id: config.user_id || "",                // 会员ID(memberId)，无则填空字符串，不用uid填充
+            device_id: this._commonInfo.device_id,        // 设备唯一ID
+            device_brand: config.device_brand || "",      // 设备品牌，小写
+            device_model: config.device_model || "",      // 设备型号
+            network_type: config.network_type || "",      // 网络类型：wifi/cellular
+            carrier: config.carrier || "",                // 运营商
+            promotion_flag: config.promotion_flag || "0", // 推广标识(ubp接口获取,1推广/0自然)
+            user_type: config.user_type || "0"            // 用户身份类型(0游客/1注册用户/2付费用户)
+        });
+
+        this._initialized = true;
+
+        // 记录启动时间
+        _sessionStartTime = Date.now();
+
+        // 异步拉取批量配置，拉取成功后启动队列
+        this.fetchReportConfig(function (batchCfg) {
+            _startQueueTimer();
+            console.log('[Reporter] Batch config:', batchCfg, '- Queue mode enabled');
+        });
+
+        console.log('[Reporter] Initialized, reportUrl:', supersetLewo.config.reportUrl);
+    },
+
+    /**
+     * 单次上报
+     */
+    report: function (data: IReportItem, immediate?: boolean) {
+        if (!this._initialized) {
+            console.warn('[Reporter] Not initialized. Call Reporter.init() first.');
+            return;
+        }
+
+        // 合并公共字段 + 传入数据
+        const merged: IReportItem = {};
+        let key: string;
+        for (key in this._commonInfo) {
+            if (this._commonInfo.hasOwnProperty(key)) {
+                merged[key] = this._commonInfo[key];
+            }
+        }
+        for (key in data) {
+            if (data.hasOwnProperty(key)) {
+                merged[key] = data[key];
+            }
+        }
+
+        // 自动填充 device_id
+        if (!merged.device_id) {
+            merged.device_id = supersetLewo.createDeviceId();
+        }
+
+        if (immediate) {
+            // 立即发送（生命周期事件等需要及时上报的场景）
+            supersetLewo.superBatchReport(merged);
+        } else {
+            // 加入队列，凑批次后批量发送
+            _addToQueue(merged);
+        }
+    },
+
+    /**
+     * 批量上报
+     */
+    reportBatch: function (dataList: IReportItem[], commonInfo?: IReportItem, immediate?: boolean) {
+        if (!this._initialized) {
+            console.warn('[Reporter] Not initialized. Call Reporter.init() first.');
+            return;
+        }
+
+        const mergedCommon: IReportItem = {};
+        let key: string;
+
+        // 合并初始化时的公共字段
+        for (key in this._commonInfo) {
+            if (this._commonInfo.hasOwnProperty(key)) {
+                mergedCommon[key] = this._commonInfo[key];
+            }
+        }
+
+        // 合并传入的公共字段（优先级更高）
+        if (commonInfo) {
+            for (key in commonInfo) {
+                if (commonInfo.hasOwnProperty(key)) {
+                    mergedCommon[key] = commonInfo[key];
+                }
+            }
+        }
+
+        // 自动填充 device_id
+        if (!mergedCommon.device_id) {
+            mergedCommon.device_id = supersetLewo.createDeviceId();
+        }
+
+        // 合并公共字段到各事件中
+        const items: IReportItem[] = [];
+        for (let i = 0; i < dataList.length; i++) {
+            const item: IReportItem = {};
+            for (key in mergedCommon) {
+                if (mergedCommon.hasOwnProperty(key)) {
+                    item[key] = mergedCommon[key];
+                }
+            }
+            for (key in dataList[i]) {
+                if (dataList[i].hasOwnProperty(key)) {
+                    item[key] = dataList[i][key];
+                }
+            }
+            items.push(item);
+        }
+
+        if (immediate) {
+            // 立即发送
+            supersetLewo.batchReporting(items);
+        } else {
+            // 加入队列
+            _addBatchToQueue(items);
+        }
+    },
+
+    /**
+     * 立即刷新队列，将队列中所有事件立即发送
+     */
+    flushQueue: function () {
+        _flushQueue();
+    },
+
+    /**
+     * 上报「启动」事件 - APP启动成功后调用，记录启动时间
+     */
+    reportAppStart: function () {
+        _sessionStartTime = Date.now();
+        this.report({
+            element_position: "AppLaunch",
+            position_name: "应用启动",
+            element_type: "page",
+            element_name: "app_start",
+            action_type: ActionType.Start,
+            action_value: ""
+        }, true);
+    },
+
+    /**
+     * 上报「切后台」事件 - APP切到后台时调用
+     */
+    reportSwitchBackground: function () {
+        const duration = Math.floor((Date.now() - _sessionStartTime) / 1000);
+        this.report({
+            element_position: "AppBackground",
+            position_name: "应用切后台",
+            element_type: "page",
+            element_name: "app_switch_background",
+            action_type: ActionType.SwitchBackground,
+            action_value: String(duration)
+        }, true);
+    },
+
+    /**
+     * 上报「切回」事件 - APP从后台切回时调用，上报后更新启动时间
+     */
+    reportSwitchBack: function () {
+        this.report({
+            element_position: "AppForeground",
+            position_name: "应用切前台",
+            element_type: "page",
+            element_name: "app_switch_back",
+            action_type: ActionType.SwitchBack,
+            action_value: ""
+        }, true);
+        // 更新启动时间
+        _sessionStartTime = Date.now();
+    },
+
+    /**
+     * 上报「退出」事件 - APP退出前调用
+     */
+    reportAppExit: function () {
+        // 先刷新队列中剩余事件
+        _flushQueue();
+
+        const duration = Math.floor((Date.now() - _sessionStartTime) / 1000);
+        this.report({
+            element_position: "AppExit",
+            position_name: "应用退出",
+            element_type: "page",
+            element_name: "app_exit",
+            action_type: ActionType.Exit,
+            action_value: String(duration)
+        }, true);
+        // 重置启动时间
+        _sessionStartTime = 0;
+    },
+
+    /**
+     * 更新用户信息（登录后调用，传入memberId等）
+     */
+    updateUserInfo: function (userInfo: Record<string, string>) {
+        if (!userInfo) return;
+        // 更新公共字段（合并到 data 事件中）
+        this.setCommonInfo(userInfo);
+        // 更新额外用户信息（合并到上报的 user 对象中）
+        for (const key in userInfo) {
+            if (userInfo.hasOwnProperty(key)) {
+                _extraUserInfo[key] = userInfo[key];
+            }
+        }
+        console.log('[Reporter] updateUserInfo:', userInfo);
+    },
+
+    /**
+     * 获取或创建设备唯一ID
+     */
+    createDeviceId: function () {
+        return supersetLewo.createDeviceId();
+    },
+
+    /**
+     * 重置设备ID（清除缓存、localStorage、cookie）
+     */
+    resetDeviceId: function () {
+        supersetLewo.resetDeviceId();
+        if (this._commonInfo) {
+            this._commonInfo.device_id = supersetLewo.createDeviceId();
+        }
+    },
+
+    /**
+     * 更新公共字段（如用户登录后更新 user_id）
+     */
+    setCommonInfo: function (info: Record<string, any>) {
+        for (const key in info) {
+            if (info.hasOwnProperty(key)) {
+                this._commonInfo[key] = info[key];
+            }
+        }
+    },
+
+    /**
+     * 获取当前公共字段
+     */
+    getCommonInfo: function () {
+        const copy: Record<string, any> = {};
+        for (const key in this._commonInfo) {
+            if (this._commonInfo.hasOwnProperty(key)) {
+                copy[key] = this._commonInfo[key];
+            }
+        }
+        return copy;
+    },
+
+    /** 获取底层 supersetLewo 实例（高级用法） */
+    get instance() {
+        return supersetLewo;
+    },
+};
+
+export const Reporter: ReporterLike = Rep;
+
+export default Reporter;

package/drscript/ad-sdk/reporters/reporter.ts.meta

@@ -0,0 +1,10 @@
+{
+  "ver": "1.1.0",
+  "uuid": "dba3ec46-53f5-41ee-941d-303e130f6f76",
+  "importer": "typescript",
+  "isPlugin": false,
+  "loadPluginInWeb": true,
+  "loadPluginInNative": true,
+  "loadPluginInEditor": false,
+  "subMetas": {}
+}