@soonspacejs/plugin-first-person-controls 2.13.16 → 2.14.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { Vector3, Vector2, Intersection, Sphere, Object3D, Box3, Camera } from 'three';
-import SoonSpace, { Position, Rotation } from 'soonspacejs';
+import { default as SoonSpace, Position, Rotation } from 'soonspacejs';
 export type ClashCheckAxis = 'front' | 'back' | 'left' | 'right' | 'up' | 'down';
 /**
  * 碰撞对象过滤器
@@ -193,7 +193,7 @@ export default class FirstPersonControlsPlugin {
      */
     searchRadiusFactor: number;
     checkedSphere: Sphere;
-    getCheckedObjects(origin: Vector3): Object3D<import("three").Object3DEventMap>[];
+    getCheckedObjects(origin: Vector3): Object3D<import('three').Object3DEventMap>[];
     /**
      * 重力搜索系数
      * @remarks
@@ -202,8 +202,8 @@ export default class FirstPersonControlsPlugin {
     gravitySearchFactor: number;
     gravityCheckedObjects: Object3D[] | null;
     gravityCheckedBox: Box3;
-    getGravityCheckedObjects(origin: Vector3, dropY: number): Object3D<import("three").Object3DEventMap>[];
-    gravityClashCheck(origin: Vector3, dropY: number): Intersection<Object3D<import("three").Object3DEventMap>>;
+    getGravityCheckedObjects(origin: Vector3, dropY: number): Object3D<import('three').Object3DEventMap>[];
+    gravityClashCheck(origin: Vector3, dropY: number): Intersection<Object3D<import('three').Object3DEventMap>>;
     setOptions(options: StartOptions): void;
     start(options: StartOptions): void;
     stop(): void;

package/dist/index.esm.js

@@ -1 +1,463 @@
-import{Vector2 as t,Vector3 as e,Sphere as s,Box3 as i,Raycaster as o,Matrix4 as n,Euler as a,Quaternion as r}from"three";import h from"soonspacejs";const{utils:{isObjectVisible:c}}=h;function l(t,e){const s=h.utils.getBoundingBox(e);return t.intersectsBox(s)}function d(t,e){t.disableAll();for(const s of e)t.enable(s)}function p(t,e){return t.intersectObjects(e).filter(({object:t})=>c(t))}const{EPSILON:v,approxEquals:m}=h.utils,{utils:y}=h;class u{get rotate(){return this._rotate&&(this.horizontalRotate||this.verticalRotate)}set rotate(t){this._rotate=t}constructor(o){this.enabled=!1,this.keyCodeMap={moveForward:["ArrowUp","KeyW"],moveBackward:["ArrowDown","KeyS"],moveLeft:["ArrowLeft","KeyA"],moveRight:["ArrowRight","KeyD"],moveUp:["KeyQ"],moveDown:["KeyE"],rotateUp:["KeyI"],rotateDown:["KeyK"],rotateLeft:["KeyJ"],rotateRight:["KeyL"],jump:["Space"]},this.state={moveForward:!1,moveBackward:!1,moveLeft:!1,moveRight:!1,moveUp:!1,moveDown:!1,canJump:!1,canRotate:!1},this.moveSpeed=10,this.gravitySpeed=10,this.jumpOffset=0,this.clashCheckDistance=200,this.clashDistance=50,this.eyeHeight=160,this.kneeHeight=50,this.jumpHeight=110,this.enableClash=!0,this.enableGravity=!0,this.reverseRotate=!1,this._rotate=!0,this.rotateSpeed=1,this.horizontalRotate=!0,this.verticalRotate=!0,this.dblClickForward=!1,this.movement=new t,this._dblVector=new e,this._dblDeltaVector=new e,this._pointerId=null,this.lastDirection=new e,this.searchRadiusFactor=3,this.checkedSphere=new s,this.gravitySearchFactor=3,this.gravityCheckedObjects=null,this.gravityCheckedBox=new i,this.gravityInterObject=null,this.kneeInterObject=null,this.eyeInterObject=null,this.ssp=o,this.viewport=o.viewport,this.controls=o.controls,this.camera=o.controls.camera,this.container=o.viewport.container,this.onKeyDown=this.onKeyDown.bind(this),this.onKeyUp=this.onKeyUp.bind(this),this.onDblClick=this.onDblClick.bind(this),this.onPointerDown=this.onPointerDown.bind(this),this.onPointerMove=this.onPointerMove.bind(this),this.onPointerUp=this.onPointerUp.bind(this)}onKeyDown(t){if(!1!==this.enabled){t:for(const[e,s]of Object.entries(this.keyCodeMap))if(s.includes(t.code))switch(e){case"moveForward":this.state.moveForward=!0;break t;case"moveBackward":this.state.moveBackward=!0;break t;case"moveLeft":this.state.moveLeft=!0;break t;case"moveRight":this.state.moveRight=!0;break t;case"moveUp":this.state.moveUp=!0;break t;case"moveDown":this.state.moveDown=!0;break t;case"rotateUp":this.state.canRotate=!0,this.movement.x=0,this.movement.y=-10;break t;case"rotateDown":this.state.canRotate=!0,this.movement.x=0,this.movement.y=10;break t;case"rotateLeft":this.state.canRotate=!0,this.movement.x=-10,this.movement.y=0;break t;case"rotateRight":this.state.canRotate=!0,this.movement.x=10,this.movement.y=0;break t;case"jump":!0===this.state.canJump&&!1===t.repeat&&(this.jumpOffset=this.jumpHeight),this.state.canJump=!1;break t}(this.jumpOffset>0||Object.values(this.state).some(t=>t))&&this.ssp.render()}}onKeyUp(t){t:for(const[e,s]of Object.entries(this.keyCodeMap))if(s.includes(t.code))switch(e){case"moveForward":this.state.moveForward=!1;break t;case"moveBackward":this.state.moveBackward=!1;break t;case"moveLeft":this.state.moveLeft=!1;break t;case"moveRight":this.state.moveRight=!1;break t;case"moveUp":this.state.moveUp=!1;break t;case"moveDown":this.state.moveDown=!1;break t;case"rotateUp":case"rotateDown":case"rotateLeft":case"rotateRight":this.state.canRotate=!1;break t}}onDblClick(t){if(!0===this.dblClickForward){const[e]=this.ssp.viewport.getIntersects(t);if(e){const{point:t}=e;t.y+=this.eyeHeight,t.sub(this.camera.position),this._dblVector.copy(t),this._dblDeltaVector.set(0,0,0),this.ssp.render()}}}onPointerDown(t){null===this._pointerId&&0===t.button&&(this.container.setPointerCapture(t.pointerId),this._pointerId=t.pointerId,this.state.canRotate=!0)}onPointerMove(t){if(t.preventDefault(),this.enabled&&this.state.canRotate){let e=t.movementY,s=t.movementX;this.reverseRotate&&(s=-s,e=-e),this.movement.x=s,this.movement.y=e,this.ssp.render()}}onPointerUp(t){null!==this._pointerId&&(this.container.releasePointerCapture(t.pointerId),this._pointerId=null,this.state.canRotate=!1)}clearClashCache(){this.kneeInterObject=null,this.eyeInterObject=null}onClashCheck(t,e){const s=e.length(),i=e.clone().divideScalar(s);i.distanceToSquared(this.lastDirection)>1e-9&&this.clearClashCache(),this.lastDirection=i;const{eyeHeight:n,kneeHeight:a,camera:r,clashCheckDistance:h,clashDistance:c,clashLayers:l}=this;let{kneeInterObject:v,eyeInterObject:m}=this;if(!v){const e=t.clone().setY(t.y-n+a),s=new o(e,i,0,h);s.firstHitOnly=!0,null!=l&&d(s.layers,l),s.camera=r;const c=p(s,this.getCheckedObjects(e));this.kneeInterObject=v=c[0]}let y=-s;if(v&&(y+=v.distance,y<c))return!0;if(!m){const e=new o(t,i,0,h);e.firstHitOnly=!0,null!=l&&d(e.layers,l),e.camera=r;const s=p(e,this.getCheckedObjects(t));this.eyeInterObject=m=s[0]}let u=-s;if(m){if(u+=m.distance,u<c)return!0;m.distance=u}return v&&(v.distance=y),!1}getCheckedObjects(t){const{clashDistance:e,clashCheckDistance:s,searchRadiusFactor:i,clashFilter:o}=this,n=s*i,a=this.checkedSphere,r=n+e;a.set(t,r);const h=null!=o?o:function(){return!0};return this.viewport.scener.intersectsList.getAll().filter(t=>!!h(t)&&l(a,t))}getGravityCheckedObjects(t,s){const i=this.gravityCheckedBox;let o=this.gravityCheckedObjects;if(o){const e=t.clone();e.y=s,i.containsPoint(t)&&i.containsPoint(e)||(o=null)}if(!o){const{eyeHeight:s,clashCheckDistance:n,gravitySearchFactor:a,clashDistance:r,clashFilter:h}=this,c=n+r,d=new e(c,c,0),p=t.clone().add(d),v=t.clone().sub(d);v.y-=s*a,i.set(v,p);const m=this.viewport.scener.intersectsList.getAll(),y=null!=h?h:function(){return!0};o=m.filter(t=>!!y(t)&&l(i,t))}return o}gravityClashCheck(t,s){var i;let a=this.gravityInterObject;if(a){const{object:s,face:o,instanceId:r}=a,h=null===(i=s.geometry)||void 0===i?void 0:i.getAttribute("position");if(h&&o){let i=a.facePoints;if(!i){let t=s.matrixWorld;if(null!=r){const e=new n;s.getMatrixAt(r,e),t=e.premultiply(t)}const{a:c,b:l,c:d}=o,p=new e(h.getX(c),h.getY(c),h.getZ(c));p.applyMatrix4(t),p.setY(0);const v=new e(h.getX(l),h.getY(l),h.getZ(l));v.applyMatrix4(t),v.setY(0);const m=new e(h.getX(d),h.getY(d),h.getZ(d));m.applyMatrix4(t),m.setY(0),a.facePoints=i=[p,v,m]}let c=i[2],l=null;const d=t.clone();d.y=0;i.every(t=>{const e=t.clone();e.sub(c);const s=d.clone();if(s.sub(c),e.cross(s),l){if(e.dot(l)<=0)return!1}return l=e,c=t,!0})||(this.gravityInterObject=a=null)}}if(!a){const i=new o(t,new e(0,-1,0));i.firstHitOnly=!0;const n=this.clashLayers;null!=n&&d(i.layers,n),i.camera=this.camera;const r=p(i,this.getGravityCheckedObjects(t,s));this.gravityInterObject=a=r[0]}return a}setOptions(t){const{position:s=new e,rotation:i=new a,moveSpeed:o,eyeHeight:n,kneeHeight:r,jumpHeight:h,enableClash:c,enableGravity:l,searchRadiusFactor:d,clashDistance:p,clashCheckDistance:m,gravitySpeed:u,gravitySearchFactor:b,reverseRotate:g,rotate:w,rotateSpeed:f,horizontalRotate:k,verticalRotate:C,dblClickForward:D,clashFilter:j,clashLayers:R}=t;if(n&&(this.eyeHeight=n),r&&(this.kneeHeight=r),h&&(this.jumpHeight=h),d&&(this.searchRadiusFactor=d),p&&(this.clashDistance=p),m&&(this.clashCheckDistance=m),u&&(this.gravitySpeed=u),b&&(this.gravitySearchFactor=b),null!=g&&(this.reverseRotate=g),null!=w&&(this.rotate=w),null!=k&&(this.horizontalRotate=k),null!=C&&(this.verticalRotate=C),y.isBoolean(D)&&(this.dblClickForward=D),y.isNumber(f)&&(this.rotateSpeed=f),null!=c&&(this.enableClash=c),null!=l&&(this.enableGravity=l),null!=j&&(this.clashFilter=j),null!=R&&(this.clashLayers=R),s&&(this.controls.setPosition(s.x,s.y+this.eyeHeight,s.z),this.gravityInterObject=null,this.clearClashCache()),i){const t=y.computeTargetByRotation(this.controls.getPosition(new e),i,v);this.controls.setTarget(t.x,t.y,t.z)}o&&(this.moveSpeed=o)}start(t){this.viewport.controls.saveState(),this.viewport.controls.enabled=!1,this.enabled=!0,this.setOptions(t),this.viewport.postRender.set("FirstPersonControls",this.update.bind(this)),this.ssp.signals.dblClick.add(this.onDblClick),this.ssp.signals.keyDown.add(this.onKeyDown),this.ssp.signals.keyUp.add(this.onKeyUp);const e=this.container;e.addEventListener("pointerdown",this.onPointerDown),e.addEventListener("pointermove",this.onPointerMove),e.addEventListener("pointerup",this.onPointerUp),e.style.touchAction="none",e.style.userSelect="none"}stop(){this.viewport.controls.reset(),this.viewport.controls.enabled=!0,this.enabled=!1,this.viewport.postRender.delete("FirstPersonControls"),this.ssp.signals.dblClick.remove(this.onDblClick),this.ssp.signals.keyDown.remove(this.onKeyDown),this.ssp.signals.keyUp.remove(this.onKeyUp);const t=this.container;t.removeEventListener("pointerdown",this.onPointerDown),t.removeEventListener("pointermove",this.onPointerMove),t.removeEventListener("pointerup",this.onPointerUp),t.style.touchAction="auto",t.style.userSelect="auto",this.ssp.render()}update(){if(!this.enabled)return;const{delta:t}=this.viewport.state,s=new e,{controls:i,state:o,camera:n,eyeHeight:h,kneeHeight:c}=this,l=i.getPosition(new e),d=20*this.moveSpeed,p=20*this.gravitySpeed;o.moveForward&&(s.z-=d),o.moveBackward&&(s.z+=d),o.moveLeft&&(s.x-=d),o.moveRight&&(s.x+=d),o.moveUp&&(s.y+=2*p),o.moveDown&&(s.y-=2*p),s.multiplyScalar(t);const{x:y,y:u}=this.movement,b=this.horizontalRotate&&0!==y,g=this.verticalRotate&&0!==u;if(this.rotate&&o.canRotate&&(b||g)){let{azimuthAngle:t,polarAngle:e}=i;g&&(e-=.003*u*this.rotateSpeed),b&&(t-=.003*y*this.rotateSpeed),i.rotateTo(t,e)}const w=new a(0,0,0,"YXZ");if(w.setFromQuaternion(n.quaternion),0!==w.y&&!s.equals(new e)){const t=new r;t.setFromAxisAngle(new e(0,1,0),w.y),s.applyQuaternion(t)}if(!this._dblVector.equals(new e)){const e=this._dblVector.clone().multiplyScalar(t);this._dblDeltaVector.add(e),this._dblDeltaVector.length()>this._dblVector.length()?(this._dblVector.set(0,0,0),this._dblDeltaVector.set(0,0,0)):s.add(e)}const f=l.clone();if((!this.enableClash||!this.onClashCheck(l,s))&&(f.add(s),this.gravityInterObject)){const t=this.gravityInterObject.point.clone().sub(f);t.y=0,t.length()>c&&(this.gravityInterObject=null)}let k=f.y;if(this.enableGravity){const e=k;this.jumpOffset>0&&(this.jumpOffset-=p*t,k+=2*p*t),k-=p*t,o.canJump=!1;const s=this.gravityClashCheck(f,k);if(s){const t=s.point.y+h;k<t&&(k=t,this.jumpOffset=0,o.canJump=!0)}e!==k&&this.clearClashCache()}f.y=k,m(l.x,f.x)&&m(l.y,f.y)&&m(l.z,f.z)||(i.moveTo(f.x,f.y,f.z),i.dollyTo(v))}}export{u as default};
+import { Vector2 as K, Vector3 as g, Raycaster as O, Sphere as _, Box3 as H, Matrix4 as V, Euler as F, Quaternion as A } from "three";
+import D from "soonspacejs";
+const { utils: { isObjectVisible: B } } = D;
+function L(w, e) {
+  const t = D.utils.getBoundingBox(e);
+  return w.intersectsBox(t);
+}
+function R(w, e) {
+  w.disableAll();
+  for (const t of e)
+    w.enable(t);
+}
+function I(w, e) {
+  return w.intersectObjects(e).filter(({ object: s }) => B(s));
+}
+const { EPSILON: U, approxEquals: P } = D.utils, { utils: S } = D;
+class M {
+  ssp;
+  viewport;
+  controls;
+  camera;
+  container;
+  enabled = !1;
+  keyCodeMap = {
+    moveForward: ["ArrowUp", "KeyW"],
+    moveBackward: ["ArrowDown", "KeyS"],
+    moveLeft: ["ArrowLeft", "KeyA"],
+    moveRight: ["ArrowRight", "KeyD"],
+    moveUp: ["KeyQ"],
+    moveDown: ["KeyE"],
+    rotateUp: ["KeyI"],
+    rotateDown: ["KeyK"],
+    rotateLeft: ["KeyJ"],
+    rotateRight: ["KeyL"],
+    jump: ["Space"]
+  };
+  state = {
+    moveForward: !1,
+    moveBackward: !1,
+    moveLeft: !1,
+    moveRight: !1,
+    moveUp: !1,
+    moveDown: !1,
+    canJump: !1,
+    canRotate: !1
+  };
+  /**
+   * 移动速度
+   */
+  moveSpeed = 10;
+  /**
+   * 重力速度
+   */
+  gravitySpeed = 10;
+  jumpOffset = 0;
+  /**
+   * 碰撞检测距离
+   */
+  clashCheckDistance = 200;
+  /**
+   * 碰撞距离
+   */
+  clashDistance = 50;
+  eyeHeight = 160;
+  kneeHeight = 50;
+  jumpHeight = 110;
+  enableClash = !0;
+  enableGravity = !0;
+  /**
+   * 反向旋转
+   */
+  reverseRotate = !1;
+  _rotate = !0;
+  /**
+   * 是否能旋转
+   */
+  get rotate() {
+    return this._rotate && (this.horizontalRotate || this.verticalRotate);
+  }
+  set rotate(e) {
+    this._rotate = e;
+  }
+  /**
+   * 旋转速度
+   */
+  rotateSpeed = 1;
+  /**
+   * 是否开启水平方向的旋转
+   */
+  horizontalRotate = !0;
+  /**
+   * 是否开启垂直方向旋转
+   */
+  verticalRotate = !0;
+  /**
+   * 开启双击前进
+   */
+  dblClickForward = !1;
+  movement = new K();
+  /**
+   * 碰撞对象过滤器
+   * @remarks
+   * 会在遍历对象时逐个调用该方法
+   *
+   * @param obj - Object3D 对象
+   * @returns true：表示检测该对象的碰撞；false | null | undefined | void：表示不检测该对象的碰撞；
+   */
+  clashFilter;
+  /**
+   * 碰撞检测的层级
+   */
+  clashLayers;
+  /**
+   *
+   * @param ssp
+   * @param camera - 自定义的摄像机，默认会自动生成一个新的摄像机
+   */
+  constructor(e) {
+    this.ssp = e, this.viewport = e.viewport, this.controls = e.controls, this.camera = e.controls.camera, this.container = e.viewport.container, this.onKeyDown = this.onKeyDown.bind(this), this.onKeyUp = this.onKeyUp.bind(this), this.onDblClick = this.onDblClick.bind(this), this.onPointerDown = this.onPointerDown.bind(this), this.onPointerMove = this.onPointerMove.bind(this), this.onPointerUp = this.onPointerUp.bind(this);
+  }
+  onKeyDown(e) {
+    if (this.enabled !== !1) {
+      e: for (const [t, s] of Object.entries(this.keyCodeMap))
+        if (s.includes(e.code))
+          switch (t) {
+            case "moveForward":
+              this.state.moveForward = !0;
+              break e;
+            case "moveBackward":
+              this.state.moveBackward = !0;
+              break e;
+            case "moveLeft":
+              this.state.moveLeft = !0;
+              break e;
+            case "moveRight":
+              this.state.moveRight = !0;
+              break e;
+            case "moveUp":
+              this.state.moveUp = !0;
+              break e;
+            case "moveDown":
+              this.state.moveDown = !0;
+              break e;
+            case "rotateUp":
+              this.state.canRotate = !0, this.movement.x = 0, this.movement.y = -10;
+              break e;
+            case "rotateDown":
+              this.state.canRotate = !0, this.movement.x = 0, this.movement.y = 10;
+              break e;
+            case "rotateLeft":
+              this.state.canRotate = !0, this.movement.x = -10, this.movement.y = 0;
+              break e;
+            case "rotateRight":
+              this.state.canRotate = !0, this.movement.x = 10, this.movement.y = 0;
+              break e;
+            case "jump":
+              this.state.canJump === !0 && e.repeat === !1 && (this.jumpOffset = this.jumpHeight), this.state.canJump = !1;
+              break e;
+          }
+      (this.jumpOffset > 0 || Object.values(this.state).some((t) => t)) && this.ssp.render();
+    }
+  }
+  onKeyUp(e) {
+    e: for (const [t, s] of Object.entries(this.keyCodeMap))
+      if (s.includes(e.code))
+        switch (t) {
+          case "moveForward":
+            this.state.moveForward = !1;
+            break e;
+          case "moveBackward":
+            this.state.moveBackward = !1;
+            break e;
+          case "moveLeft":
+            this.state.moveLeft = !1;
+            break e;
+          case "moveRight":
+            this.state.moveRight = !1;
+            break e;
+          case "moveUp":
+            this.state.moveUp = !1;
+            break e;
+          case "moveDown":
+            this.state.moveDown = !1;
+            break e;
+          case "rotateUp":
+          case "rotateDown":
+          case "rotateLeft":
+          case "rotateRight":
+            this.state.canRotate = !1;
+            break e;
+        }
+  }
+  _dblVector = new g();
+  _dblDeltaVector = new g();
+  onDblClick(e) {
+    if (this.dblClickForward === !0) {
+      const [t] = this.ssp.viewport.getIntersects(e);
+      if (t) {
+        const { point: s } = t;
+        s.y += this.eyeHeight, s.sub(this.camera.position), this._dblVector.copy(s), this._dblDeltaVector.set(0, 0, 0), this.ssp.render();
+      }
+    }
+  }
+  _pointerId = null;
+  onPointerDown(e) {
+    this._pointerId === null && // 左键
+    e.button === 0 && (this.container.setPointerCapture(e.pointerId), this._pointerId = e.pointerId, this.state.canRotate = !0);
+  }
+  /**
+   * events handler for pointer movement
+   */
+  onPointerMove(e) {
+    if (e.preventDefault(), this.enabled && this.state.canRotate) {
+      let t = e.movementY, s = e.movementX;
+      this.reverseRotate && (s = -s, t = -t), this.movement.x = s, this.movement.y = t, this.ssp.render();
+    }
+  }
+  onPointerUp(e) {
+    this._pointerId !== null && (this.container.releasePointerCapture(e.pointerId), this._pointerId = null, this.state.canRotate = !1);
+  }
+  clearClashCache() {
+    this.kneeInterObject = null, this.eyeInterObject = null;
+  }
+  lastDirection = new g();
+  onClashCheck(e, t) {
+    const s = t.length(), i = t.clone().divideScalar(s);
+    i.distanceToSquared(this.lastDirection) > 1e-9 && this.clearClashCache(), this.lastDirection = i;
+    const {
+      eyeHeight: v,
+      kneeHeight: p,
+      camera: n,
+      clashCheckDistance: h,
+      clashDistance: m,
+      clashLayers: r
+    } = this;
+    let { kneeInterObject: c, eyeInterObject: y } = this;
+    if (!c) {
+      const a = e.clone().setY(e.y - v + p), o = new O(
+        a,
+        i,
+        0,
+        h
+      );
+      o.firstHitOnly = !0, r != null && R(o.layers, r), o.camera = n;
+      const u = this.getCheckedObjects(a), d = I(o, u);
+      this.kneeInterObject = c = d[0];
+    }
+    let l = -s;
+    if (c && (l += c.distance, l < m))
+      return !0;
+    if (!y) {
+      const a = new O(
+        e,
+        i,
+        0,
+        h
+      );
+      a.firstHitOnly = !0, r != null && R(a.layers, r), a.camera = n;
+      const o = this.getCheckedObjects(e), u = I(a, o);
+      this.eyeInterObject = y = u[0];
+    }
+    let f = -s;
+    if (y) {
+      if (f += y.distance, f < m) return !0;
+      y.distance = f;
+    }
+    return c && (c.distance = l), !1;
+  }
+  /**
+   * 模型对象的搜索半径的系数
+   * @remarks
+   * 搜索半径是 clashCheckDistance 的多少倍
+   */
+  searchRadiusFactor = 3;
+  checkedSphere = new _();
+  getCheckedObjects(e) {
+    const {
+      clashDistance: t,
+      clashCheckDistance: s,
+      searchRadiusFactor: i,
+      clashFilter: v
+    } = this, p = s * i, n = this.checkedSphere, h = p + t;
+    n.set(e, h);
+    const m = v ?? function() {
+      return !0;
+    };
+    return this.viewport.scener.intersectsList.getAll().filter((c) => m(c) ? L(n, c) : !1);
+  }
+  /**
+   * 重力搜索系数
+   * @remarks
+   * 重力搜索系数 表示 向下搜索多少个 eyeHeight 的深度
+   */
+  gravitySearchFactor = 3;
+  gravityCheckedObjects = null;
+  gravityCheckedBox = new H();
+  getGravityCheckedObjects(e, t) {
+    const s = this.gravityCheckedBox;
+    let i = this.gravityCheckedObjects;
+    if (i) {
+      const v = e.clone();
+      v.y = t, s.containsPoint(e) && s.containsPoint(v) || (i = null);
+    }
+    if (!i) {
+      const {
+        eyeHeight: v,
+        clashCheckDistance: p,
+        gravitySearchFactor: n,
+        clashDistance: h,
+        clashFilter: m
+      } = this, r = p + h, c = new g(r, r, 0), y = e.clone().add(c), l = e.clone().sub(c);
+      l.y -= v * n, s.set(l, y);
+      const f = this.viewport.scener.intersectsList.getAll(), a = m ?? function() {
+        return !0;
+      };
+      i = f.filter((o) => a(o) ? L(s, o) : !1);
+    }
+    return i;
+  }
+  gravityClashCheck(e, t) {
+    let s = this.gravityInterObject;
+    if (s) {
+      const { object: i, face: v, instanceId: p } = s, n = i.geometry?.getAttribute(
+        "position"
+      );
+      if (n && v) {
+        let h = s.facePoints;
+        if (!h) {
+          let l = i.matrixWorld;
+          if (p != null) {
+            const k = new V();
+            i.getMatrixAt(p, k), l = k.premultiply(l);
+          }
+          const { a: f, b: a, c: o } = v, u = new g(
+            n.getX(f),
+            n.getY(f),
+            n.getZ(f)
+          );
+          u.applyMatrix4(l), u.setY(0);
+          const d = new g(
+            n.getX(a),
+            n.getY(a),
+            n.getZ(a)
+          );
+          d.applyMatrix4(l), d.setY(0);
+          const b = new g(
+            n.getX(o),
+            n.getY(o),
+            n.getZ(o)
+          );
+          b.applyMatrix4(l), b.setY(0), s.facePoints = h = [
+            u,
+            d,
+            b
+          ];
+        }
+        let m = h[2], r = null;
+        const c = e.clone();
+        c.y = 0, h.every((l) => {
+          const f = l.clone();
+          f.sub(m);
+          const a = c.clone();
+          return a.sub(m), f.cross(a), r && f.dot(r) <= 0 ? !1 : (r = f, m = l, !0);
+        }) || (this.gravityInterObject = s = null);
+      }
+    }
+    if (!s) {
+      const i = new O(e, new g(0, -1, 0));
+      i.firstHitOnly = !0;
+      const v = this.clashLayers;
+      v != null && R(i.layers, v), i.camera = this.camera;
+      const p = this.getGravityCheckedObjects(e, t), n = I(i, p);
+      this.gravityInterObject = s = n[0];
+    }
+    return s;
+  }
+  setOptions(e) {
+    const {
+      position: t = new g(),
+      rotation: s = new F(),
+      moveSpeed: i,
+      eyeHeight: v,
+      kneeHeight: p,
+      jumpHeight: n,
+      enableClash: h,
+      enableGravity: m,
+      searchRadiusFactor: r,
+      clashDistance: c,
+      clashCheckDistance: y,
+      gravitySpeed: l,
+      gravitySearchFactor: f,
+      reverseRotate: a,
+      rotate: o,
+      rotateSpeed: u,
+      horizontalRotate: d,
+      verticalRotate: b,
+      dblClickForward: k,
+      clashFilter: C,
+      clashLayers: x
+    } = e;
+    if (v && (this.eyeHeight = v), p && (this.kneeHeight = p), n && (this.jumpHeight = n), r && (this.searchRadiusFactor = r), c && (this.clashDistance = c), y && (this.clashCheckDistance = y), l && (this.gravitySpeed = l), f && (this.gravitySearchFactor = f), a != null && (this.reverseRotate = a), o != null && (this.rotate = o), d != null && (this.horizontalRotate = d), b != null && (this.verticalRotate = b), S.isBoolean(k) && (this.dblClickForward = k), S.isNumber(u) && (this.rotateSpeed = u), h != null && (this.enableClash = h), m != null && (this.enableGravity = m), C != null && (this.clashFilter = C), x != null && (this.clashLayers = x), t && (this.controls.setPosition(
+      t.x,
+      t.y + this.eyeHeight,
+      t.z
+    ), this.gravityInterObject = null, this.clearClashCache()), s) {
+      const j = S.computeTargetByRotation(this.controls.getPosition(new g()), s, U);
+      this.controls.setTarget(j.x, j.y, j.z);
+    }
+    i && (this.moveSpeed = i);
+  }
+  start(e) {
+    this.viewport.controls.saveState(), this.viewport.controls.enabled = !1, this.enabled = !0, this.setOptions(e), this.viewport.postRender.set("FirstPersonControls", this.update.bind(this)), this.ssp.signals.dblClick.add(this.onDblClick), this.ssp.signals.keyDown.add(this.onKeyDown), this.ssp.signals.keyUp.add(this.onKeyUp);
+    const t = this.container;
+    t.addEventListener("pointerdown", this.onPointerDown), t.addEventListener("pointermove", this.onPointerMove), t.addEventListener("pointerup", this.onPointerUp), t.style.touchAction = "none", t.style.userSelect = "none";
+  }
+  stop() {
+    this.viewport.controls.reset(), this.viewport.controls.enabled = !0, this.enabled = !1, this.viewport.postRender.delete("FirstPersonControls"), this.ssp.signals.dblClick.remove(this.onDblClick), this.ssp.signals.keyDown.remove(this.onKeyDown), this.ssp.signals.keyUp.remove(this.onKeyUp);
+    const e = this.container;
+    e.removeEventListener("pointerdown", this.onPointerDown), e.removeEventListener("pointermove", this.onPointerMove), e.removeEventListener("pointerup", this.onPointerUp), e.style.touchAction = "auto", e.style.userSelect = "auto", this.ssp.render();
+  }
+  gravityInterObject = null;
+  kneeInterObject = null;
+  eyeInterObject = null;
+  update() {
+    if (!this.enabled) return;
+    const { delta: e } = this.viewport.state, t = new g(), { controls: s, state: i, camera: v, eyeHeight: p, kneeHeight: n } = this, h = s.getPosition(new g()), m = this.moveSpeed * 20, r = this.gravitySpeed * 20;
+    i.moveForward && (t.z -= m), i.moveBackward && (t.z += m), i.moveLeft && (t.x -= m), i.moveRight && (t.x += m), i.moveUp && (t.y += r * 2), i.moveDown && (t.y -= r * 2), t.multiplyScalar(e);
+    const { x: c, y } = this.movement, l = this.horizontalRotate && c !== 0, f = this.verticalRotate && y !== 0;
+    if (this.rotate && i.canRotate && (l || f)) {
+      let { azimuthAngle: d, polarAngle: b } = s;
+      f && (b -= y * 3e-3 * this.rotateSpeed), l && (d -= c * 3e-3 * this.rotateSpeed), s.rotateTo(d, b);
+    }
+    const a = new F(0, 0, 0, "YXZ");
+    if (a.setFromQuaternion(v.quaternion), !(a.y === 0 || t.equals(new g()))) {
+      const d = new A();
+      d.setFromAxisAngle(new g(0, 1, 0), a.y), t.applyQuaternion(d);
+    }
+    if (!this._dblVector.equals(new g())) {
+      const d = this._dblVector.clone().multiplyScalar(e);
+      this._dblDeltaVector.add(d), this._dblDeltaVector.length() > this._dblVector.length() ? (this._dblVector.set(0, 0, 0), this._dblDeltaVector.set(0, 0, 0)) : t.add(d);
+    }
+    const o = h.clone();
+    if ((!this.enableClash || !this.onClashCheck(h, t)) && (o.add(t), this.gravityInterObject)) {
+      const b = this.gravityInterObject.point.clone().sub(o);
+      b.y = 0, b.length() > n && (this.gravityInterObject = null);
+    }
+    let u = o.y;
+    if (this.enableGravity) {
+      const d = u;
+      this.jumpOffset > 0 && (this.jumpOffset -= r * e, u += r * 2 * e), u -= r * e, i.canJump = !1;
+      const b = this.gravityClashCheck(o, u);
+      if (b) {
+        const C = b.point.y + p;
+        u < C && (u = C, this.jumpOffset = 0, i.canJump = !0);
+      }
+      d !== u && this.clearClashCache();
+    }
+    o.y = u, (!P(h.x, o.x) || !P(h.y, o.y) || !P(h.z, o.z)) && (s.moveTo(o.x, o.y, o.z), s.dollyTo(U));
+  }
+}
+export {
+  M as default
+};

package/dist/tools.d.ts

@@ -4,4 +4,4 @@ import { Box3, Object3D, Sphere, Layers, Raycaster } from 'three';
  */
 export declare function boundingIsIntersected(target: Box3 | Sphere, obj: Object3D): boolean;
 export declare function setLayers(layer: Layers, layerNums: number[]): void;
-export declare function raycasterFilter(raycaster: Raycaster, objs: Object3D[]): import("three").Intersection<Object3D<import("three").Object3DEventMap>>[];
+export declare function raycasterFilter(raycaster: Raycaster, objs: Object3D[]): import('three').Intersection<Object3D<import('three').Object3DEventMap>>[];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@soonspacejs/plugin-first-person-controls",
   "pluginName": "FirstPersonControlsPlugin",
-  "version": "2.13.16",
+  "version": "2.14.0",
   "description": "FirstPersonControls plugin for SoonSpace.js",
   "main": "dist/index.esm.js",
   "module": "dist/index.esm.js",
@@ -13,8 +13,8 @@
   ],
   "author": "xunwei",
   "license": "UNLICENSED",
-  "gitHead": "aaf0c46565c740277fad34bc3a3ba9fa61d48278",
+  "gitHead": "4c85e8b7b8ad24ccb9b42f3a1826bca377c42a6d",
   "peerDependencies": {
-    "soonspacejs": "2.13.16"
+    "soonspacejs": "2.14.0"
   }
 }