游戏引擎 / 系统课时

解决镜头穿模与越界

解决镜头穿模与越界

角色靠近墙壁或场景边缘时,第三人称摄像机可能穿过障碍、突然贴近角色,甚至移动到可玩区域之外。本课使用 Cocos Creator 3.8 的世界坐标限制与物理射线检测修正摄像机位置,建立一套可以实际运行、逐项验证的镜头保护方案。

学习目标

  • 区分镜头穿模、距离过近和场景越界的原因。
  • 使用物理射线检测障碍,并把摄像机收回安全位置。
  • 为摄像机设置活动边界,验证墙角和狭窄空间中的表现。

镜头问题来自哪些空间关系

摄像机跟随系统通常先根据角色位置计算期望机位,再进行平滑插值。但是期望机位只是数学上的目标位置,并不保证这个位置在场景中可以使用。

常见问题可以分成三类:

现象 主要原因 处理方向
镜头穿过墙壁 摄像机与角色之间存在障碍 从观察焦点向机位检测碰撞
镜头过近 障碍压缩观察距离,或近裁剪面设置不合适 设置安全间距,处理极近距离
镜头越界 跟随偏移把摄像机带出场景范围 限制世界坐标中的活动范围

正确的处理顺序是先计算期望机位,对世界坐标进行边界限制,再执行平滑跟随,最后检查从角色观察焦点到候选机位之间是否存在障碍。碰撞检测必须放在最终位置确定之前,否则平滑插值可能再次把摄像机带进墙体。

角色观察焦点、障碍命中点、安全摄像机位置与场景边界的空间关系

准备可检测的场景障碍

在 Cocos Creator 3.8 中,物理射线查询的是碰撞体,而不是模型表面本身。只有 MeshRenderer、没有 Collider 的墙壁,即使画面中可见,也不会被物理射线命中。

按以下顺序准备测试场景:

  1. 创建地面、玩家节点和一面墙,在墙壁节点上添加 BoxCollider,并让碰撞体覆盖实际墙面。
  2. 为玩家设置单独的物理碰撞组,确保后续摄像机检测不会命中玩家自身的 CapsuleCollider。
  3. 测试时让墙体保持在 DEFAULT 物理组,并使用对应的位掩码 1 查询障碍。正式项目如果重新分组,必须同步修改检测掩码。
  4. 保留带 Camera 组件的 Main Camera 节点,准备挂载摄像机保护脚本。
  5. 确认场景启用了 3D 物理功能,并根据实际地图尺寸确定摄像机的 X、Z 活动边界。

实现摄像机边界与碰撞修正

创建 CameraGuard.ts,将下面组件挂载到 Main Camera 节点,并在 Inspector 中把角色节点拖入 Target 属性。

示例使用固定世界坐标偏移:摄像机位于观察焦点上方 1 个单位、后方 Z 正方向 4.5 个单位。这样可以独立验证防穿模机制;如果项目需要摄像机随角色朝向旋转,只需替换期望机位的计算方式。

ts
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 中。

最终应保证三个条件同时成立:摄像机目标位置受地图边界约束,实际机位经过遮挡检查,且障碍消失后能够平滑恢复。它们分别解决越界、穿模和镜头突变,不能只依赖其中一种机制。

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

目录与阅读设置

阅读设置

17

记录一个想法

解决镜头穿模与越界

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

登录哪都通