npm - @maoyugames/phaser-framework - Versions diffs - 1.0.16 → 1.0.25 - Mend

@maoyugames/phaser-framework 1.0.16 → 1.0.25

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (17) hide show

package/dist/{BasePlatform-CwVOo3_q.d.ts → BasePlatform-DqIfl-Oi.d.ts} +1 -1
package/dist/{chunk-PDESBWLX.js → chunk-NFEHUFN7.js} +1 -1
package/dist/cli/index.js +260 -129
package/dist/index.d.ts +34 -3
package/dist/platform/capacitor.d.ts +2 -2
package/dist/platform/capacitor.js +1 -1
package/dist/platform/facebook.d.ts +4 -3
package/dist/platform/facebook.js +64 -6
package/dist/platform/tiktok.d.ts +2 -2
package/dist/platform/tiktok.js +145 -53
package/dist/platform/web.d.ts +2 -2
package/dist/platform/web.js +1 -1
package/dist/platform/wechat.d.ts +1 -1
package/dist/platform/youtube.d.ts +71 -0
package/dist/platform/youtube.js +310 -0
package/dist/{types-WJYVtDfo.d.ts → types-CxYJ9uz0.d.ts} +6 -1
package/package.json +5 -1

package/dist/index.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
-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 { 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-CxYJ9uz0.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-CxYJ9uz0.js';
 import Phaser from 'phaser';
 /**
@@ -1805,6 +1805,35 @@ interface FacebookPlatformConfig {
     /** 广告位配置(覆盖 common.ads) */
     ads?: AdsConfig;
 }
+/**
+ * YouTube Playables 平台配置。
+ *
+ * YouTube Playables SDK 由构建侧通过 `<script src="https://www.youtube.com/game_api/v1">`
+ * 注入 <head>(必须在游戏 bundle 前),运行时挂载全局 `ytgame`。
+ * 文档:https://developers.google.com/youtube/gaming/playables/reference/getting_started
+ *
+ * 注意:YouTube Playables **禁止任何内购**(off-platform 也不允许),故无 IAP 相关字段;
+ * 广告(激励/插屏)走 ytgame.ads.*,广告位由 YouTube 后台 monetization 配置,游戏侧
+ * rewardId 经 common.ads / ads 传入。
+ */
+interface YouTubePlatformConfig {
+    /** 页面标题(注入 index.html <title>) */
+    title?: string;
+    /**
+     * YouTube Playables SDK 脚本地址(注入 index.html <head> 第一个 script)。
+     * 不填用官方默认 https://www.youtube.com/game_api/v1。
+     */
+    sdkUrl?: string;
+    /** 屏幕方向(用于 viewport / meta 提示) */
+    orientation?: Orientation;
+    /** 业务后端基址(覆盖 common.apiBaseURL) */
+    apiBaseURL?: string;
+    /**
+     * 广告位配置(覆盖 common.ads)。YouTube 激励广告用 reward id(UUID 形态),
+     * 由 YouTube 后台 monetization 生成,填到 ads.rewardedUnitId。
+     */
+    ads?: AdsConfig;
+}
 /** Capacitor(iOS + Android 原生 App)平台配置 */
 interface CapacitorPlatformConfig {
     /** 应用包名/反向域名(写入 capacitor.config appId,如 com.example.app) */
@@ -1842,6 +1871,8 @@ interface PlatformConfig {
     facebook?: FacebookPlatformConfig;
     /** Capacitor 原生 App */
     capacitor?: CapacitorPlatformConfig;
+    /** YouTube Playables */
+    youtube?: YouTubePlatformConfig;
 }
-export { AdResult, type AdsConfig, App, type AppConfig, BaseModule, BasePanel, BaseScene, Button, type ButtonConfig, type ButtonStyle, type CapacitorPlatformConfig, ConfigTable, ConfigTableManager, ErrorCode, type FacebookPlatformConfig, FrameworkError, Handler, HttpClient, type HttpClientConfig, HttpError, type HttpInterceptors, HttpRequestOptions, I18n, type I18nOptions, type IAccountService, type IAdsManager, type IAnalyticsManager, type IApp, type IAssetLoader, type IAudioManager, type IConfigService, type IEventBus, type IHttpClient, type IKcpTransport, type ILogger, type INetManager, type IPanelManager, type IPaymentManager, IPlatform, IPlatformLifecycle, type ISceneManager, type ISocketClient, type IStorageManager, IconButton, type IconButtonConfig, JsonCodec, KcpClient, type KcpClientConfig, type KcpTransportFactory, type LayerName, Layers, LogLevel, LoginResult, MessageChannel, type MessageChannelOptions, type MessageCodec, type MessageEnvelope, MessageError, ModuleRegistry, NetManager, type NetManagerOptions, type NetProtocol, ObjectPool, type Orientation, type PanelCtor, PanelManager, type PlatformConfig, PlatformContext, PurchaseResult, SafeArea, SaveManager, type SaveSlot, type SaveSlotOptions, type ScheduleHandle, Scheduler, type SocketClientConfig, type SocketState, type StartGameOptions, type Store, type TikTokPlatformConfig, TypedEventBus, Unsubscribe, type WeChatPlatformConfig, type WebPlatformConfig, WebSocketClient, createStore, createTypedEventBus, isFrameworkError, normalizeLocale, startGame };
+export { AdResult, type AdsConfig, App, type AppConfig, BaseModule, BasePanel, BaseScene, Button, type ButtonConfig, type ButtonStyle, type CapacitorPlatformConfig, ConfigTable, ConfigTableManager, ErrorCode, type FacebookPlatformConfig, FrameworkError, Handler, HttpClient, type HttpClientConfig, HttpError, type HttpInterceptors, HttpRequestOptions, I18n, type I18nOptions, type IAccountService, type IAdsManager, type IAnalyticsManager, type IApp, type IAssetLoader, type IAudioManager, type IConfigService, type IEventBus, type IHttpClient, type IKcpTransport, type ILogger, type INetManager, type IPanelManager, type IPaymentManager, IPlatform, IPlatformLifecycle, type ISceneManager, type ISocketClient, type IStorageManager, IconButton, type IconButtonConfig, JsonCodec, KcpClient, type KcpClientConfig, type KcpTransportFactory, type LayerName, Layers, LogLevel, LoginResult, MessageChannel, type MessageChannelOptions, type MessageCodec, type MessageEnvelope, MessageError, ModuleRegistry, NetManager, type NetManagerOptions, type NetProtocol, ObjectPool, type Orientation, type PanelCtor, PanelManager, type PlatformConfig, PlatformContext, PurchaseResult, SafeArea, SaveManager, type SaveSlot, type SaveSlotOptions, type ScheduleHandle, Scheduler, type SocketClientConfig, type SocketState, type StartGameOptions, type Store, type TikTokPlatformConfig, TypedEventBus, Unsubscribe, type WeChatPlatformConfig, type WebPlatformConfig, WebSocketClient, type YouTubePlatformConfig, createStore, createTypedEventBus, isFrameworkError, normalizeLocale, startGame };

package/dist/platform/capacitor.d.ts CHANGED Viewed

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

package/dist/platform/capacitor.js CHANGED Viewed

@@ -1,5 +1,5 @@
-import { BasePlatform, DomLifecycle } from '../chunk-PDESBWLX.js';
 import { PlatformUnsupportedError } from '../chunk-II3JM4R3.js';
+import { BasePlatform, DomLifecycle } from '../chunk-NFEHUFN7.js';
 import { __publicField } from '../chunk-PKBMQBKP.js';
 // src/platform/impl/capacitor/CapacitorPlatform.ts

package/dist/platform/facebook.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
-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';
+import { r as PlatformName, o as IPlatformStorage, g as IPlatformAuth, e as IPlatformAds, l as IPlatformPayment, h as IPlatformDevice, m as IPlatformShortcut, i as IPlatformLifecycle } from '../types-CxYJ9uz0.js';
+import { B as BasePlatform } from '../BasePlatform-DqIfl-Oi.js';
 /**
  * Facebook Instant Games 平台适配器。
@@ -24,8 +24,9 @@ declare class FacebookPlatform extends BasePlatform {
     readonly storage: IPlatformStorage;
     readonly auth: IPlatformAuth;
     readonly ads: IPlatformAds;
-    readonly payment: IPlatformPayment;
+    payment?: IPlatformPayment;
     readonly device: IPlatformDevice;
+    readonly shortcut: IPlatformShortcut;
     readonly lifecycle: IPlatformLifecycle;
     init(): Promise<void>;
 }

package/dist/platform/facebook.js CHANGED Viewed

@@ -1,5 +1,5 @@
-import { BasePlatform, DomLifecycle } from '../chunk-PDESBWLX.js';
 import { PlatformUnsupportedError } from '../chunk-II3JM4R3.js';
+import { BasePlatform, DomLifecycle } from '../chunk-NFEHUFN7.js';
 import { __publicField } from '../chunk-PKBMQBKP.js';
 // src/platform/impl/facebook/FacebookPlatform.ts
@@ -86,12 +86,29 @@ var FacebookAuth = class {
       raw: info
     };
   }
+  // Zero Permissions 模型(SDK v8.0+,2026-06 核对 developers.facebook.com 官方文档):
+  // 游戏**无法直接 JS 读取** name/profile picture —— Meta 改在独立 iFrame「Overlay Views」内渲染
+  // 用户信息(游戏在 bundle 放 XML 布局,用 {{FBInstant.player.name}}/{{...photo}} 占位,
+  // FBInstant.views.createOverlayView 创建,游戏拿不到原始值)。
+  // 因此 getName/getPhoto 在 Zero Permissions 下返 undefined 或抛 → 这里 try-catch 返 null,
+  // 业务排行榜用 player ID / 游客显示。如需在游戏内显示真实 FB 昵称/头像,需另接 Overlay Views
+  // (XML 布局 + createOverlayView,本游戏未接;player 身份本身用 getSignedPlayerInfoAsync 已足够)。
   async getProfile() {
-    requireFB("auth.getProfile");
-    const name = FBInstant.player.getName();
-    const photo = FBInstant.player.getPhoto();
-    if (!name && !photo) return null;
-    return { nickname: name ?? "", avatarUrl: photo ?? "" };
+    if (!hasFB()) return null;
+    try {
+      const name = FBInstant.player.getName?.();
+      const photo = FBInstant.player.getPhoto?.();
+      if (!name && !photo) return null;
+      return { nickname: name ?? "", avatarUrl: photo ?? "" };
+    } catch {
+      return null;
+    }
+  }
+  // 身份(login)用 getSignedPlayerInfoAsync(player ID + signature),Zero Permissions 与普通模式
+  // 都可用、且是 Zero Permissions 的**默认身份**。FB 无 TikTok 那种"显式授权拿 user.info"的弹窗,
+  // authorize 直接复用 login(业务「首次进排行榜引导授权」逻辑跨平台通用,FB 下等价于静默拿 player ID)。
+  authorize(_scope) {
+    return this.login();
   }
 };
 var FacebookAds = class {
@@ -144,6 +161,37 @@ var FacebookAds = class {
     }
   }
 };
+var FacebookShortcut = class {
+  check() {
+    if (!hasFB() || typeof FBInstant.canCreateShortcutAsync !== "function") {
+      return Promise.resolve(false);
+    }
+    try {
+      return FBInstant.canCreateShortcutAsync().then(
+        (ok) => !!ok,
+        () => false
+      );
+    } catch {
+      return Promise.resolve(false);
+    }
+  }
+  add() {
+    if (!hasFB() || typeof FBInstant.createShortcutAsync !== "function") {
+      return Promise.resolve(false);
+    }
+    try {
+      return FBInstant.createShortcutAsync().then(
+        () => true,
+        () => false
+      );
+    } catch {
+      return Promise.resolve(false);
+    }
+  }
+  getMissionReward() {
+    return Promise.resolve({ canReceive: false });
+  }
+};
 var FacebookPayment = class {
   async purchase(productId, extra) {
     requireFB("payment.purchase");
@@ -222,8 +270,12 @@ var FacebookPlatform = class extends BasePlatform {
     __publicField(this, "storage", this.fbStorage);
     __publicField(this, "auth", new FacebookAuth());
     __publicField(this, "ads", new FacebookAds());
+    // payment 在 iOS 宿主下由 init() 撤下(Apple 审核指南 4.7 禁止 iOS 展示任何支付/内购功能),故非 readonly。
     __publicField(this, "payment", new FacebookPayment());
     __publicField(this, "device", new FacebookDevice());
+    __publicField(this, "shortcut", new FacebookShortcut());
+    // mission 不实现(FB 无"侧边栏入口任务"概念,TikTok 特有);保持 undefined,
+    // 业务层 App.platform.mission?.startEntrance() 会安全跳过。
     __publicField(this, "lifecycle", new FacebookLifecycle(
       () => this.getLaunchOptions()
     ));
@@ -235,6 +287,12 @@ var FacebookPlatform = class extends BasePlatform {
       await FBInstant.initializeAsync();
       FBInstant.setLoadingProgress(100);
       await FBInstant.startGameAsync();
+      try {
+        if (FBInstant.getPlatform?.() === "IOS") {
+          this.payment = void 0;
+        }
+      } catch {
+      }
       try {
         this._system = { ...this._system, language: FBInstant.getLocale() };
       } catch {

package/dist/platform/tiktok.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
-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';
+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-CxYJ9uz0.js';
+import { B as BasePlatform } from '../BasePlatform-DqIfl-Oi.js';
 /**
  * TikTok Mini Games(Minis)平台适配器。

package/dist/platform/tiktok.js CHANGED Viewed

@@ -1,5 +1,5 @@
-import { BasePlatform } from '../chunk-PDESBWLX.js';
 import { PlatformUnsupportedError } from '../chunk-II3JM4R3.js';
+import { BasePlatform } from '../chunk-NFEHUFN7.js';
 import { __publicField } from '../chunk-PKBMQBKP.js';
 // src/platform/impl/tiktok/TikTokPlatform.ts
@@ -57,29 +57,66 @@ var TikTokAuth = class {
   async getProfile() {
     return null;
   }
+  // 显式授权(game.authorize):弹 TikTok 授权页拿带 scope 的 code,后端换 token 后调 /v2/user/info/
+  // 取 nickname/avatar。callback 式,包成 Promise + 10s 超时(同 login,防永久 pending)。
+  authorize(scope = "user.info.basic") {
+    requireTT("auth.authorize");
+    return new Promise((resolve, reject) => {
+      let settled = false;
+      const timer = setTimeout(() => {
+        if (settled) return;
+        settled = true;
+        reject(new Error("TikTok authorize timeout"));
+      }, 1e4);
+      const finish = (fn) => {
+        if (settled) return;
+        settled = true;
+        clearTimeout(timer);
+        fn();
+      };
+      try {
+        TTMinis.game.authorize({
+          scope,
+          success: (res) => {
+            const code = res?.code ?? res?.authResponse?.code ?? "";
+            finish(() => code ? resolve({ code, raw: res }) : reject(new Error("authorize: no code")));
+          },
+          fail: (err) => finish(() => reject(new Error(`TikTok authorize fail: ${err?.errMsg ?? JSON.stringify(err)}`)))
+        });
+      } catch (e) {
+        finish(() => reject(e));
+      }
+    });
+  }
 };
 var TikTokAds = class {
-  // 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) {
+  constructor() {
+    // TikTok H5 SDK 激励视频:createRewardedVideoAd 返回**单例**广告对象,适配器缓存复用。
+    // 反编译 connect.tiktok-minis.com/game/sdk.js(2026-06-02,广告类 `Rn`)确认:ad 对象**确有**
+    // show/onClose/onError/offClose;**当前版本无** load/onLoad/destroy —— create 后广告自动拉取,
+    // show() 内部先 await SDK 自身加载 Promise 再展示。故本适配器对 load/onLoad 用**可选调用**
+    // (`ad.load?.()` / `ad.onLoad?.()`),缺失时 ensureLoaded 乐观置就绪并直接 show(由 show 内部等加载);
+    // 真机若为更高版本带 load/onLoad,则走预加载快路径。两种情况都正确,绝不调用不存在的方法。
+    //
+    // ⚠ 历史 bug(导致"广告请求多、曝光低"):旧实现每次 showRewarded 都 createRewardedVideoAd
+    //   新建实例并**立刻 show**(广告尚未加载完)。每次 create 触发一次广告请求,但 show 在未就绪时
+    //   失败 → 请求计数 +1、曝光计数 +0,且重复建实例放大请求量。
+    //   修复:单例缓存 + 一次性绑定回调 + 先 load 再 show(show 失败重试一次 load→show)。
+    /** 单例广告实例(按首个 adUnitId 创建,后续复用);创建失败时为 undefined 并允许下次重建 */
+    __publicField(this, "adPromise");
+    /** 当前 show 调用的结果回调;激励视频为模态,同一时刻只有一个 */
+    __publicField(this, "pendingShow");
+    /** 广告是否已加载就绪;show(消耗)或出错后置 false,需重新 load */
+    __publicField(this, "loaded", false);
   }
-  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");
-      };
+  /** 取/建单例广告实例,并**一次性**绑定 onLoad/onClose/onError(复用不重复绑定) */
+  getAd(adUnitId) {
+    if (this.adPromise) return this.adPromise;
+    this.adPromise = new Promise((resolve) => {
       try {
         const adSync = TTMinis.game.createRewardedVideoAd({ adUnitId });
         if (adSync && typeof adSync.show === "function") {
-          this.wireAd(adSync, onResult, onError);
+          resolve(this.wireOnce(adSync));
           return;
         }
       } catch (e) {
@@ -87,43 +124,94 @@ var TikTokAds = class {
       }
       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"));
-          }
+          if (res?.is_success && res.rewardedVideoAd) resolve(this.wireOnce(res.rewardedVideoAd));
+          else resolve(void 0);
         }, { adUnitId });
       } catch (e) {
-        onError(e?.message ?? "createRewardedVideoAd both signatures failed");
+        console.warn("[ads] async createRewardedVideoAd failed:", e?.message);
+        resolve(void 0);
       }
     });
+    return this.adPromise;
   }
-  wireAd(ad, onResult, onError) {
-    let settled = false;
+  /** 一次性绑定生命周期回调:onLoad 标记就绪;onClose/onError 结算当前 pendingShow */
+  wireOnce(ad) {
+    try {
+      ad.onLoad?.(() => {
+        this.loaded = true;
+      });
+    } catch {
+    }
     try {
       ad.onClose((res) => {
-        if (settled) return;
-        settled = true;
-        onResult(!!res?.isEnded);
+        this.loaded = false;
+        this.settle(res?.isEnded ? "completed" : "skipped");
       });
     } catch (e) {
-      onError(`onClose unsupported: ${e?.message}`);
+      console.warn("[ads] onClose unsupported:", e?.message);
+    }
+    try {
+      ad.onError?.((res) => {
+        this.loaded = false;
+        console.warn("[ads.showRewarded] error:", res?.error?.error_msg);
+        this.settle("failed");
+      });
+    } catch {
+    }
+    return ad;
+  }
+  /** 结算当前 show 的结果(只结算挂起的那一次) */
+  settle(r) {
+    const resolve = this.pendingShow;
+    this.pendingShow = void 0;
+    resolve?.(r);
+  }
+  /** 确保广告已加载:已就绪直接返回,否则 load() 等待(老 SDK 无 load 则乐观置就绪) */
+  async ensureLoaded(ad) {
+    if (this.loaded) return;
+    if (typeof ad.load === "function") await ad.load();
+    this.loaded = true;
+  }
+  /** 预加载:创建单例 + 拉一条广告,使后续 show 即时展示(降低请求/曝光错配) */
+  async preloadRewarded(adUnitId) {
+    if (!hasTT()) return;
+    const ad = await this.getAd(adUnitId);
+    if (!ad) {
+      this.adPromise = void 0;
       return;
     }
-    if (typeof ad.onError === "function") {
-      try {
-        ad.onError((res) => {
-          if (settled) return;
-          settled = true;
-          onError(res?.error?.error_msg ?? "ad error");
-        });
-      } catch {
-      }
+    try {
+      await this.ensureLoaded(ad);
+    } catch (e) {
+      console.warn("[ads.preloadRewarded] load failed:", e?.message);
     }
-    void ad.show().catch((e) => {
-      if (settled) return;
-      settled = true;
-      onError(e?.message ?? "show rejected");
+  }
+  showRewarded(adUnitId) {
+    requireTT("ads.showRewarded");
+    return new Promise((resolve) => {
+      this.pendingShow = resolve;
+      void (async () => {
+        const ad = await this.getAd(adUnitId);
+        if (!ad) {
+          this.adPromise = void 0;
+          this.settle("failed");
+          return;
+        }
+        try {
+          await this.ensureLoaded(ad);
+          await ad.show();
+        } catch (e) {
+          console.warn("[ads.showRewarded] show failed, retry after load:", e?.message);
+          this.loaded = false;
+          try {
+            await this.ensureLoaded(ad);
+            await ad.show();
+          } catch (e2) {
+            console.warn("[ads.showRewarded] show failed after reload:", e2?.message);
+            this.settle("failed");
+          }
+        }
+      })();
     });
   }
   // 插页广告:官方文档 createInterstitialAd 自 SDK 0.3.0;当前反编译版 sdk.js 未见此 API,
@@ -276,7 +364,12 @@ var TikTokPayment = class {
           fail: (err) => {
             if (settled) return;
             settled = true;
-            reject(new Error(`TikTok pay failed: ${err?.errMsg ?? "unknown"}`));
+            const e = err;
+            const code = e?.error?.error_code;
+            const msg = e?.error?.error_msg ?? e?.errMsg ?? "unknown";
+            const wrapped = new Error(`TikTok pay failed${code !== void 0 ? ` (code=${code})` : ""}: ${msg}`);
+            wrapped.cause = err;
+            reject(wrapped);
           }
         });
       } catch (e) {
@@ -311,15 +404,14 @@ var TikTokDevice = class {
     } catch {
     }
   }
-  async setClipboard(text) {
-    requireTT("device.setClipboard");
-    await TTMinis.game.setClipboardData({ data: text });
-  }
-  async getClipboard() {
-    requireTT("device.getClipboard");
-    const res = await TTMinis.game.getClipboardData();
-    return res?.data ?? "";
-  }
+  // 剪贴板:TikTok Minis 下**无任何可用实现**,故 setClipboard/getClipboard 不提供(IPlatformDevice
+  // 两者均为可选,业务侧 device.setClipboard?.() 会安全跳过)。依据(反编译 connect.tiktok-minis.com/game/sdk.js
+  // 2026-06-02):
+  //   1. TTMinis.game 上**不存在** setClipboardData/getClipboardData(这是臆造的方法名;SDK 的
+  //      copyToClipboard/fetchClipBoard 属直播宿主 JSB,不在 minigame game API 暴露,也无 game 方法);
+  //   2. navigator.clipboard.read/readText/write/writeText 被 SDK 主动禁用(替换为 console.error 桩),
+  //      故浏览器退路也走不通。
+  // 结论:TikTok 真无剪贴板能力 → 如实不实现,而非调用不存在的方法在运行时抛 TypeError。
   // shareAppMessage 是 callback 式(2026-05-30 反编译核对),不是 Promise;这里包成 Promise。
   share(payload) {
     requireTT("device.share");

package/dist/platform/web.d.ts CHANGED Viewed

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

package/dist/platform/web.js CHANGED Viewed

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

package/dist/platform/wechat.d.ts CHANGED Viewed

@@ -1,4 +1,4 @@
-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';
+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-CxYJ9uz0.js';
 /**
  * 微信小游戏平台适配器。

package/dist/platform/youtube.d.ts ADDED Viewed

@@ -0,0 +1,71 @@
+import { r as PlatformName, o as IPlatformStorage, g as IPlatformAuth, e as IPlatformAds, h as IPlatformDevice, i as IPlatformLifecycle } from '../types-CxYJ9uz0.js';
+import { B as BasePlatform } from '../BasePlatform-DqIfl-Oi.js';
+/**
+ * YouTube Playables 平台适配器。
+ *
+ * 运行环境:YouTube Playables(YouTube 内嵌的 HTML5 小游戏沙箱),全局对象 `ytgame.*`。
+ * SDK 由外壳 index.html 的 <script src="https://www.youtube.com/game_api/v1"> 注入(页面第一个脚本)。
+ *
+ * API 来源(2026-06-01 拉取核对,代码内各处标注):
+ *  - 官方 SDK reference:https://developers.google.com/youtube/gaming/playables/reference/sdk
+ *  - 官方 getting_started:https://developers.google.com/youtube/gaming/playables/reference/getting_started
+ *  - Phaser 官方模板:https://github.com/phaserjs/template-youtube-playables(src/YouTubePlayables.js)
+ *
+ * 能力实现:
+ * - hasDOM=true(Playables 跑在 webview),isMiniGame=true
+ * - net:fetch + 标准 WebSocket(继承 BasePlatform)
+ * - storage:ytgame.game.saveData/loadData 是「整份序列化 string」存档(非 per-key KV),
+ *           IPlatformStorage 是同步 KV → 采用「内存缓存 + 异步整份回写」:init 时 loadData 预拉
+ *           解析成 Map,getItem 读缓存,setItem 写缓存并去抖异步 saveData 整份。
+ * - auth:YouTube **不暴露用户身份/openId**,也无可换 token 的 OAuth code。存档由 YouTube 内部
+ *         按已登录用户隔离。login 返回一个**本地持久化的匿名 id**(存进 storage),并把它当 code/openId,
+ *         供业务排行榜「本机身份」使用;getProfile 返 null(拿不到昵称/头像);authorize 不实现(undefined)。
+ * - ads:ytgame.ads.requestRewardedAd(rewardId) → 'completed'/'skipped';requestInterstitialAd() → 'closed'/'failed'。
+ * - payment:**不实现**(undefined)。YouTube Playables 禁止任何内购(含 off-platform),
+ *           业务层 App.payment 为 undefined 自动降级。
+ * - device.share:YouTube Playables SDK 无分享 API → share 不实现(undefined);震动/剪贴板退回浏览器。
+ * - lifecycle:ytgame.system.onPause/onResume;非 Playables 环境退回 DOM visibilitychange。
+ * - shortcut / mission:YouTube 无对应能力 → 不实现(undefined)。
+ * - 排行榜:ytgame.engagement.sendScore({value}) 作为平台特有能力暴露 sendScore(score)(见类末尾)。
+ *
+ * init 时序(官方:SDK ready → firstFrameReady → ... → gameReady):
+ *   读 DOM 系统信息 → firstFrameReady() → getLanguage 覆盖语言 → 预拉存档 → 同步音频状态 → gameReady()。
+ * setLoadingProgress(p):YouTube **无** setLoadingProgress API,映射为「首次 >0 触发 firstFrameReady,
+ *   到 1 触发 gameReady」,保持与其它平台一致的对外接口。
+ *
+ * 所有 ytgame 访问均 typeof 检测 + try-catch:非 YouTube 环境(typeof ytgame === 'undefined')安全降级,不崩。
+ */
+declare class YouTubePlatform extends BasePlatform {
+    readonly platformName: PlatformName;
+    readonly isMiniGame = true;
+    private readonly ytStorage;
+    /** firstFrameReady / gameReady 仅可调用一次的幂等守卫 */
+    private _firstFrameReady;
+    private _gameReady;
+    readonly storage: IPlatformStorage;
+    readonly auth: IPlatformAuth;
+    readonly ads: IPlatformAds;
+    readonly device: IPlatformDevice;
+    readonly lifecycle: IPlatformLifecycle;
+    init(): Promise<void>;
+    /**
+     * 加载进度上报。YouTube **无** setLoadingProgress API:
+     * 这里把对外接口映射为「首次 progress>0 触发 firstFrameReady,progress≥1 触发 gameReady」,
+     * 让业务加载场景的进度回调在 YouTube 上也能正确驱动 firstFrameReady/gameReady 时序。
+     * @param progress 0..1 的小数
+     */
+    setLoadingProgress(progress: number): void;
+    /**
+     * 上报排行榜分数(YouTube 平台特有能力,framework 无通用 score 接口)。
+     * 业务可经 (App.platform as YouTubePlatform).sendScore(n) 调用。
+     * ytgame.engagement.sendScore({value}):value 须为整数且 ≤ Number.MAX_SAFE_INTEGER,否则被拒。
+     * 文档:https://developers.google.com/youtube/gaming/playables/reference/sdk#sendscore
+     */
+    sendScore(value: number): Promise<boolean>;
+    private callFirstFrameReady;
+    private callGameReady;
+}
+export { YouTubePlatform };