游戏引擎 / 系统课时

用 Scale Manager 缩放画面

用 Scale Manager 缩放画面

本篇为固定设计分辨率的 Phaser 4 游戏设置自适应缩放,避免浏览器窗口变化时画面被拉伸、裁切或 HUD 跑偏。完成后,你将运行一个 16:9 演示场景,并用桌面、横屏和竖屏尺寸验收比例、留白与界面定位。

学习目标

  • 区分 FIT、ENVELOP 与 RESIZE 对画面和逻辑尺寸的影响。
  • 配置 Scale Manager 的设计尺寸、缩放模式与居中方式。
  • 在不同窗口比例下检查游戏边界、留白和 HUD 位置。

选择设计分辨率与缩放策略

先将游戏的逻辑尺寸定为 960 × 540(16:9)。Phaser.Scale.FIT 根据父容器的宽高等比缩放 Canvas;逻辑坐标仍为 960 × 540,因此右上角的 HUD 可以始终使用 (936, 24),而不必根据浏览器宽度重算。

模式 窗口变化时的行为 适用情况
Phaser.Scale.FIT 保持比例,必要时在父容器内留白 固定镜头构图的关卡、HUD
Phaser.Scale.ENVELOP 保持比例并铺满容器,边缘可能超出可视范围 允许裁切的背景画面
Phaser.Scale.RESIZE 将游戏 Canvas 调整到父容器大小,逻辑可视范围随之变化 需要按窗口重新排版的游戏
Phaser.Scale.NONE 不自动缩放 完全自行管理画布尺寸

例如父容器为 1200 × 800 时,FIT 的缩放系数是 min(1200/960, 800/540) = 1.25,最终 Canvas 显示为 1200 × 675,上下各留 62.5 CSS 像素。留白来自页面父容器的背景,不是游戏世界被截掉。

FIT 与 RESIZE 在相同窗口中的显示区域对比

配置并运行自适应场景

下面的单文件示例适用于 Phaser 4.2.1。将内容保存为 index.html,使用浏览器打开;演示只绘制几何形状和文字,不需要外部图集。#game 必须有可计算的高度,否则 Scale Manager 无法正确取得父容器尺寸。

html
<!doctype html>
<html lang='zh-CN'>
<head>
  <meta charset='UTF-8'>
  <meta name='viewport' content='width=device-width, initial-scale=1'>
  <title>Phaser FIT</title>
  <style>
    html, body { margin: 0; width: 100%; height: 100%; }
    #game { width: 100%; height: 100vh; height: 100dvh;
            overflow: hidden; background: #111827; }
  </style>
</head>
<body>
  <div id='game'></div>
  <script src='https://cdnjs.cloudflare.com/ajax/libs/phaser/4.2.1/phaser.min.js'></script>
  <script>
    new Phaser.Game({
      type: Phaser.AUTO,
      parent: 'game',
      width: 960,
      height: 540,
      backgroundColor: '#1b2b43',
      scale: { mode: Phaser.Scale.FIT, autoCenter: Phaser.Scale.CENTER_BOTH },
      scene: {
        create() {
          // 内边框用于检查四边是否完整显示
          this.add.rectangle(480, 270, 920, 500, 0x284565)
            .setStrokeStyle(3, 0x4ad1bb);
          // HUD 使用逻辑坐标和固定的右上边距
          this.add.text(936, 24, 'HP 3  SCORE 120', {
            fontFamily: 'Arial', fontSize: '24px', color: '#ffffff'
          }).setOrigin(1, 0).setScrollFactor(0);
          this.add.text(480, 270, '960 × 540', {
            fontFamily: 'Arial', fontSize: '36px', color: '#ffffff'
          }).setOrigin(0.5);
          this.scale.on(Phaser.Scale.Events.RESIZE, (gameSize, _baseSize, displaySize) => {
            // FIT 改变显示尺寸,不改变设计分辨率
            console.log(`game=${gameSize.width}x${gameSize.height}, display=${Math.round(displaySize.width)}x${Math.round(displaySize.height)}`);
          });
        }
      }
    });
  </script>
</body>
</html>

预期结果:页面中央显示宽高比固定的蓝色游戏区域,青绿色内边框四边均可见;HP 3 SCORE 120 位于游戏区域右上角。拖动浏览器窗口后画面等比缩放,控制台的 game 保持 960x540,display 随可用空间变化。CDN 脚本加载需要网络连接。

按窗口比例检查留白与 HUD

打开浏览器开发者工具的设备模拟功能,分别设置如下父容器视口尺寸。下表按浏览器内容区域恰好等于表中尺寸、无其他页面边距计算;真实手机的浏览器工具栏和安全区域会改变可用高度。

父容器尺寸(CSS 像素) FIT 画布显示尺寸 验收重点
960 × 540 960 × 540 无留白,边框完整
1200 × 800 1200 × 675 上下各留 62.5 像素
390 × 844 390 × 219.4(约) 竖屏留白明显,HUD 仍在游戏画布右上角

验收时依次检查:内边框是否四边可见、文字是否没有被拉宽、HUD 是否始终位于游戏画布内部右上角,以及控制台是否出现脚本报错。FIT 不会自动把 HUD 移到整个浏览器视口的右上角,也不会让横屏关卡自动变成竖屏构图。

定位拉伸和 HUD 偏移

如果画面被拉伸,先检查是否额外为 canvas 写了强制的 CSS width、height 或 transform;这些规则可能与 Phaser 自动设置的显示尺寸冲突。保留父容器的宽高设置,让 Scale Manager 管理 Canvas 本身。

如果画面没有变化,检查 #game 是否实际具有非零宽高,以及配置中的 parent: 'game' 是否与容器 id 一致。无需在每次 window.resize 时手动调用 this.scale.resize():FIT 本身会响应尺寸变化。

如果 HUD 随世界相机滚动,应使用 .setScrollFactor(0) 或独立的 UI Scene;如果需求是 HUD 贴近手机屏幕顶部安全区域,固定 16:9 的 FIT 已不适合单独完成这项布局,需要专门的竖屏界面或 DOM 层处理。上线验收应同时记录横竖屏截图,避免误把正常留白判断为画面缺失。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 Scale Manager 缩放画面

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通