SuperAPI AI 工具集

gaia-camera

编程与开发

查看项目

更新于 11-08 11:40

技能介绍

gaia-camera 提供游戏相机移动与行为的参考实现,所有示例均采用极简 ECS 系统写法,完整模式参见 /docs/entity-component-system.md。

约定:pitch 为正表示向上看,yaw 为正表示向左看,旋转使用 Euler(pitch, yaw, 0, 'YXZ') 顺序。

用途

  • 为 Three.js 游戏搭建第一人称和第三人称相机。
  • 为相机添加屏幕震动、FOV 速度效果和静止回正等辅助表现。

主要能力

  1. 第一人称相机:FirstPersonCameraSystem 订阅 RotatePitchAction 与 RotateYawAction,pitch 限制在 -π/2 到 π/2 之间,更新时将相机放到玩家位置叠加头部偏移(默认 Vector3(0, 1.7, 0))处,并按 pitch、yaw 设置旋转。
  2. 第三人称相机:ThirdPersonCameraSystem 使用 Spherical 做环绕定位(数学细节见 /docs/math.md),pitch 限制在 0.1 到 π/2,半径默认 5,通过 setFromSpherical 计算相机位置并叠加玩家位置与头部偏移,再 lookAt 目标点。
  3. 静止回正:CameraRestSystem 在玩家空闲时用 MathUtils.lerp 以 0.05 的系数将 pitch、yaw 平滑插值到静止姿态。
  4. 屏幕震动:ScreenShakeSystem 提供 shake(intensity, duration) 接口,在剩余时间内按强度衰减对相机位置 x、y 施加随机偏移。
  5. FOV 速度效果:FOVSpeedSystem 在基础 FOV 75 与最大 FOV 100 之间按速度比例(最大速度 50)做插值,并调用 updateProjectionMatrix 更新投影矩阵。

使用方式 示例代码为 TypeScript 类,继承 createSystem({}),在 init 中订阅旋转动作,在 update 中更新相机。代码中玩家位置、玩家速度与是否空闲的判断以 TODO 注释标出,需要接入项目自身的玩家状态数据。使用前需了解该仓库的 ECS 模式与 Spherical、MathUtils 等 Three.js 数学工具。

适用场景 适用于使用 Three.js 与 ECS 架构、需要快速搭建或调整第一/第三人称相机及相机反馈效果的游戏项目。

限制 资料为参考示例代码,未提供完整安装步骤、包名、依赖版本、性能数据或收费信息;玩家位置与速度的获取逻辑未实现,需自行补全;第三人称相机中 target 的具体取值未在资料中说明。