游戏引擎 / 系统课时
让 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。右端玩家不会继续居中,这是预期行为。示例使用平滑跟随,运动途中数值会短暂落后于表格。

运行完整的跟随示例
将下面内容保存为 index.html,在联网的浏览器中打开。示例固定使用 Phaser 4.2.1 的 CDN,不依赖贴图:网格模拟地图,绿色矩形代表玩家。按住键盘左、右方向键即可行走;左上角显示玩家世界坐标与相机滚动值。
<!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()、创建地图和角色之后的片段示例:
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 官方文档。
检查边缘停靠与典型错误
- 让玩家从起点向右移动到地图中间:确认背景刻度变化,
scrollX上升,而玩家大致位于画面中央。 - 继续向右走到尽头并松开按键:本例
scrollX应趋近 1600,右侧最后一个地图区域仍然可见,不出现地图之外的空白。 - 返回左端:确认
scrollX趋近 0,玩家可以靠近画面左边缘,镜头不再向左滚动。 - 若镜头始终不动,检查是否误将
setBounds()宽度设成视窗宽度 800;若边缘出现空白,检查是否错把scrollX最大值 1600 当作地图宽度。
如果把 startFollow() 用在一个已被销毁或替换的旧角色上,新玩家不会自动成为跟随目标;重生时应对新的玩家对象重新调用 startFollow()。