@playcraft/cli 0.0.53 → 0.0.56

package/project-templates/playable-template-phaser/src/Game.ts

@@ -0,0 +1,154 @@
+import * as Phaser from 'phaser';
+import { PreloadScene } from './scenes/PreloadScene';
+import { MainScene } from './scenes/MainScene';
+
+// 设计基准宽度（横屏设计）
+const DESIGN_WIDTH = 1280;
+
+/**
+ * Phaser Game 包装器
+ * 
+ * 负责：
+ * - Phaser 游戏实例的创建与销毁
+ * - 场景注册
+ * - 响应式适配
+ * - 横竖屏切换时销毁重建（不使用 location.reload）
+ * - SDK 生命周期回调
+ */
+export class Game {
+  // 当前 Phaser 游戏实例
+  private game!: Phaser.Game;
+  // 记录当前屏幕方向
+  private currentIsLandscape: boolean;
+  // 当前尺寸
+  private currentWidth: number;
+  private currentHeight: number;
+  // 是否正在重建
+  private isRebuilding: boolean = false;
+
+  constructor(width: number, height: number) {
+    this.currentWidth = width;
+    this.currentHeight = height;
+    this.currentIsLandscape = width > height;
+    
+    this.createGame(width, height);
+  }
+
+  /**
+   * 创建 Phaser 游戏实例
+   */
+  private createGame(width: number, height: number): void {
+    const gameWidth = DESIGN_WIDTH;
+    const gameHeight = height * (DESIGN_WIDTH / width);
+
+    this.game = new Phaser.Game({
+      type: Phaser.AUTO,
+      width: gameWidth,
+      height: gameHeight,
+      backgroundColor: '#1c1c1c',
+      parent: document.body,
+      scale: {
+        mode: Phaser.Scale.WIDTH_CONTROLS_HEIGHT,
+        autoCenter: Phaser.Scale.CENTER_BOTH
+      },
+      render: {
+        antialias: true,
+        antialiasGL: true,
+        pixelArt: false,
+      },
+      scene: [PreloadScene, MainScene]
+    });
+  }
+
+  /**
+   * 响应容器尺寸变化
+   * 横竖屏切换时：销毁旧游戏实例，重建新实例
+   * 同方向尺寸变化时：仅 resize
+   */
+  public resize(width: number, height: number): void {
+    const newIsLandscape = width > height;
+    
+    this.currentWidth = width;
+    this.currentHeight = height;
+    
+    // 横竖屏切换：销毁重建
+    if (newIsLandscape !== this.currentIsLandscape) {
+      console.log('Screen orientation changed:',
+        this.currentIsLandscape ? 'landscape→portrait' : 'portrait→landscape');
+      this.currentIsLandscape = newIsLandscape;
+      
+      this.rebuildGame(width, height);
+      return;
+    }
+    
+    // 方向不变时，只调整画布尺寸
+    // 防御性检查：如果游戏正在重建，跳过 resize
+    if (!this.game || this.isRebuilding) {
+      console.warn('Game not ready for resize, skipping');
+      return;
+    }
+    
+    const gameHeight = height * (DESIGN_WIDTH / width);
+    this.game.scale.resize(DESIGN_WIDTH, gameHeight);
+    console.log('Game resized to:', DESIGN_WIDTH, gameHeight);
+  }
+
+  /**
+   * 销毁旧游戏实例并重建新实例
+   */
+  private rebuildGame(width: number, height: number): void {
+    if (this.isRebuilding) {
+      console.warn('Already rebuilding, skip');
+      return;
+    }
+    this.isRebuilding = true;
+    
+    console.log('Rebuilding game for new orientation...');
+    
+    // 销毁旧实例（true = 移除 canvas）
+    try {
+      this.game.destroy(true);
+    } catch (e) {
+      console.warn('Error destroying old game:', e);
+    }
+    
+    // 短暂延迟确保旧 WebGL 上下文完全释放
+    setTimeout(() => {
+      try {
+        this.createGame(width, height);
+        console.log('Game rebuilt successfully for:', width, height);
+      } catch (e) {
+        console.error('Error rebuilding game:', e);
+      }
+      this.isRebuilding = false;
+    }, 100);
+  }
+
+  public pause(): void {
+    if (this.isRebuilding) return;
+    this.game.scene.pause('MainScene');
+    console.log('Game paused');
+  }
+
+  public resume(): void {
+    if (this.isRebuilding) return;
+    this.game.scene.resume('MainScene');
+    console.log('Game resumed');
+  }
+
+  public volume(value: number): void {
+    if (this.isRebuilding) return;
+    this.game.sound.setVolume(value);
+    console.log(`Volume changed to: ${value}`);
+  }
+
+  public finish(): void {
+    if (this.isRebuilding) return;
+    // 游戏结束时清理 AudioManager
+    const mainScene = this.game.scene.getScene('MainScene') as MainScene;
+    if (mainScene && mainScene.audioManager) {
+      mainScene.audioManager.setGameEnded(true);
+    }
+    console.log('Game finished');
+  }
+}

package/project-templates/playable-template-phaser/src/config/LoadingConfig.ts

@@ -0,0 +1,40 @@
+/**
+ * Loading 页面配置
+ * 通过 sdk.getConfig() 动态获取配置
+ */
+import { sdk } from '@playcraft/adsdk';
+
+// 辅助函数：安全获取嵌套配置值
+function get<T>(path: string, fallback: T): T {
+  const config = sdk.getConfig();
+  const keys = path.split('.');
+  let value: any = config;
+  for (const key of keys) {
+    if (value === undefined || value === null) return fallback;
+    value = value[key];
+  }
+  return value !== undefined ? value : fallback;
+}
+
+// ⚠️ 使用 getter 延迟获取，避免模块顶层缓存问题
+export const LoadingConfig = {
+  // ========== 资源配置 ==========
+  get LOGO_IMAGE(): string { return get('loading.logoImage', ''); },
+
+  // ========== 文案配置 ==========
+  get APP_TITLE(): string { return get('loading.appTitle', 'Sola Mahjong'); },
+  get APP_STARS(): string { return get('loading.appStars', '★★★★★'); },
+  get APP_DESC(): string { return get('loading.appDesc', 'Sola Mahjong: Classic Tile\nPairing for a Relaxing Puzzle'); },
+  get LOADING_TEXT(): string { return get('loading.loadingText', 'Loading Playable Ads'); },
+  GAMEPAD_ICON: '🎮',
+
+  // ========== 时间配置 ==========
+  get SCENE_DURATION(): number { return get('loading.sceneDuration', 100); },
+  DOT_ANIM_DELAY: 200,
+  
+  // ========== 跳跃动画配置 ==========
+  BOUNCE_HEIGHT_LANDSCAPE: 8,
+  BOUNCE_HEIGHT_PORTRAIT: 10,
+  BOUNCE_DURATION: 300,
+  BOUNCE_REPEAT_DELAY: 100,
+};

package/project-templates/playable-template-phaser/src/config/ThemeConfig.ts

@@ -0,0 +1,81 @@
+/**
+ * 主题配置接口
+ * 
+ * 通过 sdk.getConfig() 动态获取配置
+ * 配置来源：theme.schema.json5（默认值）+ theme.data.json5（覆盖值）
+ */
+import { sdk } from '@playcraft/adsdk';
+
+// 辅助函数：安全获取嵌套配置值
+function get<T>(path: string, fallback: T): T {
+  const config = sdk.getConfig();
+  const keys = path.split('.');
+  let value: any = config;
+  for (const key of keys) {
+    if (value === undefined || value === null) return fallback;
+    value = value[key];
+  }
+  return value !== undefined ? value : fallback;
+}
+
+export interface ThemeConfig {
+  // 基础信息
+  name: string;
+  id: string;
+  
+  // 视觉配置
+  backgroundColor: number;
+  primaryColor: number;
+  secondaryColor: number;
+  textColor: string;
+  
+  // 字体配置
+  fontSize: {
+    title: string;
+    body: string;
+    button: string;
+  };
+  
+  // 游戏参数
+  difficulty?: number;
+  enableHints?: boolean;
+  
+  // 资源配置
+  assets?: {
+    buttonImage?: string;
+    backgroundImage?: string;
+    logoImage?: string;
+  };
+}
+
+// 主题配置获取器（使用 getter 延迟获取，避免模块顶层缓存问题）
+export const GameThemeConfig = {
+  // ========== 基础信息 ==========
+  get NAME(): string { return get('name', 'Default Theme'); },
+  get ID(): string { return get('id', 'default'); },
+
+  // ========== 视觉配置 ==========
+  get BACKGROUND_COLOR(): number { return get('visual.backgroundColor', 0xf7d37f); },
+  get PRIMARY_COLOR(): number { return get('visual.primaryColor', 0x4a90e2); },
+  get SECONDARY_COLOR(): number { return get('visual.secondaryColor', 0x3498db); },
+  get TEXT_COLOR(): string { return get('visual.textColor', '#ffffff'); },
+
+  // ========== 字体配置 ==========
+  get FONT_SIZE_TITLE(): string { return get('fontSize.title', '48px'); },
+  get FONT_SIZE_BODY(): string { return get('fontSize.body', '24px'); },
+  get FONT_SIZE_BUTTON(): string { return get('fontSize.button', '32px'); },
+
+  // ========== 游戏参数 ==========
+  get DIFFICULTY(): number { return get('gameplay.difficulty', 5); },
+  get ENABLE_HINTS(): boolean { return get('gameplay.enableHints', true); },
+
+  // ========== 资源配置 ==========
+  get ASSET_LOGO(): string { return get('assets.logo', ''); },
+  get ASSET_BUTTON(): string { return get('assets.buttonImage', ''); },
+  get ASSET_BACKGROUND(): string { return get('assets.backgroundImage', ''); },
+
+  // ========== 获取当前渠道 ==========
+  get CURRENT_CHANNEL(): string {
+    return typeof AD_NETWORK !== 'undefined' ? AD_NETWORK : 'preview';
+  },
+};

package/project-templates/playable-template-phaser/src/index.css

@@ -0,0 +1,18 @@
+body,
+html {
+  margin: 0;
+  padding: 0;
+}
+html {
+  background-color: #fff;
+  overflow: hidden;
+  width: 100%;
+  height: 100%;
+}
+body {
+  height: inherit;
+  width: inherit;
+}
+* {
+  -webkit-tap-highlight-color: transparent;
+}

package/project-templates/playable-template-phaser/src/index.html

@@ -0,0 +1,9 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <title>Phaser Playable Template</title>
+  </head>
+  <body>
+  </body>
+</html>

package/project-templates/playable-template-phaser/src/index.ts

@@ -0,0 +1,30 @@
+import { Game } from './Game';
+import './index.css';
+import { sdk } from '@playcraft/adsdk';
+
+// 主题系统
+import ThemeConfig from './theme/theme.schema.json5';
+import Theme from './theme';
+
+// ⚠️ 重要：setConfig 必须在 playcraftInit 之前调用
+// SDK 会合并 schema 默认值 + themeData 覆盖值，并通过 assetRecordByPath 解析路径
+sdk.setConfig([ThemeConfig, Theme.themeData], {
+  assetRecordByPath: Theme.assetRecordByPath,
+});
+
+// Initialize the SDK
+sdk.playcraftInit((width: number, height: number) => {
+  // Initialize game with container dimensions
+  const game = new Game(width, height);
+
+  // Set up all event listeners
+  sdk.on('playcraftResize', game.resize, game);
+  sdk.on('playcraftPause', game.pause, game);
+  sdk.on('playcraftResume', game.resume, game);
+  sdk.on('playcraftVolume', game.volume, game);
+  sdk.on('playcraftFinish', game.finish, game);
+});
+
+if (__DEV__) {
+  console.log('Development mode');
+}

package/project-templates/playable-template-phaser/src/json5.d.ts

@@ -0,0 +1,4 @@
+declare module '*.json5' {
+  const value: any;
+  export default value;
+}