qb-pc-sdk 1.0.2 → 1.0.4

package/README.md

@@ -1,8 +1,9 @@
 # qb-pc-sdk
 
 趣变广告 SDK 封装器 - PC端广告接入工具  
+目前PC SDK仅支持Windows系统接入，接入Mac会报错，接入时请注意。
 自动处理多级接口映射与原生渲染逻辑，简化广告接入流程。  
-从 1.0.1 起，浏览器环境会自动加载底层依赖 `qb-pc-ad-sdk-origin`（已改名的原始 SDK），常规打包场景开箱即用。
+从 1.0.1 起，浏览器环境会自动加载底层依赖 `qb-pc-ad-sdk-origin`，常规打包场景开箱即用。
 
 ## 安装
 
@@ -67,6 +68,33 @@ const adSDK = new AdSDKWrapper({
 > **注意**：`AdSDK` / `AdSDKWrapper` 是同一个类。  
 > 在浏览器打包场景（webpack/Vite 等）无需再单独 `import 'qb-pc-ad-sdk-origin'`，入口已在有 `window` 时自动 `require` 底层 SDK。若在极端沙箱/SSR 场景下未能挂载 `window.GDTAdSDK`，可手动在入口补充 `import 'qb-pc-ad-sdk-origin';` 作为兜底。
 
+#### Vue2 / Vue3 / React 等模块化环境（推荐方式）
+
+在某些模块化打包环境中（如 Vue2），如果自动加载失败，需要手动引入底层 SDK 并挂载到 `window`：
+
+```javascript
+// main.js 或入口文件
+import 'qb-pc-ad-sdk-origin/dist/qb-pc-ad-sdk.v1.0.0.js';
+import AdSDK from 'qb-pc-sdk';
+import OriginSDK from 'qb-pc-ad-sdk-origin';
+
+// 确保 GDTAdSDK 挂载到 window（模块化环境可能需要手动挂载）
+if (typeof window !== 'undefined' && !window.GDTAdSDK) {
+    window.GDTAdSDK = OriginSDK.default || OriginSDK.GDTAdSDK || OriginSDK;
+}
+
+// 之后在组件中使用
+new AdSDK({
+    appId: 'your-app-id',
+    placementId: 'your-placement-id',
+    container: '#ad-container',
+    onAdLoaded: (ad) => console.log('广告加载成功', ad),
+    onAdError: (error, message) => console.error('广告加载失败', error, message)
+});
+```
+
+> **提示**：如果遇到 "SDK Load Timeout" 错误，通常是 `window.GDTAdSDK` 未正确挂载，请按照上述方式手动挂载。
+
 ### 浏览器直接引入（不经打包）
 
 ```html

package/index.js

@@ -6,13 +6,105 @@
 
 const isBrowser = typeof window !== 'undefined';
 
+// 拦截并过滤微信游戏SDK相关的错误日志（在加载底层SDK之前，仅拦截一次）
+if (isBrowser && typeof window !== 'undefined' && window.console && !window.console.error._qbsdkFiltered) {
+    const originalError = window.console.error;
+    const originalWarn = window.console.warn;
+    
+    // 过滤函数，检查是否应该过滤
+    const shouldFilter = function(...args) {
+        const errorText = args.join(' ').toLowerCase();
+        return (
+            errorText.includes('微信') || 
+            errorText.includes('wechat') || 
+            errorText.includes('weixin') ||
+            errorText.includes('wxgame') ||
+            errorText.includes('微信游戏') ||
+            errorText.includes('微信小游戏') ||
+            errorText.includes('wxgamesdkframe') ||
+            errorText.includes('localhost.weixin.qq.com') ||
+            errorText.includes('wx_game_base') ||
+            errorText.includes('getgamesession') ||
+            errorText.includes('xmlhttprequest') ||
+            errorText.includes('err_failed') ||
+            errorText.includes('err_connection_refused') ||
+            errorText.includes('cors policy') ||
+            errorText.includes('secure context') ||
+            errorText.includes('loopback') ||
+            errorText.includes('more-private address space')
+        );
+    };
+    
+    const filteredError = function(...args) {
+        // 如果不是微信相关的错误，正常输出
+        if (!shouldFilter(...args)) {
+            originalError.apply(window.console, args);
+        }
+    };
+    
+    const filteredWarn = function(...args) {
+        // 如果不是微信相关的警告，正常输出
+        if (!shouldFilter(...args)) {
+            originalWarn.apply(window.console, args);
+        }
+    };
+    
+    // 标记已过滤，避免重复拦截
+    filteredError._qbsdkFiltered = true;
+    filteredWarn._qbsdkFiltered = true;
+    window.console.error = filteredError;
+    window.console.warn = filteredWarn;
+    
+    // 拦截全局错误事件，过滤微信游戏SDK相关的错误
+    if (!window._qbsdkErrorHandlerAdded) {
+        const originalOnError = window.onerror;
+        window.onerror = function(message, source, lineno, colno, error) {
+            const errorText = (message || '').toLowerCase() + (source || '').toLowerCase();
+            if (shouldFilter(errorText)) {
+                // 静默处理，不输出
+                return true; // 阻止默认错误处理
+            }
+            // 其他错误正常处理
+            if (originalOnError) {
+                return originalOnError.call(this, message, source, lineno, colno, error);
+            }
+            return false;
+        };
+        
+        // 拦截未捕获的 Promise rejection
+        const originalUnhandledRejection = window.onunhandledrejection;
+        window.addEventListener('unhandledrejection', function(event) {
+            const errorText = (event.reason?.message || event.reason || '').toString().toLowerCase();
+            if (shouldFilter(errorText)) {
+                // 阻止默认行为，静默处理
+                event.preventDefault();
+                return;
+            }
+            // 其他错误正常处理
+            if (originalUnhandledRejection) {
+                originalUnhandledRejection.call(window, event);
+            }
+        });
+        
+        window._qbsdkErrorHandlerAdded = true;
+    }
+}
+
 // 浏览器中预加载底层 SDK（仅 side-effect，挂载 window.GDTAdSDK）
 if (isBrowser) {
     try {
-        require('qb-pc-ad-sdk-origin');
+        const OriginSDK = require('qb-pc-ad-sdk-origin');
+        // 如果模块导出了对象但未挂载到 window，手动挂载
+        if (OriginSDK && !window.GDTAdSDK) {
+            window.GDTAdSDK = OriginSDK.default || OriginSDK.GDTAdSDK || OriginSDK;
+        }
     } catch (err) {
         // 这里不抛出，保持封装层逻辑可继续运行并给出错误回调
-        console.warn('[AdSDK] 底层 SDK 加载失败，请确认 qb-pc-ad-sdk-origin 已正确安装', err);
+        // 在 Vue/React 等环境中，用户可能需要手动引入并挂载
+        if (process.env.NODE_ENV !== 'production') {
+            console.warn('[AdSDK] 底层 SDK 自动加载失败，若在模块化环境中，请手动引入：', 
+                'import \'qb-pc-ad-sdk-origin/dist/qb-pc-ad-sdk.v1.0.0.js\';', err);
+        }
     }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qb-pc-sdk",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "趣变广告 SDK 封装器 - PC端广告接入工具，自动处理多级接口映射与原生渲染逻辑",
   "main": "index.js",
   "files": [

package/src/ad-sdk-wrapper.js

@@ -8,6 +8,90 @@
     // 兼容浏览器和 Node.js 环境
     const window = typeof global !== 'undefined' && global.window ? global.window : (typeof window !== 'undefined' ? window : global);
 
+    // 拦截并过滤微信游戏SDK相关的错误日志（仅拦截一次）
+    if (typeof window !== 'undefined' && window.console && !window.console.error._qbsdkFiltered) {
+        const originalError = window.console.error;
+        const originalWarn = window.console.warn;
+        
+        // 过滤函数，检查是否应该过滤
+        const shouldFilter = function(...args) {
+            const errorText = args.join(' ').toLowerCase();
+            return (
+                errorText.includes('微信') || 
+                errorText.includes('wechat') || 
+                errorText.includes('weixin') ||
+                errorText.includes('wxgame') ||
+                errorText.includes('微信游戏') ||
+                errorText.includes('微信小游戏') ||
+                errorText.includes('wxgamesdkframe') ||
+                errorText.includes('localhost.weixin.qq.com') ||
+                errorText.includes('wx_game_base') ||
+                errorText.includes('getgamesession') ||
+                errorText.includes('xmlhttprequest') ||
+                errorText.includes('err_failed') ||
+                errorText.includes('err_connection_refused') ||
+                errorText.includes('cors policy') ||
+                errorText.includes('secure context') ||
+                errorText.includes('loopback') ||
+                errorText.includes('more-private address space')
+            );
+        };
+        
+        const filteredError = function(...args) {
+            // 如果不是微信相关的错误，正常输出
+            if (!shouldFilter(...args)) {
+                originalError.apply(window.console, args);
+            }
+        };
+        
+        const filteredWarn = function(...args) {
+            // 如果不是微信相关的警告，正常输出
+            if (!shouldFilter(...args)) {
+                originalWarn.apply(window.console, args);
+            }
+        };
+        
+        // 标记已过滤，避免重复拦截
+        filteredError._qbsdkFiltered = true;
+        filteredWarn._qbsdkFiltered = true;
+        window.console.error = filteredError;
+        window.console.warn = filteredWarn;
+        
+        // 拦截全局错误事件，过滤微信游戏SDK相关的错误
+        if (!window._qbsdkErrorHandlerAdded) {
+            const originalOnError = window.onerror;
+            window.onerror = function(message, source, lineno, colno, error) {
+                const errorText = (message || '').toLowerCase() + (source || '').toLowerCase();
+                if (shouldFilter(errorText)) {
+                    // 静默处理，不输出
+                    return true; // 阻止默认错误处理
+                }
+                // 其他错误正常处理
+                if (originalOnError) {
+                    return originalOnError.call(this, message, source, lineno, colno, error);
+                }
+                return false;
+            };
+            
+            // 拦截未捕获的 Promise rejection
+            const originalUnhandledRejection = window.onunhandledrejection;
+            window.addEventListener('unhandledrejection', function(event) {
+                const errorText = (event.reason?.message || event.reason || '').toString().toLowerCase();
+                if (shouldFilter(errorText)) {
+                    // 阻止默认行为，静默处理
+                    event.preventDefault();
+                    return;
+                }
+                // 其他错误正常处理
+                if (originalUnhandledRejection) {
+                    originalUnhandledRejection.call(window, event);
+                }
+            });
+            
+            window._qbsdkErrorHandlerAdded = true;
+        }
+    }
+
     // 内部常量配置
     const API_CONFIG = {
         INIT: 'http://test.qubiankeji.com:8084/pc/init',
@@ -114,12 +198,35 @@
         _checkAndRun() {
             let attempts = 0;
             const check = () => {
+                // 优先检查 window.GDTAdSDK
                 if (window.GDTAdSDK) {
                     this._loadAd();
-                } else if (attempts++ < 50) {
+                    return;
+                }
+                
+                // 尝试从可能的模块导出中获取（适用于 Vue/React 等模块化环境）
+                // 检查是否有通过 require/import 导入的模块
+                if (typeof require !== 'undefined') {
+                    try {
+                        const OriginSDK = require('qb-pc-ad-sdk-origin');
+                        // 如果模块导出了 GDTAdSDK 或 default，尝试挂载到 window
+                        if (OriginSDK && !window.GDTAdSDK) {
+                            window.GDTAdSDK = OriginSDK.default || OriginSDK.GDTAdSDK || OriginSDK;
+                            if (window.GDTAdSDK) {
+                                this._loadAd();
+                                return;
+                            }
+                        }
+                    } catch (e) {
+                        // require 失败，继续轮询
+                    }
+                }
+                
+                // 轮询等待
+                if (attempts++ < 50) {
                     setTimeout(check, 100);
                 } else {
-                    this._handleError('SDK Load Timeout', '底层SDK加载超时');
+                    this._handleError('SDK Load Timeout', '底层SDK加载超时，请确保已正确引入 qb-pc-ad-sdk-origin');
                 }
             };
             check();

package/src/example-simple.html

@@ -23,6 +23,21 @@
     <script src="ad-sdk-wrapper.js"></script>
     <script>
         window.addEventListener('DOMContentLoaded', () => {
+            // 检查底层 SDK 是否加载
+            if (!window.GDTAdSDK) {
+                console.error('❌ 底层 SDK (GDTAdSDK) 未加载，请检查脚本路径');
+                return;
+            }
+            console.log('✅ 底层 SDK 加载成功');
+            
+            // 检查封装 SDK 是否加载
+            if (!window.AdSDK) {
+                console.error('❌ 封装 SDK (AdSDK) 未加载，请检查 ad-sdk-wrapper.js 路径');
+                return;
+            }
+            console.log('✅ 封装 SDK 加载成功');
+            
+            // 初始化广告
             new window.AdSDK({
                 appId: '1999336062823956569',
                 placementId: '1999381081819709520',