@maoyugames/phaser-framework 1.0.16 → 1.0.25

package/dist/platform/youtube.js

@@ -0,0 +1,310 @@
+import { BasePlatform, LocalStorageAdapter, DomLifecycle } from '../chunk-NFEHUFN7.js';
+import { __publicField } from '../chunk-PKBMQBKP.js';
+
+// src/platform/impl/youtube/YouTubePlatform.ts
+function hasYT() {
+  return typeof ytgame !== "undefined" && !!ytgame;
+}
+function inPlayablesEnv() {
+  try {
+    return hasYT() && ytgame.IN_PLAYABLES_ENV === true;
+  } catch {
+    return false;
+  }
+}
+var YouTubeStorage = class {
+  constructor() {
+    /** 内存缓存:key -> value(string) */
+    __publicField(this, "cache", /* @__PURE__ */ new Map());
+    /** 是否已预拉(未 hydrate 前 getItem 返回缓存现状,通常为空) */
+    __publicField(this, "hydrated", false);
+    __publicField(this, "flushTimer");
+    /** 非 Playables 环境的本地存储退路 */
+    __publicField(this, "fallback", new LocalStorageAdapter());
+  }
+  /** init 阶段调用:整份预拉存档到内存 */
+  async hydrate() {
+    if (!inPlayablesEnv()) {
+      this.hydrated = true;
+      return;
+    }
+    try {
+      const raw = await ytgame.game.loadData();
+      if (raw && typeof raw === "string") {
+        const obj = JSON.parse(raw);
+        if (obj && typeof obj === "object") {
+          for (const [k, v] of Object.entries(obj)) this.cache.set(k, String(v));
+        }
+      }
+    } catch {
+    }
+    this.hydrated = true;
+  }
+  getItem(key) {
+    if (!inPlayablesEnv()) return this.fallback.getItem(key);
+    const v = this.cache.get(key);
+    return v === void 0 ? null : v;
+  }
+  setItem(key, value) {
+    if (!inPlayablesEnv()) {
+      this.fallback.setItem(key, value);
+      return;
+    }
+    this.cache.set(key, value);
+    this.scheduleFlush();
+  }
+  removeItem(key) {
+    if (!inPlayablesEnv()) {
+      this.fallback.removeItem(key);
+      return;
+    }
+    this.cache.delete(key);
+    this.scheduleFlush();
+  }
+  clear() {
+    if (!inPlayablesEnv()) {
+      this.fallback.clear();
+      return;
+    }
+    this.cache.clear();
+    this.scheduleFlush();
+  }
+  /** 去抖:合并短时间内多次写,统一整份异步回写 YouTube 存档 */
+  scheduleFlush() {
+    if (this.flushTimer) clearTimeout(this.flushTimer);
+    this.flushTimer = setTimeout(() => void this.flush(), 300);
+  }
+  async flush() {
+    if (!inPlayablesEnv()) return;
+    const record = {};
+    for (const [k, v] of this.cache.entries()) record[k] = v;
+    try {
+      await ytgame.game.saveData(JSON.stringify(record));
+    } catch {
+      try {
+        ytgame.health?.logError?.();
+      } catch {
+      }
+    }
+  }
+};
+var _YouTubeAuth = class _YouTubeAuth {
+  constructor(storage) {
+    __publicField(this, "storage");
+    this.storage = storage;
+  }
+  async login() {
+    const id = this.ensureAnonId();
+    return { code: id, openId: id, raw: { anonymous: true, source: "youtube-local-anon" } };
+  }
+  // YouTube Playables SDK 无获取用户昵称/头像的 API(身份完全不暴露)→ 恒返 null,游客显示。
+  async getProfile() {
+    return null;
+  }
+  // authorize 不实现(YouTube 无显式授权弹窗 / 无 scope 概念);保持 undefined 由可选签名省略。
+  /** 读取或生成本地匿名 id(持久化到 storage,使其随 YouTube 存档跟随用户) */
+  ensureAnonId() {
+    let id = this.storage.getItem(_YouTubeAuth.ANON_ID_KEY);
+    if (!id) {
+      id = "yt_" + Math.random().toString(36).slice(2, 10) + Date.now().toString(36);
+      this.storage.setItem(_YouTubeAuth.ANON_ID_KEY, id);
+    }
+    return id;
+  }
+};
+__publicField(_YouTubeAuth, "ANON_ID_KEY", "__yt_anon_id__");
+var YouTubeAuth = _YouTubeAuth;
+var YouTubeAds = class {
+  // YouTube 无「预加载」概念(request 即触发);preloadRewarded 作空操作 resolve,保持接口一致。
+  async preloadRewarded(_adUnitId) {
+    return;
+  }
+  async showRewarded(adUnitId) {
+    if (!inPlayablesEnv() || typeof ytgame.ads?.requestRewardedAd !== "function") {
+      return "failed";
+    }
+    if (!adUnitId) {
+      return "failed";
+    }
+    try {
+      const earned = await ytgame.ads.requestRewardedAd(adUnitId);
+      return earned ? "completed" : "skipped";
+    } catch {
+      return "failed";
+    }
+  }
+  async showInterstitial(_adUnitId) {
+    if (!inPlayablesEnv() || typeof ytgame.ads?.requestInterstitialAd !== "function") {
+      return "failed";
+    }
+    try {
+      await ytgame.ads.requestInterstitialAd();
+      return "closed";
+    } catch {
+      return "failed";
+    }
+  }
+};
+var YouTubeDevice = class {
+  vibrateShort() {
+    try {
+      navigator.vibrate?.(15);
+    } catch {
+    }
+  }
+  vibrateLong() {
+    try {
+      navigator.vibrate?.(400);
+    } catch {
+    }
+  }
+  async setClipboard(text) {
+    try {
+      if (navigator.clipboard?.writeText) await navigator.clipboard.writeText(text);
+    } catch {
+    }
+  }
+  async getClipboard() {
+    try {
+      if (navigator.clipboard?.readText) return await navigator.clipboard.readText();
+    } catch {
+    }
+    return "";
+  }
+  // share 不实现(YouTube Playables 无分享 API);业务 device.share?.() 安全跳过。
+};
+var YouTubeLifecycle = class {
+  constructor(getLaunchOptions) {
+    __publicField(this, "domLifecycle");
+    __publicField(this, "getLaunchOptions");
+    this.getLaunchOptions = getLaunchOptions;
+    this.domLifecycle = new DomLifecycle(getLaunchOptions);
+  }
+  onShow(cb) {
+    if (inPlayablesEnv() && typeof ytgame.system?.onResume === "function") {
+      let unset;
+      try {
+        unset = ytgame.system.onResume(() => cb(this.getLaunchOptions()));
+      } catch {
+      }
+      const domOff = this.domLifecycle.onShow(cb);
+      return () => {
+        try {
+          unset?.();
+        } catch {
+        }
+        domOff();
+      };
+    }
+    return this.domLifecycle.onShow(cb);
+  }
+  onHide(cb) {
+    if (inPlayablesEnv() && typeof ytgame.system?.onPause === "function") {
+      let unset;
+      try {
+        unset = ytgame.system.onPause(() => cb());
+      } catch {
+      }
+      const domOff = this.domLifecycle.onHide(cb);
+      return () => {
+        try {
+          unset?.();
+        } catch {
+        }
+        domOff();
+      };
+    }
+    return this.domLifecycle.onHide(cb);
+  }
+};
+var YouTubePlatform = class extends BasePlatform {
+  constructor() {
+    super(...arguments);
+    __publicField(this, "platformName", "youtube");
+    __publicField(this, "isMiniGame", true);
+    __publicField(this, "ytStorage", new YouTubeStorage());
+    /** firstFrameReady / gameReady 仅可调用一次的幂等守卫 */
+    __publicField(this, "_firstFrameReady", false);
+    __publicField(this, "_gameReady", false);
+    __publicField(this, "storage", this.ytStorage);
+    __publicField(this, "auth", new YouTubeAuth(this.ytStorage));
+    __publicField(this, "ads", new YouTubeAds());
+    // payment 不实现(YouTube 禁内购);device.share 不实现(无分享 API)。
+    __publicField(this, "device", new YouTubeDevice());
+    // shortcut / mission 不实现(YouTube 无对应能力)。
+    __publicField(this, "lifecycle", new YouTubeLifecycle(
+      () => this.getLaunchOptions()
+    ));
+  }
+  async init() {
+    this.readDomSystemInfo();
+    this.readDomLaunchOptions();
+    if (!inPlayablesEnv()) {
+      await this.ytStorage.hydrate();
+      return;
+    }
+    this.callFirstFrameReady();
+    try {
+      const lang = await ytgame.system.getLanguage();
+      if (lang) this._system = { ...this._system, language: lang };
+    } catch {
+    }
+    await this.ytStorage.hydrate();
+    try {
+      ytgame.system.isAudioEnabled();
+    } catch {
+    }
+    this.callGameReady();
+  }
+  /**
+   * 加载进度上报。YouTube **无** setLoadingProgress API:
+   * 这里把对外接口映射为「首次 progress>0 触发 firstFrameReady,progress≥1 触发 gameReady」,
+   * 让业务加载场景的进度回调在 YouTube 上也能正确驱动 firstFrameReady/gameReady 时序。
+   * @param progress 0..1 的小数
+   */
+  setLoadingProgress(progress) {
+    if (!inPlayablesEnv()) return;
+    if (progress > 0) this.callFirstFrameReady();
+    if (progress >= 1) this.callGameReady();
+  }
+  /**
+   * 上报排行榜分数(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
+   */
+  async sendScore(value) {
+    if (!inPlayablesEnv() || typeof ytgame.engagement?.sendScore !== "function") return false;
+    const v = Math.floor(value);
+    if (!Number.isSafeInteger(v)) return false;
+    try {
+      await ytgame.engagement.sendScore({ value: v });
+      return true;
+    } catch {
+      try {
+        ytgame.health?.logError?.();
+      } catch {
+      }
+      return false;
+    }
+  }
+  callFirstFrameReady() {
+    if (this._firstFrameReady) return;
+    try {
+      ytgame.game.firstFrameReady();
+      this._firstFrameReady = true;
+    } catch {
+    }
+  }
+  callGameReady() {
+    if (this._gameReady) return;
+    if (!this._firstFrameReady) this.callFirstFrameReady();
+    try {
+      ytgame.game.gameReady();
+      this._gameReady = true;
+    } catch {
+    }
+  }
+};
+
+export { YouTubePlatform };

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

@@ -68,7 +68,7 @@ declare enum LogLevel {
  */
 
 /** 受支持的平台名 */
-type PlatformName = 'web' | 'tiktok' | 'wechat' | 'facebook' | 'capacitor';
+type PlatformName = 'web' | 'tiktok' | 'wechat' | 'facebook' | 'capacitor' | 'youtube';
 /** 平台静态信息 */
 interface PlatformInfo {
     /** 平台名 */
@@ -169,6 +169,11 @@ interface IPlatformAuth {
         nickname: string;
         avatarUrl: string;
     } | null>;
+    /**
+     * 显式授权(弹授权页),返回带额外 scope 的 code,后端换 token 后可拿 nickname/avatar。
+     * 平台不支持时为 undefined。用于「按需引导用户授权显示昵称」(如首次进排行榜)。
+     */
+    authorize?(scope?: string): Promise<LoginResult>;
 }
 /** 广告 */
 type AdResult = 'completed' | 'skipped' | 'failed' | 'closed';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maoyugames/phaser-framework",
-  "version": "1.0.16",
+  "version": "1.0.25",
   "description": "多平台 Phaser 游戏框架:业务/底层分离,HTTP/WebSocket/KCP,Web/TikTok/微信/Facebook/App 隔离打包",
   "type": "module",
   "license": "MIT",
@@ -36,6 +36,10 @@
       "types": "./dist/platform/capacitor.d.ts",
       "import": "./dist/platform/capacitor.js"
     },
+    "./platform/youtube": {
+      "types": "./dist/platform/youtube.d.ts",
+      "import": "./dist/platform/youtube.js"
+    },
     "./cli": "./dist/cli/index.js",
     "./global": {
       "types": "./global.d.ts"