游戏引擎 / 系统课时
解决镜头穿模与越界
解决镜头穿模与越界
角色靠近墙壁或场景边缘时,第三人称摄像机可能穿过障碍、突然贴近角色,甚至移动到可玩区域之外。本课使用 Cocos Creator 3.8 的世界坐标限制与物理射线检测修正摄像机位置,建立一套可以实际运行、逐项验证的镜头保护方案。
学习目标
- 区分镜头穿模、距离过近和场景越界的原因。
- 使用物理射线检测障碍,并把摄像机收回安全位置。
- 为摄像机设置活动边界,验证墙角和狭窄空间中的表现。
镜头问题来自哪些空间关系
摄像机跟随系统通常先根据角色位置计算期望机位,再进行平滑插值。但是期望机位只是数学上的目标位置,并不保证这个位置在场景中可以使用。
常见问题可以分成三类:
| 现象 | 主要原因 | 处理方向 |
|---|---|---|
| 镜头穿过墙壁 | 摄像机与角色之间存在障碍 | 从观察焦点向机位检测碰撞 |
| 镜头过近 | 障碍压缩观察距离,或近裁剪面设置不合适 | 设置安全间距,处理极近距离 |
| 镜头越界 | 跟随偏移把摄像机带出场景范围 | 限制世界坐标中的活动范围 |
正确的处理顺序是先计算期望机位,对世界坐标进行边界限制,再执行平滑跟随,最后检查从角色观察焦点到候选机位之间是否存在障碍。碰撞检测必须放在最终位置确定之前,否则平滑插值可能再次把摄像机带进墙体。

准备可检测的场景障碍
在 Cocos Creator 3.8 中,物理射线查询的是碰撞体,而不是模型表面本身。只有 MeshRenderer、没有 Collider 的墙壁,即使画面中可见,也不会被物理射线命中。
按以下顺序准备测试场景:
- 创建地面、玩家节点和一面墙,在墙壁节点上添加 BoxCollider,并让碰撞体覆盖实际墙面。
- 为玩家设置单独的物理碰撞组,确保后续摄像机检测不会命中玩家自身的 CapsuleCollider。
- 测试时让墙体保持在 DEFAULT 物理组,并使用对应的位掩码
1查询障碍。正式项目如果重新分组,必须同步修改检测掩码。 - 保留带 Camera 组件的 Main Camera 节点,准备挂载摄像机保护脚本。
- 确认场景启用了 3D 物理功能,并根据实际地图尺寸确定摄像机的 X、Z 活动边界。
实现摄像机边界与碰撞修正
创建 CameraGuard.ts,将下面组件挂载到 Main Camera 节点,并在 Inspector 中把角色节点拖入 Target 属性。
示例使用固定世界坐标偏移:摄像机位于观察焦点上方 1 个单位、后方 Z 正方向 4.5 个单位。这样可以独立验证防穿模机制;如果项目需要摄像机随角色朝向旋转,只需替换期望机位的计算方式。
import {
_decorator,
Component,
Node,
Vec3,
geometry,
PhysicsSystem,
} from 'cc';
const { ccclass, property } = _decorator;
@ccclass('CameraGuard')
export class CameraGuard extends Component {
@property({ type: Node })
target: Node | null = null;
@property focusHeight = 1.5;
@property backDistance = 4.5;
@property upOffset = 1.0;
@property skin = 0.2;
@property obstacleMask = 1;
@property minX = -10;
@property maxX = 10;
@property minZ = -8;
@property maxZ = 8;
private readonly focus = new Vec3();
private readonly desired = new Vec3();
private readonly candidate = new Vec3();
private readonly direction = new Vec3();
private readonly ray = new geometry.Ray();
private initialized = false;
lateUpdate(dt: number) {
if (!this.target) return;
this.target.getWorldPosition(this.focus);
this.focus.y += this.focusHeight;
// 先计算世界坐标中的期望机位,再限制地图范围。
this.desired.set(
this.focus.x,
this.focus.y + this.upOffset,
this.focus.z + this.backDistance
);
this.desired.x = Math.max(
this.minX, Math.min(this.maxX, this.desired.x)
);
this.desired.z = Math.max(
this.minZ, Math.min(this.maxZ, this.desired.z)
);
// 平滑跟随产生候选机位,而不是直接作为最终机位。
if (this.initialized) {
this.node.getWorldPosition(this.candidate);
Vec3.lerp(
this.candidate,
this.candidate,
this.desired,
1 - Math.exp(-8 * dt)
);
} else {
this.candidate.set(this.desired);
}
const distance = Vec3.distance(
this.focus, this.candidate
);
if (distance > 0.001) {
geometry.Ray.fromPoints(
this.ray, this.focus, this.candidate
);
// 只检测指定障碍组,忽略Trigger。
if (PhysicsSystem.instance.raycastClosest(
this.ray, this.obstacleMask, distance, false
)) {
const hit = PhysicsSystem.instance.raycastClosestResult;
const safeDistance = Math.max(
0.05, hit.distance - this.skin
);
Vec3.subtract(
this.direction, this.candidate, this.focus
);
Vec3.normalize(this.direction, this.direction);
Vec3.scaleAndAdd(
this.candidate,
this.focus,
this.direction,
safeDistance
);
}
}
this.node.setWorldPosition(this.candidate);
this.node.lookAt(this.focus);
this.initialized = true;
}
}预期结果:在目标节点已绑定、墙壁碰撞体与检测掩码配置正确的情况下,摄像机会平滑移动;当墙体进入观察焦点与候选机位之间时,摄像机沿检测方向收回到命中点前方,并持续朝向角色。没有障碍时,摄像机会逐渐恢复原定距离。
示例边界为 X 轴 -10 至 10、Z 轴 -8 至 8,应按项目实际地图修改。边界限制假设角色观察焦点也处于有效区域内;如果角色本身允许离开边界,应另外设计可用的摄像机区域。
这里使用 lateUpdate,是为了尽量在角色常规逐帧移动完成后再更新镜头。平滑系数采用与帧间隔相关的指数形式,避免不同帧率下恢复速度差异过大。
处理近距离与墙角的特殊情况
射线检测解决的是观察焦点到摄像机中心之间的遮挡问题。摄像机实际还有近裁剪面和视锥体宽度,因此中心射线没有命中,不代表屏幕边缘一定不会穿过墙角。
对于墙角、柱子和狭窄通道,可以把单条射线升级为带半径的 Sphere Sweep。Cocos Creator 3.8 提供 PhysicsSystem.instance.sweepSphereClosest,可以利用球体半径预留摄像机周围空间。实际使用时要根据摄像机近裁剪面、视角和角色尺寸确定检测半径。
另一个容易忽略的问题是最小观察距离。例如墙壁距离观察焦点仅有 0.3 个世界单位,此时强行规定摄像机必须保持 1 个单位距离,反而可能把镜头推进墙内。
还要检查 Camera 组件的 Near 裁剪距离。如果 Near 设置过大,即使摄像机节点没有进入墙体,靠近镜头的物体仍可能被裁切。减小 Near 可以缓解近距离裁切,但不能替代物理碰撞检测。
按场景动作验证修正效果
完成脚本挂载后,使用以下动作逐项测试:
| 测试动作 | 预期表现 | 异常时重点检查 |
|---|---|---|
| 角色向墙壁靠近 | 摄像机在墙前收回 | BoxCollider、检测掩码、射线方向 |
| 角色离开墙壁 | 摄像机平滑恢复距离 | 插值系数和期望机位 |
| 角色进入墙角 | 镜头中心不穿墙 | 近裁剪面、视锥边缘、球体扫掠 |
| 角色靠近地图边缘 | 摄像机位置保持在限制范围内 | minX、maxX、minZ、maxZ |
| 角色进入狭窄通道 | 距离可缩短但不强行穿墙 | 安全间距与极近距离策略 |
如果摄像机始终贴着角色,首先检查射线是否命中了玩家自身;如果镜头完全忽略墙体,则检查墙体是否有 Collider,以及障碍所在的物理组是否包含在 obstacleMask 中。
最终应保证三个条件同时成立:摄像机目标位置受地图边界约束,实际机位经过遮挡检查,且障碍消失后能够平滑恢复。它们分别解决越界、穿模和镜头突变,不能只依赖其中一种机制。