three-player-controller 0.3.3 → 0.3.5

package/dist/index.d.ts

@@ -1,6 +1,65 @@
+import { RigidBody } from '@dimforge/rapier3d-compat';
 import * as THREE from 'three';
 import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
 
+/**
+ * 障碍物检测接口
+ */
+interface ObstacleChecker {
+    /**
+     * 检查两点之间的线段是否被障碍物阻挡
+     */
+    isBlocked(start: THREE.Vector3, end: THREE.Vector3): boolean;
+    /**
+     * 获取障碍物周围的导航节点
+     */
+    getNavigationNodes(start: THREE.Vector3, goal: THREE.Vector3): THREE.Vector3[];
+}
+/**
+ * 路径规划器配置
+ */
+interface PathPlannerConfig {
+    debugEnabled?: boolean;
+    scene?: THREE.Scene;
+    scale?: number;
+}
+/**
+ * A*路径规划器
+ */
+declare class PathPlanner {
+    private obstacleChecker;
+    private config;
+    private debugLines;
+    private debugPoints;
+    constructor(obstacleChecker: ObstacleChecker, config?: PathPlannerConfig);
+    private heuristic;
+    findPath(start: THREE.Vector3, goal: THREE.Vector3): THREE.Vector3[];
+    /**
+     * 重建路径
+     */
+    private reconstructPath;
+    /**
+     * 路径平滑
+     */
+    private smoothPath;
+    /**
+     * 可视化路径
+     */
+    private visualizePath;
+    /**
+     * 清除路径可视化
+     */
+    clearVisualization(): void;
+    /**
+     * 更新配置
+     */
+    updateConfig(config: Partial<PathPlannerConfig>): void;
+    /**
+     * 销毁
+     */
+    dispose(): void;
+}
+
 type PlayerControllerOptions = {
     scene: THREE.Scene;
     camera: THREE.PerspectiveCamera;
@@ -16,11 +75,16 @@ type PlayerControllerOptions = {
         backwardAnim?: string;
         flyAnim?: string;
         flyIdleAnim?: string;
+        enterCarAnim?: string;
+        exitCarAnim?: string;
         scale: number;
         gravity?: number;
         jumpHeight?: number;
         speed?: number;
+        playerFlySpeed?: number;
         rotateY?: number;
+        headObjName?: string;
+        flyEnabled?: boolean;
     };
     initPos?: THREE.Vector3;
     mouseSensity?: number;
@@ -30,28 +94,75 @@ type PlayerControllerOptions = {
     isShowMobileControls?: boolean;
     thirdMouseMode?: 0 | 1 | 2 | 3;
     enableZoom?: boolean;
+    enableOverShoulderView?: boolean;
+};
+type VehicleOptions = {
+    url: string;
+    position: THREE.Vector3;
+    wheelsNames: string[];
+    scale?: number;
+    animations: {
+        openDoorAnim?: string;
+    };
+    boardingPoint: THREE.Vector3;
+    seatOffset?: THREE.Vector3;
+    chassisRatio?: number;
+    suspensionRestLengthRatio?: number;
+    followVehicleDirection?: boolean;
+    speedMultiplier?: number;
+};
+type VehicleInstance = {
+    vehicleGroup: THREE.Group;
+    chassisBody: RigidBody;
+    vehicleController: any;
+    updateWheelVisuals: () => void;
+    vehicleMixer?: THREE.AnimationMixer;
+    vehicleActions?: Map<string, THREE.AnimationAction>;
+    vehiclIsOpenDoor: boolean;
+    vehicleBBox: THREE.Box3;
+    pathPlanner: PathPlanner;
+    scale: number;
+    boardingPoint: THREE.Vector3;
+    seatOffset: THREE.Vector3;
+    enterVehicleTime: number;
+    chassisRatio: number;
+    suspensionRestLengthRatio: number;
+    size: {
+        l: number;
+        w: number;
+        h: number;
+    };
+    speedMultiplier: number;
 };
 declare function playerController(): {
     init: (opts: PlayerControllerOptions, callback?: () => void) => Promise<void>;
+    loadVehicleModel: (params: VehicleOptions) => Promise<void>;
     changeView: () => void;
     reset: (pos?: THREE.Vector3) => void;
     update: (dt?: number) => Promise<void>;
     destroy: () => void;
     setInput: (i: any) => void;
-    getposition: () => THREE.Vector3;
-    loadVehicleModel: (params: {
-        url: string;
-        position: THREE.Vector3;
-        scale?: number;
-        animations: {
-            openDoorAnim?: string;
-            wheelsTurnAnim?: string;
-            turnLeftAnim?: string;
-            turnRightAnim?: string;
-        };
-    }) => Promise<void>;
+    getPosition: () => THREE.Vector3;
+    getCenterScreenRaycastHit: () => THREE.Intersection<THREE.Object3D<THREE.Object3DEventMap>>;
+    getPerson: () => THREE.Object3D<THREE.Object3DEventMap>;
+    getActiveVehicle: () => VehicleInstance;
+    getAllVehicles: () => VehicleInstance[];
+    switchPlayerModel: (model: PlayerControllerOptions["playerModel"]) => Promise<void>;
+    setMouseSensitivity: (mouseSensity: number) => void;
+    setGravity: (gravity: number) => void;
+    setJumpHeight: (jumpHeight: number) => void;
+    setPlayerSpeed: (playerSpeed: number) => void;
+    setPlayerFlySpeed: (playerFlySpeed: number) => void;
+    setMinCamDistance: (minCamDistance: number) => void;
+    setMaxCamDistance: (maxCamDistance: number) => void;
+    setThirdMouseMode: (thirdMouseMode: 0 | 1 | 2 | 3) => void;
+    setEnableZoom: (enableZoom: boolean) => void;
+    setDebug: (debug: boolean) => void;
+    setOverShoulderView: (enable: boolean) => void;
+    setPlayerScale: (scale: number) => void;
 };
+type playerController = ReturnType<typeof playerController>;
 declare function onAllEvent(): void;
 declare function offAllEvent(): void;
 
-export { type PlayerControllerOptions, offAllEvent, onAllEvent, playerController };
+export { type PlayerControllerOptions, type VehicleInstance, type VehicleOptions, offAllEvent, onAllEvent, playerController };