qb-pc-sdk 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,144 @@
+# qb-pc-sdk
+
+趣变广告 SDK 封装器 - PC端广告接入工具  
+自动处理多级接口映射与原生渲染逻辑，简化广告接入流程。  
+从 1.0.1 起，浏览器环境会自动加载底层依赖 `qb-pc-ad-sdk-origin`（已改名的原始 SDK），常规打包场景开箱即用。
+
+## 安装
+
+```bash
+npm install qb-pc-sdk
+```
+
+## 使用方法
+
+### ES6 模块方式（开箱即用）
+
+#### 方式一：默认导入
+
+```javascript
+import AdSDK from 'qb-pc-sdk';
+
+// 使用
+const adSDK = 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);
+  },
+  onAdExpose: () => {
+    console.log('广告已曝光');
+  },
+  onAdClick: () => {
+    console.log('广告被点击');
+  }
+});
+```
+
+#### 方式二：命名导入
+
+```javascript
+import { AdSDKWrapper } from 'qb-pc-sdk';
+
+// 使用（注意这里使用的是 AdSDKWrapper）
+const adSDK = new AdSDKWrapper({
+  appId: 'your-app-id',
+  placementId: 'your-placement-id',
+  container: '#ad-container',
+  onAdLoaded: (ad) => {
+    console.log('广告加载成功', ad);
+  },
+  onAdError: (error, message) => {
+    console.error('广告加载失败', error, message);
+  },
+  onAdExpose: () => {
+    console.log('广告已曝光');
+  },
+  onAdClick: () => {
+    console.log('广告被点击');
+  }
+});
+```
+
+> **注意**：`AdSDK` / `AdSDKWrapper` 是同一个类。  
+> 在浏览器打包场景（webpack/Vite 等）无需再单独 `import 'qb-pc-ad-sdk-origin'`，入口已在有 `window` 时自动 `require` 底层 SDK。若在极端沙箱/SSR 场景下未能挂载 `window.GDTAdSDK`，可手动在入口补充 `import 'qb-pc-ad-sdk-origin';` 作为兜底。
+
+### 浏览器直接引入（不经打包）
+
+```html
+<!-- 先引入底层 SDK（本地或 CDN 其一） -->
+<script src="/qb-pc-ad-sdk.v1.0.0.js"></script>
+<!-- 或 CDN 示例： -->
+<!-- <script src="https://unpkg.com/qb-pc-ad-sdk-origin/dist/qb-pc-ad-sdk.v1.0.0.js"></script> -->
+
+<!-- 再引入封装后的 qb-pc-sdk（UMD，本仓库 src/ad-sdk-wrapper.js） -->
+<script src="./src/ad-sdk-wrapper.js"></script>
+<script>
+  // 使用 window.AdSDK
+  const ad = new window.AdSDK({
+    appId: 'your-app-id',
+    placementId: 'your-placement-id',
+    container: '#ad-container',
+    onAdLoaded: (ad) => {
+      console.log('广告加载成功', ad);
+    },
+    onAdError: (error, message) => {
+      console.error('广告加载失败', error, message);
+    }
+  });
+</script>
+```
+
+## API
+
+### 构造函数
+
+```javascript
+new AdSDK(config)
+```
+
+#### 参数
+
+- `appId` (string, 必需): 应用 ID
+- `placementId` (string, 必需): 广告位 ID
+- `container` (string | HTMLElement, 必需): 广告容器选择器或 DOM 元素
+- `onAdLoaded` (function, 可选): 广告加载成功回调
+- `onAdError` (function, 可选): 广告加载失败回调
+- `onAdExpose` (function, 可选): 广告曝光回调
+- `onAdClick` (function, 可选): 广告点击回调
+
+### 示例
+
+```javascript
+const AdSDK = require('qb-pc-sdk');
+
+const adSDK = new AdSDK({
+  appId: 'your-app-id',
+  placementId: 'your-placement-id',
+  container: '#ad-container',
+  onAdLoaded: (ad) => {
+    console.log('广告加载成功');
+  },
+  onAdError: (error, message) => {
+    console.error('广告加载失败:', message);
+  },
+  onAdExpose: () => {
+    console.log('广告已曝光');
+  },
+  onAdClick: () => {
+    console.log('广告被点击');
+  }
+});
+```
+
+## 依赖
+
+- `qb-pc-ad-sdk-origin`: 底层广告 SDK（已自动在浏览器环境加载）
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,28 @@
+/**
+ * qb-pc-sdk 入口文件
+ * 1) 浏览器环境下预加载底层 SDK（qb-pc-ad-sdk-origin），确保 window.GDTAdSDK 可用
+ * 2) 导出封装器 AdSDKWrapper
+ */
+
+const isBrowser = typeof window !== 'undefined';
+
+// 浏览器中预加载底层 SDK（仅 side-effect，挂载 window.GDTAdSDK）
+if (isBrowser) {
+    try {
+        require('qb-pc-ad-sdk-origin');
+    } catch (err) {
+        // 这里不抛出，保持封装层逻辑可继续运行并给出错误回调
+        console.warn('[AdSDK] 底层 SDK 加载失败，请确认 qb-pc-ad-sdk-origin 已正确安装', err);
+    }
+}
+
+// 导入封装器
+const AdSDKWrapper = require('./src/ad-sdk-wrapper.js');
+
+// 导出（支持多种导入方式）
+module.exports = AdSDKWrapper;
+module.exports.default = AdSDKWrapper;
+module.exports.AdSDKWrapper = AdSDKWrapper;
+// 可选：透出底层 SDK（若已加载）
+module.exports.GDTAdSDK = isBrowser ? window.GDTAdSDK : undefined;
+

package/package.json

@@ -1,8 +1,29 @@
 {
   "name": "qb-pc-sdk",
-  "version": "1.0.0",
-  "description": "PC端广告接入项目",
+  "version": "1.0.2",
+  "description": "趣变广告 SDK 封装器 - PC端广告接入工具，自动处理多级接口映射与原生渲染逻辑",
+  "main": "index.js",
+  "files": [
+    "index.js",
+    "src/",
+    "README.md"
+  ],
+  "keywords": [
+    "ad",
+    "advertisement",
+    "sdk",
+    "qubian",
+    "pc",
+    "广告",
+    "广告SDK"
+  ],
+  "author": "",
+  "license": "MIT",
   "dependencies": {
     "qb-pc-ad-sdk-origin": "^1.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": ""
   }
 }

package/src/ad-sdk-wrapper.js

@@ -2,8 +2,11 @@
  * 趣变广告 SDK 封装器
  * 自动处理多级接口映射与原生渲染逻辑
  */
-(function(window) {
+(function(global) {
     'use strict';
+    
+    // 兼容浏览器和 Node.js 环境
+    const window = typeof global !== 'undefined' && global.window ? global.window : (typeof window !== 'undefined' ? window : global);
 
     // 内部常量配置
     const API_CONFIG = {
@@ -212,5 +215,25 @@
         }
     }
 
-    window.AdSDK = AdSDKWrapper;
-})(window);
+    // 浏览器环境：挂载到 window
+    if (typeof window !== 'undefined' && window.document) {
+        window.AdSDK = AdSDKWrapper;
+    }
+    
+    // CommonJS 模块导出
+    if (typeof module !== 'undefined' && module.exports) {
+        module.exports = AdSDKWrapper;
+        module.exports.default = AdSDKWrapper;
+        module.exports.AdSDKWrapper = AdSDKWrapper;
+    }
+    
+    // AMD 模块导出
+    if (typeof define === 'function' && define.amd) {
+        define(function() {
+            return AdSDKWrapper;
+        });
+    }
+    
+    // 返回类供直接使用
+    return AdSDKWrapper;
+})(typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : this);

package/src/example-simple.html

@@ -17,20 +17,23 @@
 <body>
     <div id="ad-slot-1"></div>
 
-    <script src="https://qzs.gdtimg.com/union/res/pc/ylh-pc-ad-sdk.v1.25.25.js"></script>
+    <!-- 先加载底层广告 SDK（CDN 方式，避免本地路径 404） -->
+    <script src="https://unpkg.com/qb-pc-ad-sdk-origin/dist/qb-pc-ad-sdk.v1.0.0.js"></script>
+    <!-- 再加载封装后的 qb-pc-sdk（本地源码版，直接挂载 window.AdSDK） -->
     <script src="ad-sdk-wrapper.js"></script>
-
     <script>
         window.addEventListener('DOMContentLoaded', () => {
-            new AdSDK({
+            new window.AdSDK({
                 appId: '1999336062823956569',
                 placementId: '1999381081819709520',
                 container: '#ad-slot-1',
                 onAdLoaded: () => console.log('✅ 广告加载完成'),
-                onAdError: (err) => console.log('❌ 广告报错:', err),
+                onAdError: (err, msg) => console.log('❌ 广告报错:', err, msg),
+                onAdExpose: () => console.log('👀 广告曝光'),
                 onAdClick: () => console.log('🖱️ 用户点击了广告')
             });
         });
     </script>
 </body>
 </html>
+                                                                                                                                                                                                           

package/config/ylh-ad-config.js

@@ -1,20 +0,0 @@
-/**
- * 参考文档: https://ylh.qq.com/help_detail.html?cid=5068&pid=12808
- */
-
-const YLH_AD_CONFIG = {
-  // 应用ID
-  appId: '1212355090',
-
-  // 广告位ID
-  // 注意：在API调用时使用 placementId 参数名
-  posId: '4204613922235231'
-};
-
-// 导出配置
-if (typeof module !== 'undefined' && module.exports) {
-  module.exports = YLH_AD_CONFIG;
-} else if (typeof window !== 'undefined') {
-  window.YLH_AD_CONFIG = YLH_AD_CONFIG;
-}
-

package//345/220/257/345/212/250/346/234/215/345/212/241/345/231/250.bat

@@ -1,34 +0,0 @@
-@echo off
-chcp 65001 >nul
-echo ========================================
-echo 广告接入 - 启动本地服务器
-echo ========================================
-echo.
-
-REM 检查是否安装了Node.js
-where node >nul 2>&1
-if %ERRORLEVEL% NEQ 0 (
-    echo [错误] 未检测到Node.js
-    echo 请先安装Node.js: https://nodejs.org/
-    echo.
-    pause
-    exit /b 1
-)
-
-echo [信息] 检测到Node.js
-node --version
-echo.
-
-echo [信息] 正在启动HTTP服务器（已启用CORS）...
-echo [信息] 服务器地址: http://localhost:8080
-echo [信息] 访问地址: http://localhost:8080/src/example-simple.html
-echo.
-echo [提示] 按 Ctrl+C 停止服务器
-echo ========================================
-echo.
-
-REM 启动服务器（启用CORS）
-npx http-server -p 8080 --cors
-
-pause
-