版本更新0.4.5

Author: hh-hang

README.md

@@ -151,6 +151,7 @@ animate();
 | `setGravity(v)` | 设置重力。 |
 | `setMinCamDistance(v)` | 设置第三人称最小镜头距离。 |
 | `setMaxCamDistance(v)` | 设置第三人称最大镜头距离。 |
+| `setCamLookAtHeightRatio(v)` | 设置第三人称相机看向点高度比例（0=底部，1=顶部）。 |
 | `setThirdMouseMode(v)` | 设置第三人称鼠标模式：[0 | 1 | 2 | 3]。 |
 | `setEnableZoom(v)` | 设置是否允许镜头缩放。 |
 | `setOverShoulderView(v)` | 开关过肩视角偏移。 |
@@ -288,6 +289,7 @@ type PlayerControllerOptions = {
     enableZoom?: boolean;
     enableOverShoulderView?: boolean;
     isFirstPerson?: boolean;
+    camLookAtHeightRatio?: number;
 };
 ```
 
@@ -373,6 +375,7 @@ type VehicleOptions = {
 | `enableZoom` | `boolean` | 否 | `false` | 是否允许滚轮缩放。 |
 | `enableOverShoulderView` | `boolean` | 否 | `false` | 是否启用过肩视角。 |
 | `isFirstPerson` | `boolean` | 否 | `false` | 初始化时是否直接进入第一人称。 |
+| `camLookAtHeightRatio` | `number` | 否 | `0.8` | 第三人称相机看向点高度比例（0=胶囊底部，1=顶部）。 |
 
 ### `PlayerModelOptions`
 

README_En.md

@@ -151,6 +151,7 @@ animate();
 | `setGravity(v)` | Set gravity. |
 | `setMinCamDistance(v)` | Set minimum third-person camera distance. |
 | `setMaxCamDistance(v)` | Set maximum third-person camera distance. |
+| `setCamLookAtHeightRatio(v)` | Set the third-person camera look-at height ratio (0 = bottom, 1 = top). |
 | `setThirdMouseMode(v)` | Set third-person mouse mode: [0 | 1 | 2 | 3]. |
 | `setEnableZoom(v)` | Enable or disable camera zoom. |
 | `setOverShoulderView(v)` | Enable or disable over-shoulder view offset. |
@@ -288,6 +289,7 @@ type PlayerControllerOptions = {
     enableZoom?: boolean;
     enableOverShoulderView?: boolean;
     isFirstPerson?: boolean;
+    camLookAtHeightRatio?: number;
 };
 ```
 
@@ -372,6 +374,7 @@ type VehicleOptions = {
 | `enableZoom` | `boolean` | No | `false` | Whether wheel zoom is enabled. |
 | `enableOverShoulderView` | `boolean` | No | `false` | Whether over-shoulder view is enabled. |
 | `isFirstPerson` | `boolean` | No | `false` | Whether to start directly in first-person mode. |
+| `camLookAtHeightRatio` | `number` | No | `0.8` | Third-person camera look-at height ratio (0 = capsule bottom, 1 = top). |
 
 ### `PlayerModelOptions`
 

example/3dgs.js

@@ -122,11 +122,11 @@ async function init() {
             speed: 150,
             flySpeed: 1000,
             jumpHeight: 400,
-            capsuleRadiusRatio: 0.5,
         },
         initPos: pos,
         minCamDistance: 50,
         maxCamDistance: 180,
+        camLookAtHeightRatio: 0.9,
         staticCollider: colliderGltf.scene,
         enableOverShoulderView: true,
     });

example/OfficeBuilding.js

@@ -343,9 +343,8 @@ async function initPlayer() {
             exitCarAnim: "exitCar",
             headBoneName: "mixamorigHead",
             rotateY: Math.PI,
-            capsuleRadiusRatio: 0.9
         },
-        initPos: new Vector3(1.27, -2.95, 11.524),
+        initPos: new Vector3(1.27, 0, 11.524),
         minCamDistance: 50,
         maxCamDistance: 220,
         enableOverShoulderView: true,
@@ -628,7 +627,6 @@ function initClickPick() {
         const objects = [];
         tilesList.forEach((t) => t.group.traverse((c) => { if (c.isMesh) objects.push(c); }));
         const hits = _raycaster.intersectObjects(objects, false);
-        console.log('hits', hits)
         if (hits.length > 0) {
             const mesh = hits[0].object;
         }

example/glTF.js

@@ -724,6 +724,7 @@ function initGUI() {
         flySpeed: 2100,
         minCamDistance: 50,
         maxCamDistance: 220,
+        camLookAtHeightRatio: 0.8,
         thirdMouseMode: 1,
         enableZoom: false,
         debug: false,
@@ -824,6 +825,7 @@ function initGUI() {
     gui.add(params, "flySpeed", 0, 5000, 10).onChange((v) => player.setPlayerFlySpeed(v));
     gui.add(params, "minCamDistance", 0, 200, 1).onChange((v) => player.setMinCamDistance(v));
     gui.add(params, "maxCamDistance", 50, 1000, 1).onChange((v) => player.setMaxCamDistance(v));
+    gui.add(params, "camLookAtHeightRatio", 0, 1, 0.01).onChange((v) => player.setCamLookAtHeightRatio(v));
     gui.add(params, "thirdMouseMode", { 0: 0, 1: 1, 2: 2, 3: 3 }).onChange((v) => player.setThirdMouseMode(Number(v)));
     gui.add(params, "enableZoom").onChange((v) => player.setEnableZoom(v));
     gui.add(params, "debug").onChange((v) => player.setDebug(v));

package.json

@@ -1,6 +1,6 @@
 {
     "name": "three-player-controller",
-    "version": "0.4.4",
+    "version": "0.4.5",
     "description": "Third-person / first-person player controller for three.js (three-mesh-bvh based)",
     "author": "hh-hang",
     "license": "MIT",