@playcraft/adsdk 1.0.16 → 1.0.17

package/dist/esm/index.js

@@ -510,6 +510,83 @@ function getConfig() {
   return _cachedConfig;
 }
 
+// src/cursor.ts
+var cleanup = null;
+function toCursor(src, size) {
+  const hotspot = Math.round(size / 8);
+  return new Promise((resolve, reject) => {
+    const img = new Image();
+    img.onload = () => {
+      const c = document.createElement("canvas");
+      c.width = size;
+      c.height = size;
+      const ctx = c.getContext("2d");
+      if (!ctx) {
+        reject(new Error("[PlayableSDK] Failed to get 2d context for cursor"));
+        return;
+      }
+      ctx.drawImage(img, 0, 0, size, size);
+      resolve(`url(${c.toDataURL("image/png")}) ${hotspot} ${hotspot}, pointer`);
+    };
+    img.onerror = () => reject(new Error("[PlayableSDK] Failed to load cursor image"));
+    img.src = src;
+  });
+}
+function enableCustomCursor(opts = {}) {
+  var _a, _b;
+  cleanup == null ? void 0 : cleanup();
+  cleanup = null;
+  if (typeof document === "undefined") return () => {
+  };
+  const target = (_a = opts.target) != null ? _a : document.body;
+  if (!target) {
+    console.warn("[PlayableSDK] enableCustomCursor: target not found");
+    return () => {
+    };
+  }
+  const size = (_b = opts.size) != null ? _b : 64;
+  const prevCursor = target.style.cursor;
+  let disposed = false;
+  let down = null;
+  let up = null;
+  const dispose = () => {
+    if (disposed) return;
+    disposed = true;
+    target.style.cursor = prevCursor;
+    if (down) target.removeEventListener("pointerdown", down);
+    if (up) {
+      target.removeEventListener("pointerup", up);
+      target.removeEventListener("pointercancel", up);
+    }
+    if (cleanup === dispose) cleanup = null;
+  };
+  cleanup = dispose;
+  Promise.all([
+    toCursor(FINGER_HOVERING, size),
+    toCursor(FINGER_PRESSING, size)
+  ]).then(([hover, press]) => {
+    if (disposed) return;
+    target.style.cursor = hover;
+    down = () => {
+      target.style.cursor = press;
+    };
+    up = () => {
+      target.style.cursor = hover;
+    };
+    target.addEventListener("pointerdown", down);
+    target.addEventListener("pointerup", up);
+    target.addEventListener("pointercancel", up);
+  }).catch((err) => {
+    console.warn("[PlayableSDK] enableCustomCursor failed:", err);
+    dispose();
+  });
+  return dispose;
+}
+function disableCustomCursor() {
+  cleanup == null ? void 0 : cleanup();
+  cleanup = null;
+}
+
 // src/core.ts
 var destinationUrl = "";
 var isSDKInitialized = false;
@@ -845,6 +922,7 @@ var _sdk = class _sdk {
    * This must be called as earlier as possible.
    *
    * @param callback Optional function called when ad container is ready
+   * @param options Optional configuration options
    * @example
    * // Basic initialization
    * sdk.playcraftInit();
@@ -857,12 +935,15 @@ var _sdk = class _sdk {
    * @fires playcraftInit When SDK initialization starts
    * @fires playcraftReady When game instance is created and ready to load resources
    */
-  static playcraftInit(callback) {
+  static playcraftInit(callback, options) {
     if (isSDKInitialized) return;
     if (callback) initCallback = callback;
     initTrackingProtocols();
     document.readyState === "loading" ? window.addEventListener("DOMContentLoaded", initSDK) : initSDK();
     isSDKInitialized = true;
+    if ((options == null ? void 0 : options.useCustomCursor) !== false) {
+      enableCustomCursor();
+    }
   }
   /**
    * Starts the playable ad experience.
@@ -1255,9 +1336,35 @@ var _sdk = class _sdk {
   static getConfig() {
     return getConfig();
   }
+  /**
+   * 启用自定义鼠标指针。默认挂载到 `document.body`，作用于整个页面。
+   * 悬浮显示手指图标，按下时切换为按压态图标。
+   * 多次调用会先清理上一次的状态再重新绑定。
+   *
+   * @param opts 可选配置
+   *   - opts.target: 目标元素，未传则默认 document.body
+   *   - opts.size: 光标尺寸（像素），默认 64，热点固定为 size 的 1/8
+   * @returns 清理函数，调用后会恢复默认光标并解除事件监听
+   *
+   * @example
+   * sdk.enableCustomCursor();
+   * sdk.enableCustomCursor({ size: 96 });
+   */
+  static enableCustomCursor(opts) {
+    return enableCustomCursor(opts);
+  }
+  /**
+   * 关闭自定义鼠标指针，恢复默认光标。
+   *
+   * @example
+   * sdk.disableCustomCursor();
+   */
+  static disableCustomCursor() {
+    disableCustomCursor();
+  }
 };
 /** Current version of the SDK */
-_sdk.version = "1.0.16";
+_sdk.version = "1.0.17";
 /** Current maximum width of the playable ad container in pixels */
 _sdk.maxWidth = Math.floor(window.innerWidth);
 /** Current maximum height of the playable ad container in pixels */
@@ -1283,83 +1390,6 @@ window["console"].log(
   "background: #e1e4e8; color: #333; font-size: 14px; padding: 4px 8px; border-top-right-radius: 4px; border-bottom-right-radius: 4px;"
 );
 window.PlayableSDK = sdk;
-
-// src/cursor.ts
-var cleanup = null;
-function toCursor(src, size) {
-  const hotspot = Math.round(size / 8);
-  return new Promise((resolve, reject) => {
-    const img = new Image();
-    img.onload = () => {
-      const c = document.createElement("canvas");
-      c.width = size;
-      c.height = size;
-      const ctx = c.getContext("2d");
-      if (!ctx) {
-        reject(new Error("[PlayableSDK] Failed to get 2d context for cursor"));
-        return;
-      }
-      ctx.drawImage(img, 0, 0, size, size);
-      resolve(`url(${c.toDataURL("image/png")}) ${hotspot} ${hotspot}, pointer`);
-    };
-    img.onerror = () => reject(new Error("[PlayableSDK] Failed to load cursor image"));
-    img.src = src;
-  });
-}
-function enableCustomCursor(opts = {}) {
-  var _a, _b;
-  cleanup == null ? void 0 : cleanup();
-  cleanup = null;
-  if (typeof document === "undefined") return () => {
-  };
-  const target = (_a = opts.target) != null ? _a : document.body;
-  if (!target) {
-    console.warn("[PlayableSDK] enableCustomCursor: target not found");
-    return () => {
-    };
-  }
-  const size = (_b = opts.size) != null ? _b : 64;
-  const prevCursor = target.style.cursor;
-  let disposed = false;
-  let down = null;
-  let up = null;
-  const dispose = () => {
-    if (disposed) return;
-    disposed = true;
-    target.style.cursor = prevCursor;
-    if (down) target.removeEventListener("pointerdown", down);
-    if (up) {
-      target.removeEventListener("pointerup", up);
-      target.removeEventListener("pointercancel", up);
-    }
-    if (cleanup === dispose) cleanup = null;
-  };
-  cleanup = dispose;
-  Promise.all([
-    toCursor(FINGER_HOVERING, size),
-    toCursor(FINGER_PRESSING, size)
-  ]).then(([hover, press]) => {
-    if (disposed) return;
-    target.style.cursor = hover;
-    down = () => {
-      target.style.cursor = press;
-    };
-    up = () => {
-      target.style.cursor = hover;
-    };
-    target.addEventListener("pointerdown", down);
-    target.addEventListener("pointerup", up);
-    target.addEventListener("pointercancel", up);
-  }).catch((err) => {
-    console.warn("[PlayableSDK] enableCustomCursor failed:", err);
-    dispose();
-  });
-  return dispose;
-}
-function disableCustomCursor() {
-  cleanup == null ? void 0 : cleanup();
-  cleanup = null;
-}
 export {
   sdk as default,
   disableCustomCursor,

package/dist/iife/index.js

@@ -748,6 +748,83 @@
     return _cachedConfig;
   }
 
+  // src/cursor.ts
+  var cleanup = null;
+  function toCursor(src, size) {
+    const hotspot = Math.round(size / 8);
+    return new Promise((resolve, reject) => {
+      const img = new Image();
+      img.onload = () => {
+        const c = document.createElement("canvas");
+        c.width = size;
+        c.height = size;
+        const ctx = c.getContext("2d");
+        if (!ctx) {
+          reject(new Error("[PlayableSDK] Failed to get 2d context for cursor"));
+          return;
+        }
+        ctx.drawImage(img, 0, 0, size, size);
+        resolve(`url(${c.toDataURL("image/png")}) ${hotspot} ${hotspot}, pointer`);
+      };
+      img.onerror = () => reject(new Error("[PlayableSDK] Failed to load cursor image"));
+      img.src = src;
+    });
+  }
+  function enableCustomCursor(opts = {}) {
+    var _a, _b;
+    cleanup == null ? void 0 : cleanup();
+    cleanup = null;
+    if (typeof document === "undefined") return () => {
+    };
+    const target = (_a = opts.target) != null ? _a : document.body;
+    if (!target) {
+      console.warn("[PlayableSDK] enableCustomCursor: target not found");
+      return () => {
+      };
+    }
+    const size = (_b = opts.size) != null ? _b : 64;
+    const prevCursor = target.style.cursor;
+    let disposed = false;
+    let down = null;
+    let up = null;
+    const dispose = () => {
+      if (disposed) return;
+      disposed = true;
+      target.style.cursor = prevCursor;
+      if (down) target.removeEventListener("pointerdown", down);
+      if (up) {
+        target.removeEventListener("pointerup", up);
+        target.removeEventListener("pointercancel", up);
+      }
+      if (cleanup === dispose) cleanup = null;
+    };
+    cleanup = dispose;
+    Promise.all([
+      toCursor(FINGER_HOVERING, size),
+      toCursor(FINGER_PRESSING, size)
+    ]).then(([hover, press]) => {
+      if (disposed) return;
+      target.style.cursor = hover;
+      down = () => {
+        target.style.cursor = press;
+      };
+      up = () => {
+        target.style.cursor = hover;
+      };
+      target.addEventListener("pointerdown", down);
+      target.addEventListener("pointerup", up);
+      target.addEventListener("pointercancel", up);
+    }).catch((err) => {
+      console.warn("[PlayableSDK] enableCustomCursor failed:", err);
+      dispose();
+    });
+    return dispose;
+  }
+  function disableCustomCursor() {
+    cleanup == null ? void 0 : cleanup();
+    cleanup = null;
+  }
+
   // src/core.ts
   var destinationUrl = "";
   var isSDKInitialized = false;
@@ -1083,6 +1160,7 @@
      * This must be called as earlier as possible.
      *
      * @param callback Optional function called when ad container is ready
+     * @param options Optional configuration options
      * @example
      * // Basic initialization
      * sdk.playcraftInit();
@@ -1095,12 +1173,15 @@
      * @fires playcraftInit When SDK initialization starts
      * @fires playcraftReady When game instance is created and ready to load resources
      */
-    static playcraftInit(callback) {
+    static playcraftInit(callback, options) {
       if (isSDKInitialized) return;
       if (callback) initCallback = callback;
       initTrackingProtocols();
       document.readyState === "loading" ? window.addEventListener("DOMContentLoaded", initSDK) : initSDK();
       isSDKInitialized = true;
+      if ((options == null ? void 0 : options.useCustomCursor) !== false) {
+        enableCustomCursor();
+      }
     }
     /**
      * Starts the playable ad experience.
@@ -1493,9 +1574,35 @@
     static getConfig() {
       return getConfig();
     }
+    /**
+     * 启用自定义鼠标指针。默认挂载到 `document.body`，作用于整个页面。
+     * 悬浮显示手指图标，按下时切换为按压态图标。
+     * 多次调用会先清理上一次的状态再重新绑定。
+     *
+     * @param opts 可选配置
+     *   - opts.target: 目标元素，未传则默认 document.body
+     *   - opts.size: 光标尺寸（像素），默认 64，热点固定为 size 的 1/8
+     * @returns 清理函数，调用后会恢复默认光标并解除事件监听
+     *
+     * @example
+     * sdk.enableCustomCursor();
+     * sdk.enableCustomCursor({ size: 96 });
+     */
+    static enableCustomCursor(opts) {
+      return enableCustomCursor(opts);
+    }
+    /**
+     * 关闭自定义鼠标指针，恢复默认光标。
+     *
+     * @example
+     * sdk.disableCustomCursor();
+     */
+    static disableCustomCursor() {
+      disableCustomCursor();
+    }
   };
   /** Current version of the SDK */
-  _sdk.version = "1.0.16";
+  _sdk.version = "1.0.17";
   /** Current maximum width of the playable ad container in pixels */
   _sdk.maxWidth = Math.floor(window.innerWidth);
   /** Current maximum height of the playable ad container in pixels */
@@ -1521,81 +1628,4 @@
     "background: #e1e4e8; color: #333; font-size: 14px; padding: 4px 8px; border-top-right-radius: 4px; border-bottom-right-radius: 4px;"
   );
   window.PlayableSDK = sdk;
-
-  // src/cursor.ts
-  var cleanup = null;
-  function toCursor(src, size) {
-    const hotspot = Math.round(size / 8);
-    return new Promise((resolve, reject) => {
-      const img = new Image();
-      img.onload = () => {
-        const c = document.createElement("canvas");
-        c.width = size;
-        c.height = size;
-        const ctx = c.getContext("2d");
-        if (!ctx) {
-          reject(new Error("[PlayableSDK] Failed to get 2d context for cursor"));
-          return;
-        }
-        ctx.drawImage(img, 0, 0, size, size);
-        resolve(`url(${c.toDataURL("image/png")}) ${hotspot} ${hotspot}, pointer`);
-      };
-      img.onerror = () => reject(new Error("[PlayableSDK] Failed to load cursor image"));
-      img.src = src;
-    });
-  }
-  function enableCustomCursor(opts = {}) {
-    var _a, _b;
-    cleanup == null ? void 0 : cleanup();
-    cleanup = null;
-    if (typeof document === "undefined") return () => {
-    };
-    const target = (_a = opts.target) != null ? _a : document.body;
-    if (!target) {
-      console.warn("[PlayableSDK] enableCustomCursor: target not found");
-      return () => {
-      };
-    }
-    const size = (_b = opts.size) != null ? _b : 64;
-    const prevCursor = target.style.cursor;
-    let disposed = false;
-    let down = null;
-    let up = null;
-    const dispose = () => {
-      if (disposed) return;
-      disposed = true;
-      target.style.cursor = prevCursor;
-      if (down) target.removeEventListener("pointerdown", down);
-      if (up) {
-        target.removeEventListener("pointerup", up);
-        target.removeEventListener("pointercancel", up);
-      }
-      if (cleanup === dispose) cleanup = null;
-    };
-    cleanup = dispose;
-    Promise.all([
-      toCursor(FINGER_HOVERING, size),
-      toCursor(FINGER_PRESSING, size)
-    ]).then(([hover, press]) => {
-      if (disposed) return;
-      target.style.cursor = hover;
-      down = () => {
-        target.style.cursor = press;
-      };
-      up = () => {
-        target.style.cursor = hover;
-      };
-      target.addEventListener("pointerdown", down);
-      target.addEventListener("pointerup", up);
-      target.addEventListener("pointercancel", up);
-    }).catch((err) => {
-      console.warn("[PlayableSDK] enableCustomCursor failed:", err);
-      dispose();
-    });
-    return dispose;
-  }
-  function disableCustomCursor() {
-    cleanup == null ? void 0 : cleanup();
-    cleanup = null;
-  }
 })();

package/dist/index.d.mts

@@ -1,5 +1,33 @@
 type EventName = 'playcraftInit' | 'playcraftReady' | 'playcraftStart' | 'playcraftInteractive' | 'playcraftInteraction' | 'playcraftChallengeStart' | 'playcraftChallengeProgress' | 'playcraftChallengeSuccess' | 'playcraftChallengeFailed' | 'playcraftResize' | 'playcraftPause' | 'playcraftResume' | 'playcraftVolume' | 'playcraftRetry' | 'playcraftFinish' | 'playcraftInstall';
 
+/**
+ * 自定义鼠标指针模块。
+ *
+ * 默认挂载到 `document.body`，把整页的默认光标替换为内置的手指图标：
+ * - 悬浮时显示 FingerHovering
+ * - 按下时显示 FingerPressing
+ *
+ * 图片以 base64 dataURL 形式内置到产物中，无需额外加载资源。
+ */
+interface CursorOptions {
+    /** 目标元素，未传则默认挂载到 document.body */
+    target?: HTMLElement;
+    /** 光标尺寸（像素），默认 64。热点固定为 size 的 1/8 */
+    size?: number;
+}
+/**
+ * 启用自定义鼠标指针。默认挂载到 `document.body`，作用于整个页面。
+ *
+ * 多次调用时，会先清理上一次的状态再重新绑定。
+ *
+ * @returns 清理函数，调用后会恢复默认光标并解除事件监听。
+ */
+declare function enableCustomCursor(opts?: CursorOptions): () => void;
+/**
+ * 关闭自定义鼠标指针，恢复默认光标。
+ */
+declare function disableCustomCursor(): void;
+
 type InitCallbackType = (maxWidth: number, maxHeight: number) => void;
 /**
  * Main SDK class providing playable ad functionality and state management.
@@ -31,6 +59,7 @@ declare class sdk {
      * This must be called as earlier as possible.
      *
      * @param callback Optional function called when ad container is ready
+     * @param options Optional configuration options
      * @example
      * // Basic initialization
      * sdk.playcraftInit();
@@ -43,7 +72,9 @@ declare class sdk {
      * @fires playcraftInit When SDK initialization starts
      * @fires playcraftReady When game instance is created and ready to load resources
      */
-    static playcraftInit(callback?: InitCallbackType): void;
+    static playcraftInit(callback?: InitCallbackType, options?: {
+        useCustomCursor?: boolean;
+    }): void;
     /**
      * Starts the playable ad experience.
      * Should be called after all resources are loaded and first frame is rendered.
@@ -251,6 +282,28 @@ declare class sdk {
      * console.log(config.primaryColor); // '#ff0000'
      */
     static getConfig(): Record<string, any>;
+    /**
+     * 启用自定义鼠标指针。默认挂载到 `document.body`，作用于整个页面。
+     * 悬浮显示手指图标，按下时切换为按压态图标。
+     * 多次调用会先清理上一次的状态再重新绑定。
+     *
+     * @param opts 可选配置
+     *   - opts.target: 目标元素，未传则默认 document.body
+     *   - opts.size: 光标尺寸（像素），默认 64，热点固定为 size 的 1/8
+     * @returns 清理函数，调用后会恢复默认光标并解除事件监听
+     *
+     * @example
+     * sdk.enableCustomCursor();
+     * sdk.enableCustomCursor({ size: 96 });
+     */
+    static enableCustomCursor(opts?: CursorOptions): () => void;
+    /**
+     * 关闭自定义鼠标指针，恢复默认光标。
+     *
+     * @example
+     * sdk.disableCustomCursor();
+     */
+    static disableCustomCursor(): void;
 }
 
 /**
@@ -270,32 +323,4 @@ declare function hideWechatGuide(): void;
  */
 declare function removeWechatGuide(): void;
 
-/**
- * 自定义鼠标指针模块。
- *
- * 默认挂载到 `document.body`，把整页的默认光标替换为内置的手指图标：
- * - 悬浮时显示 FingerHovering
- * - 按下时显示 FingerPressing
- *
- * 图片以 base64 dataURL 形式内置到产物中，无需额外加载资源。
- */
-interface CursorOptions {
-    /** 目标元素，未传则默认挂载到 document.body */
-    target?: HTMLElement;
-    /** 光标尺寸（像素），默认 64。热点固定为 size 的 1/8 */
-    size?: number;
-}
-/**
- * 启用自定义鼠标指针。默认挂载到 `document.body`，作用于整个页面。
- *
- * 多次调用时，会先清理上一次的状态再重新绑定。
- *
- * @returns 清理函数，调用后会恢复默认光标并解除事件监听。
- */
-declare function enableCustomCursor(opts?: CursorOptions): () => void;
-/**
- * 关闭自定义鼠标指针，恢复默认光标。
- */
-declare function disableCustomCursor(): void;
-
 export { type CursorOptions, sdk as default, disableCustomCursor, enableCustomCursor, hideWechatGuide, removeWechatGuide, sdk, showWechatGuide };

package/dist/index.d.ts

@@ -1,5 +1,33 @@
 type EventName = 'playcraftInit' | 'playcraftReady' | 'playcraftStart' | 'playcraftInteractive' | 'playcraftInteraction' | 'playcraftChallengeStart' | 'playcraftChallengeProgress' | 'playcraftChallengeSuccess' | 'playcraftChallengeFailed' | 'playcraftResize' | 'playcraftPause' | 'playcraftResume' | 'playcraftVolume' | 'playcraftRetry' | 'playcraftFinish' | 'playcraftInstall';
 
+/**
+ * 自定义鼠标指针模块。
+ *
+ * 默认挂载到 `document.body`，把整页的默认光标替换为内置的手指图标：
+ * - 悬浮时显示 FingerHovering
+ * - 按下时显示 FingerPressing
+ *
+ * 图片以 base64 dataURL 形式内置到产物中，无需额外加载资源。
+ */
+interface CursorOptions {
+    /** 目标元素，未传则默认挂载到 document.body */
+    target?: HTMLElement;
+    /** 光标尺寸（像素），默认 64。热点固定为 size 的 1/8 */
+    size?: number;
+}
+/**
+ * 启用自定义鼠标指针。默认挂载到 `document.body`，作用于整个页面。
+ *
+ * 多次调用时，会先清理上一次的状态再重新绑定。
+ *
+ * @returns 清理函数，调用后会恢复默认光标并解除事件监听。
+ */
+declare function enableCustomCursor(opts?: CursorOptions): () => void;
+/**
+ * 关闭自定义鼠标指针，恢复默认光标。
+ */
+declare function disableCustomCursor(): void;
+
 type InitCallbackType = (maxWidth: number, maxHeight: number) => void;
 /**
  * Main SDK class providing playable ad functionality and state management.
@@ -31,6 +59,7 @@ declare class sdk {
      * This must be called as earlier as possible.
      *
      * @param callback Optional function called when ad container is ready
+     * @param options Optional configuration options
      * @example
      * // Basic initialization
      * sdk.playcraftInit();
@@ -43,7 +72,9 @@ declare class sdk {
      * @fires playcraftInit When SDK initialization starts
      * @fires playcraftReady When game instance is created and ready to load resources
      */
-    static playcraftInit(callback?: InitCallbackType): void;
+    static playcraftInit(callback?: InitCallbackType, options?: {
+        useCustomCursor?: boolean;
+    }): void;
     /**
      * Starts the playable ad experience.
      * Should be called after all resources are loaded and first frame is rendered.
@@ -251,6 +282,28 @@ declare class sdk {
      * console.log(config.primaryColor); // '#ff0000'
      */
     static getConfig(): Record<string, any>;
+    /**
+     * 启用自定义鼠标指针。默认挂载到 `document.body`，作用于整个页面。
+     * 悬浮显示手指图标，按下时切换为按压态图标。
+     * 多次调用会先清理上一次的状态再重新绑定。
+     *
+     * @param opts 可选配置
+     *   - opts.target: 目标元素，未传则默认 document.body
+     *   - opts.size: 光标尺寸（像素），默认 64，热点固定为 size 的 1/8
+     * @returns 清理函数，调用后会恢复默认光标并解除事件监听
+     *
+     * @example
+     * sdk.enableCustomCursor();
+     * sdk.enableCustomCursor({ size: 96 });
+     */
+    static enableCustomCursor(opts?: CursorOptions): () => void;
+    /**
+     * 关闭自定义鼠标指针，恢复默认光标。
+     *
+     * @example
+     * sdk.disableCustomCursor();
+     */
+    static disableCustomCursor(): void;
 }
 
 /**
@@ -270,32 +323,4 @@ declare function hideWechatGuide(): void;
  */
 declare function removeWechatGuide(): void;
 
-/**
- * 自定义鼠标指针模块。
- *
- * 默认挂载到 `document.body`，把整页的默认光标替换为内置的手指图标：
- * - 悬浮时显示 FingerHovering
- * - 按下时显示 FingerPressing
- *
- * 图片以 base64 dataURL 形式内置到产物中，无需额外加载资源。
- */
-interface CursorOptions {
-    /** 目标元素，未传则默认挂载到 document.body */
-    target?: HTMLElement;
-    /** 光标尺寸（像素），默认 64。热点固定为 size 的 1/8 */
-    size?: number;
-}
-/**
- * 启用自定义鼠标指针。默认挂载到 `document.body`，作用于整个页面。
- *
- * 多次调用时，会先清理上一次的状态再重新绑定。
- *
- * @returns 清理函数，调用后会恢复默认光标并解除事件监听。
- */
-declare function enableCustomCursor(opts?: CursorOptions): () => void;
-/**
- * 关闭自定义鼠标指针，恢复默认光标。
- */
-declare function disableCustomCursor(): void;
-
 export { type CursorOptions, sdk as default, disableCustomCursor, enableCustomCursor, hideWechatGuide, removeWechatGuide, sdk, showWechatGuide };

package/dist/index.js

@@ -542,6 +542,83 @@ function getConfig() {
   return _cachedConfig;
 }
 
+// src/cursor.ts
+var cleanup = null;
+function toCursor(src, size) {
+  const hotspot = Math.round(size / 8);
+  return new Promise((resolve, reject) => {
+    const img = new Image();
+    img.onload = () => {
+      const c = document.createElement("canvas");
+      c.width = size;
+      c.height = size;
+      const ctx = c.getContext("2d");
+      if (!ctx) {
+        reject(new Error("[PlayableSDK] Failed to get 2d context for cursor"));
+        return;
+      }
+      ctx.drawImage(img, 0, 0, size, size);
+      resolve(`url(${c.toDataURL("image/png")}) ${hotspot} ${hotspot}, pointer`);
+    };
+    img.onerror = () => reject(new Error("[PlayableSDK] Failed to load cursor image"));
+    img.src = src;
+  });
+}
+function enableCustomCursor(opts = {}) {
+  var _a, _b;
+  cleanup == null ? void 0 : cleanup();
+  cleanup = null;
+  if (typeof document === "undefined") return () => {
+  };
+  const target = (_a = opts.target) != null ? _a : document.body;
+  if (!target) {
+    console.warn("[PlayableSDK] enableCustomCursor: target not found");
+    return () => {
+    };
+  }
+  const size = (_b = opts.size) != null ? _b : 64;
+  const prevCursor = target.style.cursor;
+  let disposed = false;
+  let down = null;
+  let up = null;
+  const dispose = () => {
+    if (disposed) return;
+    disposed = true;
+    target.style.cursor = prevCursor;
+    if (down) target.removeEventListener("pointerdown", down);
+    if (up) {
+      target.removeEventListener("pointerup", up);
+      target.removeEventListener("pointercancel", up);
+    }
+    if (cleanup === dispose) cleanup = null;
+  };
+  cleanup = dispose;
+  Promise.all([
+    toCursor(FINGER_HOVERING, size),
+    toCursor(FINGER_PRESSING, size)
+  ]).then(([hover, press]) => {
+    if (disposed) return;
+    target.style.cursor = hover;
+    down = () => {
+      target.style.cursor = press;
+    };
+    up = () => {
+      target.style.cursor = hover;
+    };
+    target.addEventListener("pointerdown", down);
+    target.addEventListener("pointerup", up);
+    target.addEventListener("pointercancel", up);
+  }).catch((err) => {
+    console.warn("[PlayableSDK] enableCustomCursor failed:", err);
+    dispose();
+  });
+  return dispose;
+}
+function disableCustomCursor() {
+  cleanup == null ? void 0 : cleanup();
+  cleanup = null;
+}
+
 // src/core.ts
 var destinationUrl = "";
 var isSDKInitialized = false;
@@ -877,6 +954,7 @@ var _sdk = class _sdk {
    * This must be called as earlier as possible.
    *
    * @param callback Optional function called when ad container is ready
+   * @param options Optional configuration options
    * @example
    * // Basic initialization
    * sdk.playcraftInit();
@@ -889,12 +967,15 @@ var _sdk = class _sdk {
    * @fires playcraftInit When SDK initialization starts
    * @fires playcraftReady When game instance is created and ready to load resources
    */
-  static playcraftInit(callback) {
+  static playcraftInit(callback, options) {
     if (isSDKInitialized) return;
     if (callback) initCallback = callback;
     initTrackingProtocols();
     document.readyState === "loading" ? window.addEventListener("DOMContentLoaded", initSDK) : initSDK();
     isSDKInitialized = true;
+    if ((options == null ? void 0 : options.useCustomCursor) !== false) {
+      enableCustomCursor();
+    }
   }
   /**
    * Starts the playable ad experience.
@@ -1287,9 +1368,35 @@ var _sdk = class _sdk {
   static getConfig() {
     return getConfig();
   }
+  /**
+   * 启用自定义鼠标指针。默认挂载到 `document.body`，作用于整个页面。
+   * 悬浮显示手指图标，按下时切换为按压态图标。
+   * 多次调用会先清理上一次的状态再重新绑定。
+   *
+   * @param opts 可选配置
+   *   - opts.target: 目标元素，未传则默认 document.body
+   *   - opts.size: 光标尺寸（像素），默认 64，热点固定为 size 的 1/8
+   * @returns 清理函数，调用后会恢复默认光标并解除事件监听
+   *
+   * @example
+   * sdk.enableCustomCursor();
+   * sdk.enableCustomCursor({ size: 96 });
+   */
+  static enableCustomCursor(opts) {
+    return enableCustomCursor(opts);
+  }
+  /**
+   * 关闭自定义鼠标指针，恢复默认光标。
+   *
+   * @example
+   * sdk.disableCustomCursor();
+   */
+  static disableCustomCursor() {
+    disableCustomCursor();
+  }
 };
 /** Current version of the SDK */
-_sdk.version = "1.0.16";
+_sdk.version = "1.0.17";
 /** Current maximum width of the playable ad container in pixels */
 _sdk.maxWidth = Math.floor(window.innerWidth);
 /** Current maximum height of the playable ad container in pixels */
@@ -1315,83 +1422,6 @@ window["console"].log(
   "background: #e1e4e8; color: #333; font-size: 14px; padding: 4px 8px; border-top-right-radius: 4px; border-bottom-right-radius: 4px;"
 );
 window.PlayableSDK = sdk;
-
-// src/cursor.ts
-var cleanup = null;
-function toCursor(src, size) {
-  const hotspot = Math.round(size / 8);
-  return new Promise((resolve, reject) => {
-    const img = new Image();
-    img.onload = () => {
-      const c = document.createElement("canvas");
-      c.width = size;
-      c.height = size;
-      const ctx = c.getContext("2d");
-      if (!ctx) {
-        reject(new Error("[PlayableSDK] Failed to get 2d context for cursor"));
-        return;
-      }
-      ctx.drawImage(img, 0, 0, size, size);
-      resolve(`url(${c.toDataURL("image/png")}) ${hotspot} ${hotspot}, pointer`);
-    };
-    img.onerror = () => reject(new Error("[PlayableSDK] Failed to load cursor image"));
-    img.src = src;
-  });
-}
-function enableCustomCursor(opts = {}) {
-  var _a, _b;
-  cleanup == null ? void 0 : cleanup();
-  cleanup = null;
-  if (typeof document === "undefined") return () => {
-  };
-  const target = (_a = opts.target) != null ? _a : document.body;
-  if (!target) {
-    console.warn("[PlayableSDK] enableCustomCursor: target not found");
-    return () => {
-    };
-  }
-  const size = (_b = opts.size) != null ? _b : 64;
-  const prevCursor = target.style.cursor;
-  let disposed = false;
-  let down = null;
-  let up = null;
-  const dispose = () => {
-    if (disposed) return;
-    disposed = true;
-    target.style.cursor = prevCursor;
-    if (down) target.removeEventListener("pointerdown", down);
-    if (up) {
-      target.removeEventListener("pointerup", up);
-      target.removeEventListener("pointercancel", up);
-    }
-    if (cleanup === dispose) cleanup = null;
-  };
-  cleanup = dispose;
-  Promise.all([
-    toCursor(FINGER_HOVERING, size),
-    toCursor(FINGER_PRESSING, size)
-  ]).then(([hover, press]) => {
-    if (disposed) return;
-    target.style.cursor = hover;
-    down = () => {
-      target.style.cursor = press;
-    };
-    up = () => {
-      target.style.cursor = hover;
-    };
-    target.addEventListener("pointerdown", down);
-    target.addEventListener("pointerup", up);
-    target.addEventListener("pointercancel", up);
-  }).catch((err) => {
-    console.warn("[PlayableSDK] enableCustomCursor failed:", err);
-    dispose();
-  });
-  return dispose;
-}
-function disableCustomCursor() {
-  cleanup == null ? void 0 : cleanup();
-  cleanup = null;
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   disableCustomCursor,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playcraft/adsdk",
-  "version": "1.0.16",
+  "version": "1.0.17",
   "description": "统一的 Playable SDK，支持 MRAID、Google、Facebook、Vungle、BigoAds 等多广告渠道",
   "main": "dist/index.js",
   "module": "dist/esm/index.js",