@playcraft/build 0.0.23 → 0.0.24

package/dist/engines/playable-scripts-adapter.d.ts

@@ -133,9 +133,10 @@ export declare class PlayableScriptsAdapter {
     private removeDirRecursive;
     private copyToOutputDir;
     /**
-     * 判断目标平台是否为 ZIP 格式
+     * 是否对 playable-scripts 使用 --zip。
+     * Google/Facebook 等双格式渠道默认 HTML，与 CLI、Portal、GoogleAdapter 一致；仅 ZIP 的渠道仍强制 ZIP。
      */
-    private isZipFormatPlatform;
+    private isZipOutput;
     /**
      * 获取平台默认的文件名格式
      */

package/dist/engines/playable-scripts-adapter.js

@@ -258,9 +258,9 @@ export class PlayableScriptsAdapter {
         // 输出目录 - 统一使用 dist，与 PlayCraft 标准一致
         const outputDir = config.outputDir ?? 'dist';
         args.push('--out-dir', outputDir);
-        // ZIP 输出格式 - 根据平台自动判断
-        const isZipFormat = this.isZipFormatPlatform();
-        if (isZipFormat || config.zip) {
+        // ZIP 输出：仅 ZIP-only 渠道、显式 config.zip、或构建请求 format=zip（如 Google / Facebook 选 ZIP）
+        const isZipFormat = this.isZipOutput();
+        if (isZipFormat) {
             args.push('--zip');
         }
         // 自定义文件名格式 - 根据平台使用 PlayCraft 标准命名
@@ -961,17 +961,28 @@ export class PlayableScriptsAdapter {
         return files;
     }
     /**
-     * 判断目标平台是否为 ZIP 格式
+     * 是否对 playable-scripts 使用 --zip。
+     * Google/Facebook 等双格式渠道默认 HTML，与 CLI、Portal、GoogleAdapter 一致；仅 ZIP 的渠道仍强制 ZIP。
      */
-    isZipFormatPlatform() {
+    isZipOutput() {
         const config = this.config ?? {};
         const channels = config.channels ?? ['google'];
-        // ZIP 格式的平台列表
-        const zipFormatPlatforms = new Set([
-            'google', 'tiktok', 'snapchat', 'liftoff', 'bigo', 'inmobi', 'mintegral'
+        if (config.zip === true) {
+            return true;
+        }
+        const zipOnlyPlatforms = new Set([
+            'tiktok',
+            'snapchat',
+            'liftoff',
+            'bigo',
+            'inmobi',
+            'mintegral',
         ]);
-        // 如果任一目标渠道是 ZIP 格式，返回 true
-        return channels.some(ch => zipFormatPlatforms.has(ch));
+        if (channels.some((ch) => zipOnlyPlatforms.has(ch))) {
+            return true;
+        }
+        const fmt = this.options.format;
+        return fmt === 'zip';
     }
     /**
      * 获取平台默认的文件名格式

package/dist/platforms/adikteev.js

@@ -44,6 +44,7 @@ export class AdikteevAdapter extends PlatformAdapter {
         html = html.replace('</head>', `${adikteevScript}${comment}</head>`);
         // 注入统一的 CTA 适配器
         html = await this.injectCTAAdapterAsync(html);
+        html = await this.injectTrackingAdapterAsync(html);
         return html;
     }
     getPlatformScript() {

package/dist/platforms/applovin.js

@@ -45,6 +45,7 @@ export class AppLovinAdapter extends PlatformAdapter {
         html = html.replace('</head>', `${appLovinScript}${comment}</head>`);
         // 注入统一的 CTA 适配器
         html = await this.injectCTAAdapterAsync(html);
+        html = await this.injectTrackingAdapterAsync(html);
         return html;
     }
     getPlatformScript() {

package/dist/platforms/base.d.ts

@@ -60,4 +60,24 @@ export declare abstract class PlatformAdapter {
      * @deprecated 推荐使用 injectCTAAdapterAsync
      */
     protected injectCTAAdapter(html: string): string;
+    /**
+     * 生成 Tracking 配置注入脚本
+     * 将 tracking 配置以全局变量写入 HTML，供 Tracking Adapter 读取
+     */
+    protected getTrackingConfigScript(): string;
+    /**
+     * 获取 Tracking 适配器脚本（异步版本，带压缩）
+     */
+    protected getTrackingAdapterScriptAsync(): Promise<string>;
+    /**
+     * 从 @playcraft/adsdk 包中提取 tracking 实现代码
+     * 读取 IIFE 版本中 `// src/tracking.ts` 到 `var tracking = {...};` 的代码段
+     * 包装为独立 IIFE 并暴露 window.PlayCraftTracking
+     */
+    protected getAdsdkTrackingScriptAsync(): Promise<string>;
+    /**
+     * 在 HTML 中注入 Tracking 适配器（异步版本）
+     * 注入顺序：1.Config → 2.adsdk tracking 实现 → 3.Adapter 桥接脚本
+     */
+    protected injectTrackingAdapterAsync(html: string): Promise<string>;
 }

package/dist/platforms/base.js

@@ -4,6 +4,10 @@ import { fileURLToPath } from 'url';
 import { minifyPatchCode } from '../utils/minify.js';
 // 缓存压缩后的 CTA 适配器代码
 let cachedMinifiedCTAAdapter = null;
+// 缓存压缩后的 Tracking 适配器代码
+let cachedMinifiedTrackingAdapter = null;
+// 缓存从 @playcraft/adsdk 提取的 tracking 实现代码
+let cachedAdsdkTrackingScript = null;
 // 缓存压缩后的平台脚本
 const platformScriptCache = new Map();
 export class PlatformAdapter {
@@ -114,4 +118,93 @@ export class PlatformAdapter {
             return combined + '\n' + html;
         }
     }
+    // ===== Tracking Adapter =====
+    /**
+     * 生成 Tracking 配置注入脚本
+     * 将 tracking 配置以全局变量写入 HTML，供 Tracking Adapter 读取
+     */
+    getTrackingConfigScript() {
+        const tracking = this.options.tracking;
+        if (tracking?.enabled === false)
+            return '';
+        const config = {};
+        // adNetwork: 优先用显式配置，否则从 platform 自动推断
+        const adNetwork = tracking?.adNetwork || this.options.platform || '';
+        if (adNetwork)
+            config.adNetwork = adNetwork;
+        if (tracking?.totalInteractions)
+            config.totalInteractions = tracking.totalInteractions;
+        return Object.keys(config).length > 0
+            ? `<script>window.__PLAYCRAFT_TRACKING_CONFIG__=${JSON.stringify(config)};</script>`
+            : '';
+    }
+    /**
+     * 获取 Tracking 适配器脚本（异步版本，带压缩）
+     */
+    async getTrackingAdapterScriptAsync() {
+        if (cachedMinifiedTrackingAdapter) {
+            return `<script>${cachedMinifiedTrackingAdapter}</script>`;
+        }
+        const code = await this.readTemplateFile('playcraft-tracking-adapter.js');
+        const minified = await minifyPatchCode(code, 'playcraft-tracking-adapter.js');
+        cachedMinifiedTrackingAdapter = minified;
+        return `<script>${minified}</script>`;
+    }
+    /**
+     * 从 @playcraft/adsdk 包中提取 tracking 实现代码
+     * 读取 IIFE 版本中 `// src/tracking.ts` 到 `var tracking = {...};` 的代码段
+     * 包装为独立 IIFE 并暴露 window.PlayCraftTracking
+     */
+    async getAdsdkTrackingScriptAsync() {
+        if (cachedAdsdkTrackingScript) {
+            return `<script>${cachedAdsdkTrackingScript}</script>`;
+        }
+        try {
+            // 从 @playcraft/adsdk 的 IIFE 构建中读取
+            const { createRequire } = await import('module');
+            const require = createRequire(import.meta.url);
+            const adsdkPath = require.resolve('@playcraft/adsdk/dist/iife/index.js');
+            const iifeCode = await fs.readFile(adsdkPath, 'utf-8');
+            // 提取 tracking 部分：从 "// src/tracking.ts" 到 "trackChallengeFailed" 对象结尾
+            const startMarker = '// src/tracking.ts';
+            const endMarker = 'trackChallengeFailed: _trackChallengeFailed';
+            const startIdx = iifeCode.indexOf(startMarker);
+            const endIdx = iifeCode.indexOf(endMarker);
+            if (startIdx === -1 || endIdx === -1) {
+                console.warn('[Tracking] 无法从 @playcraft/adsdk 中提取 tracking 代码，使用内置 adapter');
+                return '';
+            }
+            // 找到 tracking 对象定义结束的 `};`
+            const afterEnd = iifeCode.indexOf('};', endIdx);
+            const trackingCode = iifeCode.substring(startIdx, afterEnd + 2);
+            // 包装为独立 IIFE，暴露 window.PlayCraftTracking
+            const wrappedCode = `(function(){"use strict";${trackingCode}\nwindow.PlayCraftTracking=tracking;})();`;
+            const minified = await minifyPatchCode(wrappedCode, 'adsdk-tracking-extract');
+            cachedAdsdkTrackingScript = minified;
+            return `<script>${minified}</script>`;
+        }
+        catch (e) {
+            console.warn('[Tracking] 无法加载 @playcraft/adsdk:', e.message);
+            return '';
+        }
+    }
+    /**
+     * 在 HTML 中注入 Tracking 适配器（异步版本）
+     * 注入顺序：1.Config → 2.adsdk tracking 实现 → 3.Adapter 桥接脚本
+     */
+    async injectTrackingAdapterAsync(html) {
+        if (this.options.tracking?.enabled === false)
+            return html;
+        const configScript = this.getTrackingConfigScript();
+        const adsdkScript = await this.getAdsdkTrackingScriptAsync();
+        const trackingScript = await this.getTrackingAdapterScriptAsync();
+        const combined = configScript + adsdkScript + trackingScript;
+        if (html.includes('</head>')) {
+            return html.replace('</head>', `${combined}\n</head>`);
+        }
+        else if (html.includes('</body>')) {
+            return html.replace('</body>', `${combined}\n</body>`);
+        }
+        return combined + '\n' + html;
+    }
 }

package/dist/platforms/bigo.js

@@ -41,6 +41,7 @@ export class BigoAdapter extends PlatformAdapter {
         html = html.replace('</head>', `${sdkScript}${fallbackScript}${comment}</head>`);
         // 注入统一的 CTA 适配器
         html = await this.injectCTAAdapterAsync(html);
+        html = await this.injectTrackingAdapterAsync(html);
         return html;
     }
     getPlatformScript() {

package/dist/platforms/facebook.js

@@ -37,6 +37,7 @@ export class FacebookAdapter extends PlatformAdapter {
         html = html.replace('</head>', `${fbScript}</head>`);
         // 注入统一的 CTA 适配器
         html = await this.injectCTAAdapterAsync(html);
+        html = await this.injectTrackingAdapterAsync(html);
         return html;
     }
     getPlatformScript() {

package/dist/platforms/google.js

@@ -45,6 +45,7 @@ export class GoogleAdapter extends PlatformAdapter {
         html = html.replace('</head>', `${googleScript}${comment}${mobileMeta}${orientationMeta}${meta}${lazyLoadMeta}${preloadHint}</head>`);
         // 注入统一的 CTA 适配器
         html = await this.injectCTAAdapterAsync(html);
+        html = await this.injectTrackingAdapterAsync(html);
         // 注入懒加载优化脚本
         html = this.injectLazyLoadOptimization(html);
         return html;

package/dist/platforms/inmobi.js

@@ -41,6 +41,7 @@ export class InMobiAdapter extends PlatformAdapter {
         html = html.replace('</head>', `${inmobiScript}${comment}</head>`);
         // 注入统一的 CTA 适配器
         html = await this.injectCTAAdapterAsync(html);
+        html = await this.injectTrackingAdapterAsync(html);
         return html;
     }
     getPlatformScript() {

package/dist/platforms/ironsource.js

@@ -51,6 +51,7 @@ export class IronSourceAdapter extends PlatformAdapter {
         html = html.replace('</head>', `${ironSourceScript}${comment}</head>`);
         // 注入统一的 CTA 适配器
         html = await this.injectCTAAdapterAsync(html);
+        html = await this.injectTrackingAdapterAsync(html);
         return html;
     }
     getPlatformScript() {

package/dist/platforms/liftoff.js

@@ -36,6 +36,7 @@ export class LiftoffAdapter extends PlatformAdapter {
         html = html.replace('</head>', `${liftoffScript}${comment}</head>`);
         // 注入统一的 CTA 适配器
         html = await this.injectCTAAdapterAsync(html);
+        html = await this.injectTrackingAdapterAsync(html);
         return html;
     }
     getPlatformScript() {

package/dist/platforms/mintegral.js

@@ -43,6 +43,7 @@ export class MintegralAdapter extends PlatformAdapter {
         }
         // 注入统一的 CTA 适配器
         html = await this.injectCTAAdapterAsync(html);
+        html = await this.injectTrackingAdapterAsync(html);
         return html;
     }
     getPlatformScript() {

package/dist/platforms/moloco.js

@@ -33,6 +33,7 @@ export class MolocoAdapter extends PlatformAdapter {
         html = html.replace('</head>', `${molocoScript}${comment}</head>`);
         // 注入统一的 CTA 适配器
         html = await this.injectCTAAdapterAsync(html);
+        html = await this.injectTrackingAdapterAsync(html);
         return html;
     }
     getPlatformScript() {

package/dist/platforms/playcraft.js

@@ -32,7 +32,9 @@ export class PlayCraftAdapter extends PlatformAdapter {
      * PlayCraft 构建注入 CTA 适配器
      */
     async modifyHTML(html, _assets) {
-        return await this.injectCTAAdapterAsync(html);
+        html = await this.injectCTAAdapterAsync(html);
+        html = await this.injectTrackingAdapterAsync(html);
+        return html;
     }
     /**
      * 获取平台特定的 JavaScript 代码

package/dist/platforms/remerge.js

@@ -34,6 +34,7 @@ export class RemergeAdapter extends PlatformAdapter {
         html = html.replace('</head>', `${remergeScript}${comment}${meta}</head>`);
         // 注入统一的 CTA 适配器
         html = await this.injectCTAAdapterAsync(html);
+        html = await this.injectTrackingAdapterAsync(html);
         return html;
     }
     getPlatformScript() {

package/dist/platforms/snapchat.js

@@ -46,6 +46,7 @@ export class SnapchatAdapter extends PlatformAdapter {
         html = html.replace('</head>', `${mraidScript}</head>`);
         // 注入统一的 CTA 适配器
         html = await this.injectCTAAdapterAsync(html);
+        html = await this.injectTrackingAdapterAsync(html);
         return html;
     }
     getPlatformScript() {

package/dist/platforms/tiktok.js

@@ -40,6 +40,7 @@ export class TikTokAdapter extends PlatformAdapter {
         html = html.replace('</head>', `${pangleScript}${comment}</head>`);
         // 注入统一的 CTA 适配器
         html = await this.injectCTAAdapterAsync(html);
+        html = await this.injectTrackingAdapterAsync(html);
         return html;
     }
     getPlatformScript() {

package/dist/platforms/unity.js

@@ -44,6 +44,7 @@ export class UnityAdapter extends PlatformAdapter {
         html = html.replace('</head>', `${unityScript}${comment}</head>`);
         // 注入统一的 CTA 适配器
         html = await this.injectCTAAdapterAsync(html);
+        html = await this.injectTrackingAdapterAsync(html);
         return html;
     }
     getPlatformScript() {

package/dist/types.d.ts

@@ -48,6 +48,11 @@ export interface BuildOptions {
     preserveESM?: boolean;
     forceIIFE?: boolean;
     storeUrls?: StoreUrls;
+    tracking?: {
+        enabled?: boolean;
+        adNetwork?: string;
+        totalInteractions?: number;
+    };
 }
 export interface BaseBuildMetadata {
     mode: BuildMode;
@@ -201,6 +206,8 @@ export interface BaseBuildOptions {
     analyzeReportPath?: string;
     clean?: boolean;
     engine?: EngineType;
+    /** 渠道产物格式（playable-scripts 阶段；与 Vite 阶段 format 对齐） */
+    format?: OutputFormat;
 }
 /**
  * 基础构建输出

package/dist/vite/platform-configs.js

@@ -157,7 +157,7 @@ export const PLATFORM_CONFIGS = {
     },
     google: {
         sizeLimit: 5 * 1024 * 1024, // 5MB（修正）
-        outputFormat: 'zip', // ZIP格式（修正）
+        outputFormat: 'html', // 与 GoogleAdapter / CLI 默认一致；需要 ZIP 时显式传 format
         minifyCSS: true,
         minifyJS: true,
         compressImages: false, // 禁用图片压缩，原图输出效果更好

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playcraft/build",
-  "version": "0.0.23",
+  "version": "0.0.24",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -30,6 +30,7 @@
     "release": "node scripts/release.js"
   },
   "dependencies": {
+    "@playcraft/adsdk": "^1.0.13",
     "@gltf-transform/core": "^4.3.0",
     "@gltf-transform/extensions": "^4.3.0",
     "@gltf-transform/functions": "^4.3.0",
@@ -39,16 +40,17 @@
     "imagemin-mozjpeg": "^10.0.0",
     "imagemin-pngquant": "^10.0.0",
     "imagemin-webp": "^8.0.0",
+    "javascript-obfuscator": "^5.3.0",
     "lightningcss": "^1.31.1",
     "mime-types": "^2.1.35",
     "rollup-plugin-visualizer": "^6.0.5",
     "sharp": "^0.34.5",
-    "javascript-obfuscator": "^5.3.0",
     "terser": "^5.46.0",
     "vite": "^8.0.3",
     "vite-plugin-singlefile": "^2.3.2"
   },
   "devDependencies": {
+    "@playcraft/adsdk": "^1.0.13",
     "@types/archiver": "^6.0.4",
     "@types/mime-types": "^2.1.4",
     "@types/node": "^22.19.8",

package/templates/patches/playcraft-tracking-adapter.js

@@ -0,0 +1,130 @@
+/**
+ * PlayCraft Tracking Adapter (Bridge Layer)
+ *
+ * 职责：在正确的生命周期节点调用 window.PlayCraftTracking 的方法。
+ * 渠道埋点逻辑由 @playcraft/adsdk 的 tracking 模块提供（构建时自动提取注入）。
+ * 如果 adsdk tracking 未注入，adapter 的调用会静默忽略。
+ */
+(function() {
+  'use strict';
+
+  var _config = (typeof window !== 'undefined' && window.__PLAYCRAFT_TRACKING_CONFIG__) || {};
+  var adNetwork = _config.adNetwork || '';
+  var totalInteractions = _config.totalInteractions || 0;
+
+  function getTracking() {
+    return window.PlayCraftTracking || null;
+  }
+
+  function call(method, args) {
+    var t = getTracking();
+    if (t && typeof t[method] === 'function') {
+      t[method].apply(t, args || []);
+    }
+  }
+
+  // ===== 自动埋点 =====
+
+  // 1. setTotalInteractions + onInit（立即）
+  if (totalInteractions > 0) {
+    call('setTotalInteractions', [totalInteractions]);
+  }
+  call('onInit', [adNetwork]);
+
+  // 2. onStart（页面加载完成）
+  if (document.readyState === 'complete') {
+    setTimeout(function() { call('onStart', [adNetwork]); }, 0);
+  } else {
+    window.addEventListener('load', function() { call('onStart', [adNetwork]); });
+  }
+
+  // 2.5 onInteractive（游戏完全就绪，可交互）
+  // 优先级: playcraft:interactive 事件 > PlayCanvas app.on('start') fallback
+  var _interactive = false;
+  function triggerInteractive() {
+    if (_interactive) return;
+    _interactive = true;
+    call('onInteractive', [adNetwork]);
+  }
+  // 优先监听游戏主动派发的 playcraft:interactive
+  document.addEventListener('playcraft:interactive', triggerInteractive);
+  // Fallback: 如果游戏没有派发 playcraft:interactive，则在 PlayCanvas app start 后自动触发
+  var _pcPollCount = 0;
+  function pollPlayCanvasApp() {
+    if (_interactive) return; // 已被 playcraft:interactive 触发，不再 fallback
+    var app = (typeof pc !== 'undefined' && pc.Application && pc.Application.getApplication)
+      ? pc.Application.getApplication() : null;
+    if (app) {
+      if (app._time > 0 || app.frame > 0) {
+        triggerInteractive();
+      } else {
+        app.once('start', triggerInteractive);
+      }
+      return;
+    }
+    if (++_pcPollCount < 200) setTimeout(pollPlayCanvasApp, 50);
+  }
+  setTimeout(pollPlayCanvasApp, 0);
+
+  // 3. onInteraction（首次用户交互，只触发一次）
+  var _interacted = false;
+  function onFirstInteraction() {
+    if (_interacted) return;
+    _interacted = true;
+    call('onInteraction', [adNetwork]);
+    document.removeEventListener('touchstart', onFirstInteraction, true);
+    document.removeEventListener('mousedown', onFirstInteraction, true);
+    document.removeEventListener('pointerdown', onFirstInteraction, true);
+  }
+  document.addEventListener('touchstart', onFirstInteraction, true);
+  document.addEventListener('mousedown', onFirstInteraction, true);
+  document.addEventListener('pointerdown', onFirstInteraction, true);
+
+  // 4. onInstall（hook CTA adapter）
+  var _ctaAttempts = 0;
+  function hookCTA() {
+    if (window.PlayCraftCTA && window.PlayCraftCTA.jump) {
+      var _orig = window.PlayCraftCTA.jump;
+      window.PlayCraftCTA.jump = function(opts) {
+        call('onInstall', [adNetwork]);
+        _orig.call(window.PlayCraftCTA, opts);
+      };
+      if (window.jump2AppStore) window.jump2AppStore = window.PlayCraftCTA.jump;
+      return;
+    }
+    if (++_ctaAttempts < 50) setTimeout(hookCTA, 100);
+  }
+  setTimeout(hookCTA, 0);
+
+  // ===== 游戏协作事件（CustomEvent）=====
+  var once = {};
+  function listenOnce(name, method, extraArgs) {
+    document.addEventListener(name, function() {
+      if (once[name]) return; once[name] = true;
+      call(method, extraArgs || [adNetwork]);
+    });
+  }
+  function listen(name, method, extraArgs) {
+    document.addEventListener(name, function() {
+      call(method, extraArgs || [adNetwork]);
+    });
+  }
+
+  listenOnce('playcraft:finish', 'onFinish');
+  listen('playcraft:success', 'trackChallengeSuccess');
+  listen('playcraft:failed', 'trackChallengeFailed');
+  document.addEventListener('playcraft:retry', function() {
+    once['playcraft:finish'] = false;
+    call('onRetry', [adNetwork]);
+  });
+  document.addEventListener('playcraft:setTotal', function(e) {
+    var d = e.detail;
+    var n = typeof d === 'number' ? d : (d && d.total);
+    if (typeof n === 'number') call('setTotalInteractions', [n]);
+  });
+  document.addEventListener('playcraft:progress', function(e) {
+    var d = e.detail;
+    var n = typeof d === 'number' ? d : (d && d.current);
+    if (typeof n === 'number') call('checkInteractionProgress', [n]);
+  });
+})();