gaia-camera 提供游戏相机移动与行为的参考实现,所有示例均采用极简 ECS 系统写法,完整模式参见 /docs/entity-component-system.md。
约定:pitch 为正表示向上看,yaw 为正表示向左看,旋转使用 Euler(pitch, yaw, 0, 'YXZ') 顺序。
用途
- 为 Three.js 游戏搭建第一人称和第三人称相机。
- 为相机添加屏幕震动、FOV 速度效果和静止回正等辅助表现。
主要能力
- 第一人称相机:FirstPersonCameraSystem 订阅 RotatePitchAction 与 RotateYawAction,pitch 限制在 -π/2 到 π/2 之间,更新时将相机放到玩家位置叠加头部偏移(默认 Vector3(0, 1.7, 0))处,并按 pitch、yaw 设置旋转。
- 第三人称相机:ThirdPersonCameraSystem 使用 Spherical 做环绕定位(数学细节见 /docs/math.md),pitch 限制在 0.1 到 π/2,半径默认 5,通过 setFromSpherical 计算相机位置并叠加玩家位置与头部偏移,再 lookAt 目标点。
- 静止回正:CameraRestSystem 在玩家空闲时用 MathUtils.lerp 以 0.05 的系数将 pitch、yaw 平滑插值到静止姿态。
- 屏幕震动:ScreenShakeSystem 提供 shake(intensity, duration) 接口,在剩余时间内按强度衰减对相机位置 x、y 施加随机偏移。
- FOV 速度效果:FOVSpeedSystem 在基础 FOV 75 与最大 FOV 100 之间按速度比例(最大速度 50)做插值,并调用 updateProjectionMatrix 更新投影矩阵。
使用方式 示例代码为 TypeScript 类,继承 createSystem({}),在 init 中订阅旋转动作,在 update 中更新相机。代码中玩家位置、玩家速度与是否空闲的判断以 TODO 注释标出,需要接入项目自身的玩家状态数据。使用前需了解该仓库的 ECS 模式与 Spherical、MathUtils 等 Three.js 数学工具。
适用场景 适用于使用 Three.js 与 ECS 架构、需要快速搭建或调整第一/第三人称相机及相机反馈效果的游戏项目。
限制 资料为参考示例代码,未提供完整安装步骤、包名、依赖版本、性能数据或收费信息;玩家位置与速度的获取逻辑未实现,需自行补全;第三人称相机中 target 的具体取值未在资料中说明。