three-player-controller 0.3.2 → 0.3.3

package/README.md

@@ -73,6 +73,7 @@ export function playerController(): {
     reset: (pos?: THREE.Vector3) => void;
     update: (dt?: number) => void;
     destroy: () => void;
+    getposition: () => THREE.Vector3;
 };
 ```
 
@@ -88,6 +89,8 @@ export function playerController(): {
   每帧调用。
 - `destroy()`  
   销毁控制器。
+- `getposition()`  
+  获取人物当前位置。
 
 ---
 
@@ -139,6 +142,9 @@ type PlayerControllerOptions = {
     minCamDistance?: number;
     maxCamDistance?: number;
     colliderMeshUrl?: string;
+    isShowMobileControls?: boolean;
+    thirdMouseMode?: number;
+    enableZoom?: boolean;
 };
 ```
 
@@ -161,6 +167,7 @@ type PlayerControllerOptions = {
 | `colliderMeshUrl`                                            |                  `string` | 自制碰撞体模型路径，默认`""`                                                                                                                           |
 | `isShowMobileControls`                                       |                 `boolean` | 移动端运行时，是否自动显示移动端控制器，默认`true`                                                                                                     |
 | `thirdMouseMode`                                             |            `[0, 1, 2, 3]` | 第三人称视角下的不同鼠标控制模式 ，默认`1`(0: 隐藏鼠标控制朝向及视角，1: 隐藏鼠标仅控制视角，2: 显示鼠标拖拽控制朝向及视角, 3: 显示鼠标拖拽仅控制视角) |
+| `enableZoom`                                                 |                 `boolean` | 第三人称模式下是否允许缩放，默认`false`                                                                                                                |
 
 ---
 

package/dist/index.d.mts

@@ -29,6 +29,7 @@ type PlayerControllerOptions = {
     colliderMeshUrl?: string;
     isShowMobileControls?: boolean;
     thirdMouseMode?: 0 | 1 | 2 | 3;
+    enableZoom?: boolean;
 };
 declare function playerController(): {
     init: (opts: PlayerControllerOptions, callback?: () => void) => Promise<void>;

package/dist/index.d.ts

@@ -29,6 +29,7 @@ type PlayerControllerOptions = {
     colliderMeshUrl?: string;
     isShowMobileControls?: boolean;
     thirdMouseMode?: 0 | 1 | 2 | 3;
+    enableZoom?: boolean;
 };
 declare function playerController(): {
     init: (opts: PlayerControllerOptions, callback?: () => void) => Promise<void>;

package/dist/index.js

@@ -60,7 +60,6 @@ var PlayerController = class {
   constructor() {
     // ==================== 基本配置与参数 ====================
     this.loader = new import_GLTFLoader.GLTFLoader();
-    // 0: 普通 1: 飞行 2: 车辆
     // ==================== 玩家基本属性 ====================
     this.playerRadius = 45;
     this.playerHeight = 180;
@@ -351,6 +350,7 @@ var PlayerController = class {
     this._maxCamDistance = (opts.maxCamDistance ?? 440) * s;
     this.orginMaxCamDistance = this._maxCamDistance;
     this.thirdMouseMode = opts.thirdMouseMode ?? 1;
+    this.enableZoom = opts.enableZoom ?? false;
     const isMobileDevice = () => navigator.maxTouchPoints && navigator.maxTouchPoints > 0 || "ontouchstart" in window || /Mobi|Android|iPhone|iPad|iPod/i.test(navigator.userAgent);
     this.isShowMobileControls = (opts.isShowMobileControls ?? true) && isMobileDevice();
     if (this.isShowMobileControls) {
@@ -561,6 +561,7 @@ var PlayerController = class {
       this.player.attach(this.camera);
       this.camera.position.set(0, 40 * this.playerModel.scale, 30 * this.playerModel.scale);
       this.camera.rotation.set(0, Math.PI, 0);
+      this.controls.enableZoom = false;
     } else {
       this.scene.attach(this.camera);
       const worldPos = this.player.position.clone();
@@ -569,6 +570,7 @@ var PlayerController = class {
       const offset = new THREE.Vector3(Math.cos(angle) * 400 * this.playerModel.scale, 200 * this.playerModel.scale, Math.sin(angle) * 400 * this.playerModel.scale);
       this.camera.position.copy(worldPos).add(offset);
       this.controls.target.copy(worldPos);
+      this.controls.enableZoom = this.enableZoom;
     }
     this.setPointerLock();
   }
@@ -582,6 +584,8 @@ var PlayerController = class {
   setPointerLock() {
     if ((this.thirdMouseMode === 0 || this.thirdMouseMode === 1) && !this.isFirstPerson || this.isFirstPerson) {
       document.body.requestPointerLock();
+    } else {
+      document.exitPointerLock();
     }
   }
   /**
@@ -603,9 +607,10 @@ var PlayerController = class {
    * 设置控制器
    */
   setControls() {
-    this.controls.enabled = !(this.thirdMouseMode === 0 || this.thirdMouseMode === 1);
+    this.controls.enableZoom = this.enableZoom;
     this.controls.rotateSpeed = this.mouseSensity * 0.05;
     this.controls.maxPolarAngle = Math.PI * (300 / 360);
+    this.controls.mouseButtons = { LEFT: 0, MIDDLE: 1, RIGHT: 2 };
   }
   /**
    * 重置控制器
@@ -929,28 +934,30 @@ var PlayerController = class {
       this.controls.target.copy(lookTarget);
       this.camera.position.add(lookTarget);
       this.controls.update();
-      this._personToCam.subVectors(this.camera.position, this.player.position);
-      const origin = this.player.position.clone().add(new THREE.Vector3(0, 0, 0));
-      const direction = this._personToCam.clone().normalize();
-      const desiredDist = this._personToCam.length();
-      this._raycasterPersonToCam.set(origin, direction);
-      this._raycasterPersonToCam.far = desiredDist;
-      const intersects2 = this._raycasterPersonToCam.intersectObject(this.collider, false);
-      if (intersects2.length > 0) {
-        const hit = intersects2[0];
-        const safeDist = Math.max(hit.distance - this._camEpsilon, this._minCamDistance);
-        const targetCamPos = origin.clone().add(direction.clone().multiplyScalar(safeDist));
-        this.camera.position.lerp(targetCamPos, this._camCollisionLerp);
-      } else {
-        this._raycasterPersonToCam.far = this._maxCamDistance;
-        const intersectsMaxDis = this._raycasterPersonToCam.intersectObject(this.collider, false);
-        let safeDist = this._maxCamDistance;
-        if (intersectsMaxDis.length) {
-          const hitMax = intersectsMaxDis[0];
-          safeDist = hitMax.distance - this._camEpsilon;
+      if (!this.enableZoom) {
+        this._personToCam.subVectors(this.camera.position, this.player.position);
+        const origin = this.player.position.clone().add(new THREE.Vector3(0, 0, 0));
+        const direction = this._personToCam.clone().normalize();
+        const desiredDist = this._personToCam.length();
+        this._raycasterPersonToCam.set(origin, direction);
+        this._raycasterPersonToCam.far = desiredDist;
+        const intersects2 = this._raycasterPersonToCam.intersectObject(this.collider, false);
+        if (intersects2.length > 0) {
+          const hit = intersects2[0];
+          const safeDist = Math.max(hit.distance - this._camEpsilon, this._minCamDistance);
+          const targetCamPos = origin.clone().add(direction.clone().multiplyScalar(safeDist));
+          this.camera.position.lerp(targetCamPos, this._camCollisionLerp);
+        } else {
+          this._raycasterPersonToCam.far = this._maxCamDistance;
+          const intersectsMaxDis = this._raycasterPersonToCam.intersectObject(this.collider, false);
+          let safeDist = this._maxCamDistance;
+          if (intersectsMaxDis.length) {
+            const hitMax = intersectsMaxDis[0];
+            safeDist = hitMax.distance - this._camEpsilon;
+          }
+          const targetCamPos = origin.clone().add(direction.clone().multiplyScalar(safeDist));
+          this.camera.position.lerp(targetCamPos, this._camCollisionLerp);
         }
-        const targetCamPos = origin.clone().add(direction.clone().multiplyScalar(safeDist));
-        this.camera.position.lerp(targetCamPos, this._camCollisionLerp);
       }
     }
     if (this.player.position.y < this.boundingBoxMinY - 1) {