@maoyugames/phaser-framework 1.0.10 → 1.0.12

package/dist/{BasePlatform-BCOkvvDW.d.ts → BasePlatform-CwVOo3_q.d.ts}

@@ -1,4 +1,4 @@
-import { d as IPlatform, p as PlatformName, S as SafeArea, t as SystemInfo, L as LaunchOptions, j as IPlatformNet, m as IPlatformStorage, i as IPlatformLifecycle, g as IPlatformAuth, e as IPlatformAds, k as IPlatformPayment, h as IPlatformDevice, f as IPlatformAnalytics, P as PlatformInfo } from './types-DtcRFbM0.js';
+import { d as IPlatform, r as PlatformName, S as SafeArea, v as SystemInfo, L as LaunchOptions, k as IPlatformNet, o as IPlatformStorage, i as IPlatformLifecycle, g as IPlatformAuth, e as IPlatformAds, l as IPlatformPayment, h as IPlatformDevice, f as IPlatformAnalytics, m as IPlatformShortcut, j as IPlatformMission, P as PlatformInfo } from './types-WJYVtDfo.js';
 
 /**
  * 平台抽象基类:封装"有 DOM/BOM 的环境"通用实现,供
@@ -35,6 +35,8 @@ declare abstract class BasePlatform implements IPlatform {
     readonly payment?: IPlatformPayment;
     readonly device?: IPlatformDevice;
     readonly analytics?: IPlatformAnalytics;
+    readonly shortcut?: IPlatformShortcut;
+    readonly mission?: IPlatformMission;
     get info(): PlatformInfo;
     abstract init(): Promise<void>;
     getLaunchOptions(): LaunchOptions;

package/dist/{chunk-H5CUVYCN.js → chunk-PDESBWLX.js}

@@ -161,6 +161,8 @@ var BasePlatform = class {
     __publicField(this, "payment");
     __publicField(this, "device");
     __publicField(this, "analytics");
+    __publicField(this, "shortcut");
+    __publicField(this, "mission");
   }
   get info() {
     return {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { b as HttpRequestOptions, U as Unsubscribe, H as Handler, n as LogLevel, A as AdResult, r as PurchaseResult, o as LoginResult, d as IPlatform, i as IPlatformLifecycle, S as SafeArea } from './types-DtcRFbM0.js';
-export { a as HttpMethod, c as HttpResponse, I as IDisposable, e as IPlatformAds, f as IPlatformAnalytics, g as IPlatformAuth, h as IPlatformDevice, j as IPlatformNet, k as IPlatformPayment, l as IPlatformSocket, m as IPlatformStorage, L as LaunchOptions, P as PlatformInfo, p as PlatformName, q as PlatformUnsupportedError, R as Result, s as SocketOptions, t as SystemInfo, V as Vec2, u as err, v as ok } from './types-DtcRFbM0.js';
+import { b as HttpRequestOptions, U as Unsubscribe, H as Handler, p as LogLevel, A as AdResult, t as PurchaseResult, q as LoginResult, d as IPlatform, i as IPlatformLifecycle, S as SafeArea } from './types-WJYVtDfo.js';
+export { a as HttpMethod, c as HttpResponse, I as IDisposable, e as IPlatformAds, f as IPlatformAnalytics, g as IPlatformAuth, h as IPlatformDevice, j as IPlatformMission, k as IPlatformNet, l as IPlatformPayment, m as IPlatformShortcut, n as IPlatformSocket, o as IPlatformStorage, L as LaunchOptions, P as PlatformInfo, r as PlatformName, s as PlatformUnsupportedError, R as Result, u as SocketOptions, v as SystemInfo, V as Vec2, w as err, x as ok } from './types-WJYVtDfo.js';
 import Phaser from 'phaser';
 
 /**

package/dist/platform/capacitor.d.ts

@@ -1,5 +1,5 @@
-import { p as PlatformName, h as IPlatformDevice, i as IPlatformLifecycle } from '../types-DtcRFbM0.js';
-import { B as BasePlatform } from '../BasePlatform-BCOkvvDW.js';
+import { r as PlatformName, h as IPlatformDevice, i as IPlatformLifecycle } from '../types-WJYVtDfo.js';
+import { B as BasePlatform } from '../BasePlatform-CwVOo3_q.js';
 
 /**
  * Capacitor(原生 WebView 容器)平台适配器。

package/dist/platform/capacitor.js

@@ -1,4 +1,4 @@
-import { BasePlatform, DomLifecycle } from '../chunk-H5CUVYCN.js';
+import { BasePlatform, DomLifecycle } from '../chunk-PDESBWLX.js';
 import { PlatformUnsupportedError } from '../chunk-II3JM4R3.js';
 import { __publicField } from '../chunk-PKBMQBKP.js';
 

package/dist/platform/facebook.d.ts

@@ -1,5 +1,5 @@
-import { p as PlatformName, m as IPlatformStorage, g as IPlatformAuth, e as IPlatformAds, k as IPlatformPayment, h as IPlatformDevice, i as IPlatformLifecycle } from '../types-DtcRFbM0.js';
-import { B as BasePlatform } from '../BasePlatform-BCOkvvDW.js';
+import { r as PlatformName, o as IPlatformStorage, g as IPlatformAuth, e as IPlatformAds, l as IPlatformPayment, h as IPlatformDevice, i as IPlatformLifecycle } from '../types-WJYVtDfo.js';
+import { B as BasePlatform } from '../BasePlatform-CwVOo3_q.js';
 
 /**
  * Facebook Instant Games 平台适配器。

package/dist/platform/facebook.js

@@ -1,4 +1,4 @@
-import { BasePlatform, DomLifecycle } from '../chunk-H5CUVYCN.js';
+import { BasePlatform, DomLifecycle } from '../chunk-PDESBWLX.js';
 import { PlatformUnsupportedError } from '../chunk-II3JM4R3.js';
 import { __publicField } from '../chunk-PKBMQBKP.js';
 

package/dist/platform/tiktok.d.ts

@@ -1,5 +1,5 @@
-import { p as PlatformName, g as IPlatformAuth, e as IPlatformAds, k as IPlatformPayment, h as IPlatformDevice, f as IPlatformAnalytics, i as IPlatformLifecycle } from '../types-DtcRFbM0.js';
-import { B as BasePlatform } from '../BasePlatform-BCOkvvDW.js';
+import { r as PlatformName, g as IPlatformAuth, e as IPlatformAds, l as IPlatformPayment, h as IPlatformDevice, f as IPlatformAnalytics, m as IPlatformShortcut, j as IPlatformMission, i as IPlatformLifecycle } from '../types-WJYVtDfo.js';
+import { B as BasePlatform } from '../BasePlatform-CwVOo3_q.js';
 
 /**
  * TikTok Mini Games(Minis)平台适配器。
@@ -23,6 +23,8 @@ declare class TikTokPlatform extends BasePlatform {
     readonly payment: IPlatformPayment;
     readonly device: IPlatformDevice;
     readonly analytics: IPlatformAnalytics;
+    readonly shortcut: IPlatformShortcut;
+    readonly mission: IPlatformMission;
     readonly lifecycle: IPlatformLifecycle;
     init(): Promise<void>;
 }

package/dist/platform/tiktok.js

@@ -1,4 +1,4 @@
-import { BasePlatform } from '../chunk-H5CUVYCN.js';
+import { BasePlatform } from '../chunk-PDESBWLX.js';
 import { PlatformUnsupportedError } from '../chunk-II3JM4R3.js';
 import { __publicField } from '../chunk-PKBMQBKP.js';
 
@@ -10,40 +10,183 @@ function requireTT(capability) {
   if (!hasTT()) throw new PlatformUnsupportedError("tiktok", capability);
 }
 var TikTokAuth = class {
+  // TikTok H5 SDK 实测(2026-05-28 反编译 connect.tiktok-minis.com/game/sdk.js)
+  // **没有 game.login 也没有 game.getUserInfo**——这两个 API 是抖音(国内)小游戏的协议,
+  // TikTok 海外走 OAuth code 流程:authorizeOpenContext({get_status_only:false}) 弹授权页拿 code,
+  // 后端用 code + client_secret 调 open.tiktokapis.com/v2/oauth/token/ + /v2/user/info/ 拿 user info。
   async login() {
     requireTT("auth.login");
-    const res = await TTMinis.game.login();
-    return { code: res.code, openId: res.openId, raw: res };
+    let res = await TTMinis.game.authorizeOpenContext({ get_status_only: true });
+    if (!res?.is_success || !res?.code) {
+      res = await TTMinis.game.authorizeOpenContext({ get_status_only: false });
+    }
+    if (!res?.is_success || !res?.code) {
+      const e = res?.error;
+      throw new Error(`TikTok authorize failed: ${e?.error_msg ?? "unknown"} (code=${e?.error_code ?? "NA"})`);
+    }
+    return { code: res.code, raw: res };
   }
+  // TikTok H5 SDK 没有客户端 user info API。nickname/avatar 必须由后端用 access_token 调
+  // /v2/user/info/ 取(scope=user.info.basic),客户端拿到的 user 已含这些字段。
   async getProfile() {
-    requireTT("auth.getProfile");
-    const info = await TTMinis.game.getUserInfo();
-    if (!info) return null;
-    return { nickname: info.nickName ?? "", avatarUrl: info.avatarUrl ?? "" };
+    return null;
   }
 };
 var TikTokAds = class {
-  async preloadRewarded(adUnitId) {
-    requireTT("ads.preloadRewarded");
-    await TTMinis.game.preloadRewardedVideo(adUnitId ? { adUnitId } : void 0);
+  // TikTok H5 SDK 只有 createRewardedVideoAd(没有 preload/show/Interstitial 单独 API,
+  // 实测 2026-05-28 反编译 connect.tiktok-minis.com/game/sdk.js 36 个 game.* 方法确认)。
+  // 之前 framework 调 preloadRewardedVideo / showRewardedVideo / showInterstitialAd 全部
+  // throw TypeError,被 try-catch 吞掉返 'failed',审核因此判"未集成有效营收功能"。
+  //
+  // 修复:统一走 createRewardedVideoAd(优先同步签名拿 ad 实例,失败试异步 callback 签名),
+  // ad.onClose 等结果后 ad.show 触发展示;preloadRewarded 退化为 noop(SDK 自身管预加载)。
+  async preloadRewarded(_adUnitId) {
   }
-  async showRewarded(adUnitId) {
+  showRewarded(adUnitId) {
     requireTT("ads.showRewarded");
+    return new Promise((resolve) => {
+      const onResult = (isEnded) => resolve(isEnded ? "completed" : "skipped");
+      const onError = (msg) => {
+        console.warn("[ads.showRewarded] error:", msg);
+        resolve("failed");
+      };
+      try {
+        const adSync = TTMinis.game.createRewardedVideoAd({ adUnitId });
+        if (adSync && typeof adSync.show === "function") {
+          this.wireAd(adSync, onResult, onError);
+          return;
+        }
+      } catch (e) {
+        console.warn("[ads] sync createRewardedVideoAd failed, try async:", e?.message);
+      }
+      try {
+        TTMinis.game.createRewardedVideoAd((res) => {
+          if (res?.is_success && res.rewardedVideoAd) {
+            this.wireAd(res.rewardedVideoAd, onResult, onError);
+          } else {
+            onError(JSON.stringify(res?.error ?? "create failed"));
+          }
+        }, { adUnitId });
+      } catch (e) {
+        onError(e?.message ?? "createRewardedVideoAd both signatures failed");
+      }
+    });
+  }
+  wireAd(ad, onResult, onError) {
+    let settled = false;
     try {
-      const res = await TTMinis.game.showRewardedVideo(adUnitId ? { adUnitId } : void 0);
-      return res?.isEnded ? "completed" : "skipped";
-    } catch {
-      return "failed";
+      ad.onClose((res) => {
+        if (settled) return;
+        settled = true;
+        onResult(!!res?.isEnded);
+      });
+    } catch (e) {
+      onError(`onClose unsupported: ${e?.message}`);
+      return;
     }
+    if (typeof ad.onError === "function") {
+      try {
+        ad.onError((res) => {
+          if (settled) return;
+          settled = true;
+          onError(res?.error?.error_msg ?? "ad error");
+        });
+      } catch {
+      }
+    }
+    void ad.show().catch((e) => {
+      if (settled) return;
+      settled = true;
+      onError(e?.message ?? "show rejected");
+    });
   }
-  async showInterstitial(adUnitId) {
-    requireTT("ads.showInterstitial");
-    try {
-      await TTMinis.game.showInterstitialAd(adUnitId ? { adUnitId } : void 0);
-      return "closed";
-    } catch {
-      return "failed";
+  async showInterstitial(_adUnitId) {
+    return "failed";
+  }
+};
+var TikTokShortcut = class {
+  // SDK callback-style API;每个都用 typeof 检测 + 静默降级,避免老 SDK 没此方法 throw 阻断业务。
+  check() {
+    if (!hasTT() || typeof TTMinis.game.checkShortcut !== "function") return Promise.resolve(false);
+    return new Promise((resolve) => {
+      try {
+        TTMinis.game.checkShortcut({
+          success: (res) => resolve(!!res?.exist),
+          fail: () => resolve(false)
+        });
+      } catch {
+        resolve(false);
+      }
+    });
+  }
+  add() {
+    if (!hasTT() || typeof TTMinis.game.addShortcut !== "function") return Promise.resolve(false);
+    return new Promise((resolve) => {
+      try {
+        TTMinis.game.addShortcut({
+          success: () => resolve(true),
+          fail: () => resolve(false)
+        });
+      } catch {
+        resolve(false);
+      }
+    });
+  }
+  getMissionReward() {
+    if (!hasTT() || typeof TTMinis.game.getShortcutMissionReward !== "function") {
+      return Promise.resolve({ canReceive: false });
     }
+    return new Promise((resolve) => {
+      try {
+        TTMinis.game.getShortcutMissionReward({
+          success: (res) => resolve({ canReceive: !!res?.canReceiveReward }),
+          fail: () => resolve({ canReceive: false })
+        });
+      } catch {
+        resolve({ canReceive: false });
+      }
+    });
+  }
+};
+var TikTokMission = class {
+  startEntrance() {
+    if (!hasTT() || typeof TTMinis.game.startEntranceMission !== "function") return Promise.resolve({ ok: false });
+    return new Promise((resolve) => {
+      try {
+        TTMinis.game.startEntranceMission({
+          success: () => resolve({ ok: true }),
+          fail: () => resolve({ ok: false })
+        });
+      } catch {
+        resolve({ ok: false });
+      }
+    });
+  }
+  getEntranceReward() {
+    if (!hasTT() || typeof TTMinis.game.getEntranceMissionReward !== "function") return Promise.resolve({ canReceive: false });
+    return new Promise((resolve) => {
+      try {
+        TTMinis.game.getEntranceMissionReward({
+          success: (res) => resolve({ canReceive: !!res?.canReceiveReward }),
+          fail: () => resolve({ canReceive: false })
+        });
+      } catch {
+        resolve({ canReceive: false });
+      }
+    });
+  }
+  getFyfReward() {
+    if (!hasTT() || typeof TTMinis.game.getFyfMissionReward !== "function") return Promise.resolve({ canReceive: false });
+    return new Promise((resolve) => {
+      try {
+        TTMinis.game.getFyfMissionReward({
+          success: (res) => resolve({ canReceive: !!res?.canReceiveReward }),
+          fail: () => resolve({ canReceive: false })
+        });
+      } catch {
+        resolve({ canReceive: false });
+      }
+    });
   }
 };
 var TikTokPayment = class {
@@ -141,6 +284,8 @@ var TikTokPlatform = class extends BasePlatform {
     __publicField(this, "payment", new TikTokPayment());
     __publicField(this, "device", new TikTokDevice());
     __publicField(this, "analytics", new TikTokAnalytics());
+    __publicField(this, "shortcut", new TikTokShortcut());
+    __publicField(this, "mission", new TikTokMission());
     // 用 TTMinis 桥接的生命周期,缺失时由其内部退回 noop;DOM 退路在 init 中按需补
     __publicField(this, "lifecycle", new TikTokLifecycle());
   }

package/dist/platform/web.d.ts

@@ -1,5 +1,5 @@
-import { p as PlatformName, h as IPlatformDevice } from '../types-DtcRFbM0.js';
-import { B as BasePlatform } from '../BasePlatform-BCOkvvDW.js';
+import { r as PlatformName, h as IPlatformDevice } from '../types-WJYVtDfo.js';
+import { B as BasePlatform } from '../BasePlatform-CwVOo3_q.js';
 
 /**
  * Web(普通浏览器 / H5)平台适配器。

package/dist/platform/web.js

@@ -1,4 +1,4 @@
-import { BasePlatform } from '../chunk-H5CUVYCN.js';
+import { BasePlatform } from '../chunk-PDESBWLX.js';
 import { __publicField } from '../chunk-PKBMQBKP.js';
 
 // src/platform/impl/web/WebPlatform.ts

package/dist/platform/wechat.d.ts

@@ -1,4 +1,4 @@
-import { d as IPlatform, j as IPlatformNet, m as IPlatformStorage, i as IPlatformLifecycle, g as IPlatformAuth, e as IPlatformAds, k as IPlatformPayment, h as IPlatformDevice, P as PlatformInfo, L as LaunchOptions } from '../types-DtcRFbM0.js';
+import { d as IPlatform, k as IPlatformNet, o as IPlatformStorage, i as IPlatformLifecycle, g as IPlatformAuth, e as IPlatformAds, l as IPlatformPayment, h as IPlatformDevice, P as PlatformInfo, L as LaunchOptions } from '../types-WJYVtDfo.js';
 
 /**
  * 微信小游戏平台适配器。

package/dist/{types-DtcRFbM0.d.ts → types-WJYVtDfo.d.ts}

@@ -207,6 +207,32 @@ interface IPlatformDevice {
         query?: string;
     }): Promise<void>;
 }
+/** 桌面快捷方式(TikTok minigame 审核硬性要求;不支持的平台为 undefined) */
+interface IPlatformShortcut {
+    /** 是否已添加到桌面(平台不支持时 resolve false) */
+    check(): Promise<boolean>;
+    /** 触发平台原生"添加到桌面"系统提示,resolve 表示添加成功 */
+    add(): Promise<boolean>;
+    /** 查询"添加桌面快捷方式"任务奖励状态(可领取且未领取返 true) */
+    getMissionReward?(): Promise<{
+        canReceive: boolean;
+    }>;
+}
+/** 任务系统(TikTok minigame 审核硬性要求 - 侧边栏入口任务) */
+interface IPlatformMission {
+    /** 触发侧边栏入口任务(SDK 把用户带到 TikTok profile sidebar 完成教育流程) */
+    startEntrance(): Promise<{
+        ok: boolean;
+    }>;
+    /** 查询入口任务奖励状态 */
+    getEntranceReward(): Promise<{
+        canReceive: boolean;
+    }>;
+    /** 查询"For You Feed 入口"任务奖励状态(若启用) */
+    getFyfReward?(): Promise<{
+        canReceive: boolean;
+    }>;
+}
 /** 平台原生埋点(可选;通常业务用 AnalyticsManager 统一上报) */
 interface IPlatformAnalytics {
     reportEvent(name: string, params?: Record<string, unknown>): void;
@@ -234,6 +260,8 @@ interface IPlatform {
     readonly payment?: IPlatformPayment;
     readonly device?: IPlatformDevice;
     readonly analytics?: IPlatformAnalytics;
+    readonly shortcut?: IPlatformShortcut;
+    readonly mission?: IPlatformMission;
 }
 
-export { type AdResult as A, type Handler as H, type IDisposable as I, type LaunchOptions as L, type PlatformInfo as P, type Result as R, type SafeArea as S, type Unsubscribe as U, type Vec2 as V, type HttpMethod as a, type HttpRequestOptions as b, type HttpResponse as c, type IPlatform as d, type IPlatformAds as e, type IPlatformAnalytics as f, type IPlatformAuth as g, type IPlatformDevice as h, type IPlatformLifecycle as i, type IPlatformNet as j, type IPlatformPayment as k, type IPlatformSocket as l, type IPlatformStorage as m, LogLevel as n, type LoginResult as o, type PlatformName as p, PlatformUnsupportedError as q, type PurchaseResult as r, type SocketOptions as s, type SystemInfo as t, err as u, ok as v };
+export { type AdResult as A, type Handler as H, type IDisposable as I, type LaunchOptions as L, type PlatformInfo as P, type Result as R, type SafeArea as S, type Unsubscribe as U, type Vec2 as V, type HttpMethod as a, type HttpRequestOptions as b, type HttpResponse as c, type IPlatform as d, type IPlatformAds as e, type IPlatformAnalytics as f, type IPlatformAuth as g, type IPlatformDevice as h, type IPlatformLifecycle as i, type IPlatformMission as j, type IPlatformNet as k, type IPlatformPayment as l, type IPlatformShortcut as m, type IPlatformSocket as n, type IPlatformStorage as o, LogLevel as p, type LoginResult as q, type PlatformName as r, PlatformUnsupportedError as s, type PurchaseResult as t, type SocketOptions as u, type SystemInfo as v, err as w, ok as x };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maoyugames/phaser-framework",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "description": "多平台 Phaser 游戏框架:业务/底层分离,HTTP/WebSocket/KCP,Web/TikTok/微信/Facebook/App 隔离打包",
   "type": "module",
   "license": "MIT",