v0.4.2

v0.4.2

新增

• 新增自定义动画扩展能力，支持 registerAnimation、playAnimation、registerLocomotionSet、switchLocomotionSet。
• 新增更多运行时状态与查询接口，包括 getVelocity()、getIsFirstPerson()、getIsFlying()、getIsOnGround()、getControllerMode()、getPlayerModel()、getPlayerCapsule()、getCollider()、getCurrentPlayerAnimationName()、getCenterScreenRaycastHit()。
• 新增事件回调接口，包括 onBeforeViewChange、onViewChange、onGroundChange、onVehicleEnter、onVehicleExit、onTowardChange。
• 新增运行时控制能力，支持 setPlayerScale() 动态缩放角色。
• 新增第一人称初始化与相机偏移配置，支持 isFirstPerson 和 firstPersonCameraOffset，方便更细致地控制第一人称体验。

修改

• 初始化配置项由 playerModel 调整为 playerModelConfig，与当前控制器实现保持一致。
• 角色头部节点字段由 headObjName 调整为 headBoneName。

示例

• 新增蜡笔小新（ShinChan）场景demo

v0.4.1

v0.4.1

修复

• 修复移动端摇杆控制时动画响应不及时

变化

• 移除 nipplejs 依赖
• 为移动端控制按钮新增显示/隐藏参数支持

v0.4.0

修复

添加楼梯检测

v0.3.9

修复

• 修复视角切换时第一视角方位错误的 bug

示例

• gltf 场景示例添加"更换场景"功能，可自定义场景模型加载到示例中
• 3dtiles 场景示例添加区域加载功能，只加载人物周边 tiles，优化性能

v0.3.8

修复

加强读取人物尺寸的相关逻辑

新增

新增getCurrentPersonAnimationName、registerAnimation、playAnimation等自定义动画API，这些目前处于测试阶段，为后续执行用户自定义动画做准备

v0.3.6

新增

1. 新增 setPlayerScale 方法，支持运行时动态缩放人物，自动同步碰撞胶囊体与所有相关物理参数
2. 新增 switchPlayerModel 方法，支持运行时切换人物模型，保留当前位置与朝向
3. 新增 setOverShoulderView / enableOverShoulderView 越肩视角偏移支持 #4
4. 新增 getCenterScreenRaycastHit 方法，获取屏幕中心射线与场景碰撞体的交点，可用于瞄准/交互检测
5. 车辆新增 followVehicleDirection 参数，控制行驶时相机是否自动跟随车辆速度方向
6. 车辆新增 speedMultiplier 参数，支持为不同车辆独立配置速度倍率
7. playerModel 新增 flyEnabled 参数，支持按场景禁用飞行模式
8. playerModel 新增 playerFlySpeed 参数，支持独立配置飞行速度

修复

1. 修复连续按 E 上车出现的 BUG
2. 修复上车过程中操控人物移动时仍切换至车辆控制模式的 BUG
3. 修复刹车后下车人物出现跳跃的 BUG
4. 移动端添加上车/下车按钮
5. 修复低帧率下车门无法正常关闭的 BUG

示例

1. GLB 场景新增级联阴影（CSM）与参数调试面板
2. 新增高斯泼溅（3D Gaussian Splatting）模型场景

v0.3.4

新增

• 新增车辆控制功能，详细用法请看md文件，示例：https://hh-hang.github.io/three-player-controller/
• playerModel.headObjName，第一人称下能够将相机绑定到人物头部模型上，更加沉浸、贴合体验（可选）。
• playerModel.rotateY，模型绕 Y 轴的额外旋转偏移（可选）。

修复

• 适配各种尺寸模型

v0.3.3

新增

enableZoom：第三人称模式下是否允许缩放
getposition()：获取人物当前位置

修复

修复thirdMouseMode为2、3时，第一人称切换第三人称鼠标不显示的bug

v0.3.2

修复

修复部分模型无法构建碰撞体的bug

v0.3.1

修复：

修复部分情况下跳跃无法执行的bug