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

v0.2.5

新增：isShowMobileControls（默认：true）

• 说明：在移动端（触屏设备）打开时，控制器会自动创建虚拟摇杆与按键用于触摸控制；设置为 false 时不注入任何移动端 UI。

新增：thirdMouseMode（默认：1）

• 类型：number（可选值：0 / 1 / 2 / 3）
• 含义：在第三人称视角下，控制鼠标显示与拖拽对“人物朝向”与“视角”的影响：
  • 0：隐藏鼠标控制，鼠标滑动同时控制视角及人物朝向
  • 1：隐藏鼠标控制，鼠标滑动仅用于控制视角
  • 2：显示鼠标，拖拽同时控制视角及人物朝向
  • 3：显示鼠标，拖拽仅用于控制视角

---

Full Changelog: v0.2.4...v0.2.5