SuperAPI AI 工具集

camera

编程与开发

查看项目

更新于 11-08 11:40

技能介绍

Camera 是一个用于 Three.js 游戏的相机技能。它优先推荐使用 @pmndrs/viverse 提供的 CharacterCameraBehavior 作为角色相机,该行为内置双轴(pitch 与 yaw)带钳制的轨道旋转、相机碰撞和缩放。每帧在移动角色后调用 update(camera, characterModel, delta, raycast) 即可;碰撞通过 raycast 回调实现,用于让相机不穿墙。update 是唯一 API,没有 setOptions 方法,通过第五个 options 参数调整旋转(minPitch、maxPitch、minYaw、maxYaw、speed)、缩放(minDistance、maxDistance、speed)、碰撞和 characterBaseOffset。实例暴露 rotationPitch、rotationYaw、zoomDistance,可在首次 update 前设置初始朝向和缩放。将 FirstPersonCharacterCameraBehavior 作为第五个参数传入即可切换为第一人称。

当需要完全自定义相机装置时,技能提供了以最小 ECS 系统构建第一人称和第三人称相机的示例。所有自定义装置共享约定:camera.rotation.set(pitch, yaw, 0, 'YXZ'),正 pitch 向上看,正 yaw 向左看,'YXZ' 欧拉顺序保证 pitch 和 yaw 正确组合。第一人称相机定位在玩家头部,pitch 钳制在 [-PI/2, PI/2],yaw 不钳制。第三人称相机使用 Spherical 围绕玩家旋转,pitch 钳制在 [0.1, PI/2],避免相机绕到地面以下。静止姿态部分说明,当玩家空闲时可在拥有 pitch/yaw 的相机系统内部平滑插值回静止姿态。

特效部分包含两个可叠加在任何相机上的效果:屏幕震动(ScreenShakeSystem)通过类内 shake(intensity, duration) 启动衰减随机偏移,注意 delta 单位为秒而剩余时间按毫秒记录,因此 update 中减去 delta * 1000;FOV 速度效果(FOVSpeedSystem)根据玩家速度在 baseFOV 和 maxFOV 之间插值,改变 fov 后必须调用 camera.updateProjectionMatrix() 才能生效。技能还交叉引用 @pmndrs/viverse、acta、physics、entity-component-system 和 math 技能。