游戏引擎 / 系统课时

让 Camera 跟随玩家并限制边界

让 Camera 跟随玩家并限制边界

本篇用一个宽 2400 像素的横向关卡演示 Camera 跟随玩家:在关卡中段,镜头随角色平滑移动;接近左右边缘时,镜头停在地图内,角色继续走向边缘。完成后,你还能将同样的配置应用到 Tiled 导入的 Tilemap。

学习目标

  • 用 startFollow() 设置玩家目标、像素取整与跟随平滑度。
  • 用 setBounds() 按关卡像素尺寸限制镜头滚动范围。
  • 在地图左端、中段、右端检查 scrollX,区分相机边界与玩家移动边界。

理解视窗与世界边界

本例的游戏视窗是 800×450 像素,关卡世界为 2400×450 像素,缩放 zoom=1。Camera 通过 scrollX 选择当前显示的世界区域;它移动的是观察窗口,不是地图或玩家对象。setBounds(0, 0, 2400, 450) 指定整张关卡的可见范围,而不是可滚动距离。

玩家世界坐标 x 稳定后的 scrollX 视窗覆盖的世界 x
100 0 0~800
1200 800 800~1600
2300 1600 1600~2400

在未设死区、镜头跟随完全收敛时,镜头试图把玩家放在视窗中央,即 player.x - 400;实际 scrollX 被限制在 0~1600。右端玩家不会继续居中,这是预期行为。示例使用平滑跟随,运动途中数值会短暂落后于表格。

横向关卡中 Camera 跟随玩家与左右边界的空间关系

运行完整的跟随示例

将下面内容保存为 index.html,在联网的浏览器中打开。示例固定使用 Phaser 4.2.1 的 CDN,不依赖贴图:网格模拟地图,绿色矩形代表玩家。按住键盘左、右方向键即可行走;左上角显示玩家世界坐标与相机滚动值。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <title>Phaser Camera Follow</title>
  <script src="https://cdn.jsdelivr.net/npm/phaser@4.2.1/dist/phaser.min.js"></script>
</head>
<body>
<script>
const WORLD_W = 2400;
const WORLD_H = 450;
const scene = {
  create() {
    // 用带刻度的长地图观察镜头是否真正移动。
    this.add.rectangle(1200, 225, WORLD_W, WORLD_H, 0x152b3d);
    const grid = this.add.graphics();
    grid.lineStyle(1, 0x365569, 1);
    for (let x = 0; x <= WORLD_W; x += 32) {
      grid.lineBetween(x, 0, x, WORLD_H);
    }
    for (let x = 0; x < WORLD_W; x += 400) {
      this.add.text(x + 12, 60, `x=${x}`, {
        fontSize: '20px', color: '#ffffff'
      });
    }
    this.add.rectangle(1200, 432, WORLD_W, 36, 0x496964);
    this.player = this.add.rectangle(100, 390, 28, 48, 0x29d4bc);
    this.keys = this.input.keyboard.createCursorKeys();

    const camera = this.cameras.main;
    // 边界宽度是地图总宽 2400,不是最大 scrollX 1600。
    camera.setBounds(0, 0, WORLD_W, WORLD_H);
    camera.startFollow(this.player, true, 0.12, 1);
    this.hud = this.add.text(12, 12, '', {
      fontSize: '16px', color: '#ffffff', backgroundColor: '#142130'
    }).setScrollFactor(0).setDepth(10);
  },
  update(_time, delta) {
    const direction = Number(this.keys.right.isDown)
      - Number(this.keys.left.isDown);
    // 将毫秒 delta 换算为秒,并避免玩家走出地图。
    this.player.x = Phaser.Math.Clamp(
      this.player.x + direction * 280 * delta / 1000,
      14, WORLD_W - 14
    );
    this.hud.setText(
      `player.x=${this.player.x.toFixed(0)}  scrollX=${this.cameras.main.scrollX.toFixed(0)}`
    );
  }
};
new Phaser.Game({
  type: Phaser.AUTO,
  width: 800,
  height: 450,
  backgroundColor: '#152b3d',
  scene
});
</script>
</body>
</html>

预期结果:画面显示长网格地图与绿色角色。角色从左端走向中间时,相机逐渐跟上;继续向右直到地图尽头,相机滚动值最终接近 1600,角色仍可移动到世界坐标 2386。反向回到左端后,scrollX 回到 0。0.12 是横向插值系数,不是 0.12 秒;改为 1 可观察不带平滑延迟的跟随。

接入实际的 Tiled 地图

当场景已通过 this.make.tilemap({ key: 'level' }) 创建 map,并且 player 是场景内的游戏对象时,不应再写死 2400。使用地图的像素尺寸,避免把瓦片数误当成像素。下面是放在场景 create()、创建地图和角色之后的片段示例:

js
const camera = this.cameras.main;
camera.setBounds(0, 0, map.widthInPixels, map.heightInPixels);
camera.startFollow(player, true, 0.12, 0.12);

片段的生效行为是镜头按地图实际尺寸滚动。例如 Tiled 地图宽 75 格、每格 32 像素时,map.widthInPixels 为 2400。若地图层设置了额外的位置偏移或缩放,要用最终世界坐标的实际矩形调整 setBounds(x, y, width, height),不能仅使用原始地图尺寸。参数定义可参照 Phaser Cameras 官方文档。

检查边缘停靠与典型错误

  1. 让玩家从起点向右移动到地图中间:确认背景刻度变化,scrollX 上升,而玩家大致位于画面中央。
  2. 继续向右走到尽头并松开按键:本例 scrollX 应趋近 1600,右侧最后一个地图区域仍然可见,不出现地图之外的空白。
  3. 返回左端:确认 scrollX 趋近 0,玩家可以靠近画面左边缘,镜头不再向左滚动。
  4. 若镜头始终不动,检查是否误将 setBounds() 宽度设成视窗宽度 800;若边缘出现空白,检查是否错把 scrollX 最大值 1600 当作地图宽度。

如果把 startFollow() 用在一个已被销毁或替换的旧角色上,新玩家不会自动成为跟随目标;重生时应对新的玩家对象重新调用 startFollow()。

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

目录与阅读设置

阅读设置

17

记录一个想法

让 Camera 跟随玩家并限制边界

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

登录哪都通