@playcraft/build 0.0.11 → 0.0.14

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

@@ -3,10 +3,44 @@
  * 
  * 提供统一的 API 接口，自动适配不同渠道的 CTA 调用方式
  * 游戏开发者只需调用 window.PlayCraftCTA.jump() 即可
+ * 
+ * 支持的广告渠道:
+ *   MRAID       - mraid.open(url)
+ *   DAPI        - dapi.openStoreUrl()
+ *   Nucleo      - NUC.trigger.convert(url)
+ *   BigoAds     - BGY_MRAID.open()
+ *   Facebook    - FbPlayableAd.onCTAClick()
+ *   Snapchat    - snapchatCta()
+ *   Smadex      - smxTracking.redirect()
+ *   Vungle      - parent.postMessage('download','*')
+ *   Google      - ExitApi.exit()
+ *   Mintegral   - window.install()
+ *   Tapjoy      - TJ_API.click()
+ *   TikTok      - window.openAppStore()
+ *   其他/兜底    - window.open(url)
  */
 (function() {
   'use strict';
 
+  // 商店跳转地址：优先读取构建时注入的全局变量，无则留空（由平台 SDK 接管）
+  var _storeUrls = (typeof window !== 'undefined' && window.__PLAYCRAFT_STORE_URLS__) || {};
+  var IOS_STORE_URL = _storeUrls.ios || '';
+  var ANDROID_STORE_URL = _storeUrls.android || '';
+
+  function getOS() {
+    var ua = navigator.userAgent || '';
+    if (/iPad|iPhone|iPod/.test(ua) || (navigator.platform === 'MacIntel' && navigator.maxTouchPoints > 1)) {
+      return 'ios';
+    } else if (/Android/i.test(ua)) {
+      return 'android';
+    }
+    return 'unknown';
+  }
+
+  function getStoreUrl() {
+    return getOS() === 'ios' ? IOS_STORE_URL : ANDROID_STORE_URL;
+  }
+
   // CTA 适配器类
   function CTAAdapter() {
     this.platform = null;
@@ -20,12 +54,13 @@
 
   /**
    * 检测当前运行的平台
+   * 通过检测全局对象来判断广告渠道
    */
   CTAAdapter.prototype.detectPlatform = function() {
     if (typeof FbPlayableAd !== 'undefined') {
-      this.platform = 'facebook'; // Facebook / Moloco
+      this.platform = 'facebook'; // Facebook / Moloco / Remerge
     } else if (typeof mraid !== 'undefined') {
-      this.platform = 'mraid'; // MRAID 系列（AppLovin, ironSource, Unity Ads 等）
+      this.platform = 'mraid'; // MRAID 系列（AppLovin, ironSource, Unity Ads, Snapchat, Liftoff, InMobi, Adikteev）
     } else if (typeof dapi !== 'undefined') {
       this.platform = 'dapi'; // ironSource DAPI
     } else if (typeof ExitApi !== 'undefined') {
@@ -34,6 +69,16 @@
       this.platform = 'bigo'; // BIGO Ads
     } else if (typeof snapchatCta === 'function') {
       this.platform = 'snapchat'; // Snapchat
+    } else if (typeof window.openAppStore === 'function') {
+      this.platform = 'tiktok'; // TikTok / Pangle
+    } else if (typeof window.install === 'function') {
+      this.platform = 'mintegral'; // Mintegral
+    } else if (typeof window.TJ_API !== 'undefined' && typeof window.TJ_API.click === 'function') {
+      this.platform = 'tapjoy'; // Tapjoy
+    } else if (typeof window.NUC !== 'undefined' && window.NUC.trigger && typeof window.NUC.trigger.convert === 'function') {
+      this.platform = 'nucleo'; // Nucleo
+    } else if (typeof window.smxTracking !== 'undefined' && typeof window.smxTracking.redirect === 'function') {
+      this.platform = 'smadex'; // Smadex
     } else {
       this.platform = 'unknown';
       console.warn('[PlayCraft CTA] 未检测到已知的广告平台 API');
@@ -50,7 +95,15 @@
     
     switch (this.platform) {
       case 'facebook':
-        // Facebook/Moloco 通常直接就绪
+      case 'google':
+      case 'bigo':
+      case 'snapchat':
+      case 'tiktok':
+      case 'mintegral':
+      case 'tapjoy':
+      case 'nucleo':
+      case 'smadex':
+        // 以上平台通常直接就绪
         this.isReady = true;
         this.notifyReady();
         break;
@@ -83,24 +136,6 @@
         }
         break;
         
-      case 'google':
-        // Google Ads 通常直接就绪
-        this.isReady = true;
-        this.notifyReady();
-        break;
-        
-      case 'bigo':
-        // BIGO 通常直接就绪
-        this.isReady = true;
-        this.notifyReady();
-        break;
-        
-      case 'snapchat':
-        // Snapchat 通常直接就绪
-        this.isReady = true;
-        this.notifyReady();
-        break;
-        
       default:
         // 未知平台，标记为就绪（使用降级方案）
         this.isReady = true;
@@ -147,22 +182,31 @@
     if (!this.isReady) {
       console.warn('[PlayCraft CTA] API 尚未就绪，跳转可能失败');
     }
+
+    // Store URL 空值预警
+    var _jumpUrl = options.url || getStoreUrl();
+    if (!_jumpUrl) {
+      console.error('[PlayCraft CTA] Store URL is not configured. Platform:', this.platform,
+        '| OS:', getOS(),
+        '| iOS URL:', IOS_STORE_URL,
+        '| Android URL:', ANDROID_STORE_URL);
+    }
     
     console.log('[PlayCraft CTA] 跳转应用商店 - 平台:', this.platform);
     
     try {
       switch (this.platform) {
         case 'facebook':
-          // Facebook / Moloco
+          // Facebook / Moloco / Remerge
           if (typeof FbPlayableAd !== 'undefined' && FbPlayableAd.onCTAClick) {
             FbPlayableAd.onCTAClick();
           }
           break;
           
         case 'mraid':
-          // MRAID 系列（AppLovin, ironSource, Unity Ads 等）
+          // MRAID 系列（AppLovin, ironSource, Unity Ads, Snapchat, Liftoff, InMobi, Adikteev）
           if (typeof mraid !== 'undefined' && mraid.open) {
-            mraid.open(options.url || '');
+            mraid.open(options.url || getStoreUrl());
           }
           break;
           
@@ -193,6 +237,41 @@
             snapchatCta();
           }
           break;
+
+        case 'tiktok':
+          // TikTok / Pangle
+          if (typeof window.openAppStore === 'function') {
+            window.openAppStore();
+          }
+          break;
+
+        case 'mintegral':
+          // Mintegral
+          if (typeof window.install === 'function') {
+            window.install();
+          }
+          break;
+
+        case 'tapjoy':
+          // Tapjoy
+          if (typeof window.TJ_API !== 'undefined' && window.TJ_API.click) {
+            window.TJ_API.click();
+          }
+          break;
+
+        case 'nucleo':
+          // Nucleo
+          if (typeof window.NUC !== 'undefined' && window.NUC.trigger && window.NUC.trigger.convert) {
+            window.NUC.trigger.convert(options.url || getStoreUrl());
+          }
+          break;
+
+        case 'smadex':
+          // Smadex
+          if (typeof window.smxTracking !== 'undefined' && window.smxTracking.redirect) {
+            window.smxTracking.redirect();
+          }
+          break;
           
         default:
           // 降级方案：尝试所有可能的 API
@@ -208,14 +287,16 @@
   };
 
   /**
-   * 降级跳转方案
+   * 降级跳转方案 - 按优先级尝试各种 API，最终兜底到 window.open
    */
   CTAAdapter.prototype.fallbackJump = function(url) {
+    var storeUrl = url || getStoreUrl();
+
     // 按优先级尝试各种 API
     if (typeof FbPlayableAd !== 'undefined' && FbPlayableAd.onCTAClick) {
       FbPlayableAd.onCTAClick();
     } else if (typeof mraid !== 'undefined' && mraid.open) {
-      mraid.open(url || '');
+      mraid.open(storeUrl);
     } else if (typeof dapi !== 'undefined' && dapi.openStoreUrl) {
       dapi.openStoreUrl();
     } else if (typeof ExitApi !== 'undefined' && ExitApi.exit) {
@@ -224,12 +305,29 @@
       window.BGY_MRAID.open();
     } else if (typeof snapchatCta === 'function') {
       snapchatCta();
-    } else if (url) {
-      // 最后的降级方案：直接打开链接（仅在开发环境）
-      console.warn('[PlayCraft CTA] 使用降级方案: window.open');
-      window.open(url, '_blank');
+    } else if (typeof window.openAppStore === 'function') {
+      window.openAppStore();
+    } else if (typeof window.install === 'function') {
+      window.install();
+    } else if (typeof window.TJ_API !== 'undefined' && window.TJ_API.click) {
+      window.TJ_API.click();
+    } else if (typeof window.NUC !== 'undefined' && window.NUC.trigger && window.NUC.trigger.convert) {
+      window.NUC.trigger.convert(storeUrl);
+    } else if (typeof window.smxTracking !== 'undefined' && window.smxTracking.redirect) {
+      window.smxTracking.redirect();
     } else {
-      console.error('[PlayCraft CTA] 无法跳转：未找到可用的 API');
+      // 最后的降级方案：直接打开应用商店链接
+      console.warn('[PlayCraft CTA] 使用降级方案: window.open');
+      try {
+        parent.postMessage('download', '*');
+      } catch (e) {
+        // Vungle 兜底
+      }
+      if (!storeUrl) {
+        console.error('[PlayCraft CTA] Store URL is not configured for this platform. Aborting redirect.');
+      } else {
+        window.open(storeUrl, '_blank');
+      }
     }
   };
 

package/templates/patches/scene-physics-defaults.js

@@ -0,0 +1,49 @@
+/**
+ * Scene applySettings 补丁：当使用 ammoReplacement (Cannon/p2) 时，
+ * 确保 settings.physics 存在，避免 PlayCanvas 引擎在 applySettings 中
+ * 访问 undefined.gravity 导致 "Cannot read properties of undefined (reading 'gravity')" 错误。
+ *
+ * 使用场景：项目使用 Ammo.js 但构建时被替换为 Cannon/p2，部分场景 JSON 可能缺少 physics 配置。
+ */
+(function () {
+    'use strict';
+    function patchSceneApplySettings() {
+        if (typeof pc === 'undefined' || !pc.Scene || !pc.Scene.prototype.applySettings) {
+            return false;
+        }
+        var original = pc.Scene.prototype.applySettings;
+        pc.Scene.prototype.applySettings = function (settings) {
+            if (!settings) return;
+            if (!settings.physics) {
+                settings.physics = { gravity: [0, -9.8, 0] };
+            } else if (!settings.physics.gravity) {
+                settings.physics.gravity = [0, -9.8, 0];
+            }
+            if (!settings.render) {
+                settings.render = {
+                    global_ambient: [0.2, 0.2, 0.2],
+                    ambientLuminance: 0,
+                    fog: 'none',
+                    fog_color: [0.5, 0.5, 0.5],
+                    fog_start: 1,
+                    fog_end: 1000,
+                    fog_density: 0.01,
+                    lightmapSizeMultiplier: 16,
+                    lightmapMaxResolution: 2048,
+                    lightmapMode: 1,
+                    exposure: 1
+                };
+            }
+            return original.call(this, settings);
+        };
+        return true;
+    }
+    if (patchSceneApplySettings()) {
+        console.log('[PlayCraft] Scene applySettings patched for physics defaults');
+    } else {
+        var attempts = 0;
+        var id = setInterval(function () {
+            if (patchSceneApplySettings() || ++attempts > 50) clearInterval(id);
+        }, 20);
+    }
+})();