@cc-component/cc-pathfinding 1.0.8 → 1.0.9

package/assets/pathfinding/Interface.ts

@@ -64,8 +64,10 @@ declare global {
          * @param allowOverlap 为 true 时该单位进入"允许重叠"模式，
          * 与其他同样开启该开关的单位可以走到同一格（互相穿过，不再互相绕行/互相等待），
          * 与终点是否相同无关
+         * @param moveDuration 本次移动的"单格移动时长"，单位秒（越小越快）；
+         * 不传或传 <= 0 时使用 InitMovementController 配置的默认值
          */
-        export function MoveTo(playerNode: Node, target: { row: number, col: number }, attackDistance: AttackDistance, openColor: boolean, callBack?: () => void, allowOverlap?: boolean): void
+        export function MoveTo(playerNode: Node, target: { row: number, col: number }, attackDistance: AttackDistance, openColor: boolean, callBack?: () => void, allowOverlap?: boolean, moveDuration?: number): void
         /** 取消移动 */
         export function CancelMove(playerNode: Node, preserveCurrent?: boolean): void
         /** 销毁移动控制器 */

package/assets/pathfinding/base/GridMovementController.ts

@@ -58,8 +58,9 @@ export class GridMovementController {
      * allowOverlap：为 true 时该单位进入"允许重叠"模式，
      * 与其他同样开启该开关的单位可以走到同一格（互相穿过、不互相绕行、不互相等待），
      * 与终点是否相同无关；未开启的单位之间、以及开启与未开启之间仍保持互斥。
+     * moveDuration：本次移动的"单格移动时长"，单位秒；不传或传非法值时用控制器的默认值。
      */
-    moveTo(playerNode: Node, target: Cell, attackDistance: AttackDistance, openColor: boolean, callBack?: () => void, allowOverlap = false): void {
+    moveTo(playerNode: Node, target: Cell, attackDistance: AttackDistance, openColor: boolean, callBack?: () => void, allowOverlap = false, moveDuration?: number): void {
         const start = this.getPosition(playerNode);
         if (start.row === target.row && start.col === target.col) {
             return;
@@ -68,13 +69,13 @@ export class GridMovementController {
         this.cancel(playerNode, true);
         const route = this.traceRoute(start, target, attackDistance, openColor, allowOverlap, this.movementOwners.get(playerNode));
         if (!route || route.length === 0 || this.isPathBlocked(start, target, route, attackDistance)) {
-            this.retryPathfinding(playerNode, target, attackDistance, openColor, callBack, allowOverlap);
+            this.retryPathfinding(playerNode, target, attackDistance, openColor, callBack, allowOverlap, moveDuration);
             return;
         }
 
         this.clearPathfindingRetry(playerNode);
         route.shift();
-        this.startMovement(playerNode, route, start, target, attackDistance, openColor, callBack, allowOverlap);
+        this.startMovement(playerNode, route, start, target, attackDistance, openColor, callBack, allowOverlap, moveDuration);
     }
 
     /** 强制中止当前移动，可选择保留当前格子的临时占用。 */
@@ -121,7 +122,7 @@ export class GridMovementController {
      * 执行逐格移动。
      * 每次移动前会尝试保留下一格，失败说明被占用，就重新规划路径或延时重试。
      */
-    private startMovement(playerNode: Node, route: Cell[], start: Cell, target: Cell, attackDistance: AttackDistance, openColor: boolean, callBack?: () => void, allowOverlap = false): void {
+    private startMovement(playerNode: Node, route: Cell[], start: Cell, target: Cell, attackDistance: AttackDistance, openColor: boolean, callBack?: () => void, allowOverlap = false, moveDuration?: number): void {
         const previousOwner = this.movementOwners.get(playerNode);
         if (previousOwner) {
             this.pathState.release(previousOwner);
@@ -130,6 +131,8 @@ export class GridMovementController {
         this.movementOwners.set(playerNode, owner);
         const shareToken = this.getShareToken(allowOverlap);
         this.pathState.reserveCurrent(start, owner, shareToken);
+        // 单格移动时长：本次指定优先，否则用控制器默认值
+        const duration = this.resolveMoveDuration(moveDuration);
         const version = this.bumpVersion(playerNode);
         let previous = start;
         let index = 0;
@@ -194,7 +197,7 @@ export class GridMovementController {
             }
 
             tween(playerNode)
-                .to(this.moveDuration, { worldPosition: PathfindingModule.GetMapPosition(next.row, next.col) })
+                .to(duration, { worldPosition: PathfindingModule.GetMapPosition(next.row, next.col) })
                 .call(() => {
                     this.pathState.completeMove(previous, next, owner, shareToken);
                     this.positions.set(playerNode, { row: next.row, col: next.col });
@@ -231,12 +234,17 @@ export class GridMovementController {
         return allowOverlap ? GridMovementController.OVERLAP_TOKEN : null;
     }
 
+    /** 单格移动时长：未指定或非法时回退到控制器默认值（单位秒） */
+    private resolveMoveDuration(moveDuration?: number): number {
+        return (typeof moveDuration === 'number' && moveDuration > 0) ? moveDuration : this.moveDuration;
+    }
+
     /** 路径规划失败时，做一次延迟重试，避免因为瞬时占用导致立刻失败。 */
-    private retryPathfinding(playerNode: Node, target: Cell, attackDistance: AttackDistance, openColor: boolean, callBack?: () => void, allowOverlap = false): void {
+    private retryPathfinding(playerNode: Node, target: Cell, attackDistance: AttackDistance, openColor: boolean, callBack?: () => void, allowOverlap = false, moveDuration?: number): void {
         this.clearPathfindingRetry(playerNode);
         const retry = () => {
             this.clearPathfindingRetry(playerNode);
-            this.moveTo(playerNode, target, attackDistance, openColor, callBack, allowOverlap);
+            this.moveTo(playerNode, target, attackDistance, openColor, callBack, allowOverlap, moveDuration);
         };
         this.movementRetryCallbacks.set(playerNode, retry);
         this.scheduler.scheduleOnce(retry, this.retryDelay);

package/assets/pathfinding/base/PathfindingModule.ts

@@ -46,9 +46,11 @@ export class PathfindingModule {
      * allowOverlap：为 true 时该单位进入"允许重叠"模式，
      * 与其他同样开启该开关的单位可以走到同一格（互相穿过，不再互相绕行/互相等待），
      * 与终点是否相同无关；未开启的单位之间、以及开启与未开启之间仍保持互斥。
+     * moveDuration：本次移动的"单格移动时长"，单位秒（数字越小走得越快）。
+     * 不传或传 <= 0 时使用 InitMovementController 配置的默认值。
      */
-    static MoveTo(playerNode: Node, target: { row: number, col: number }, attackDistance: AttackDistance, openColor: boolean, callBack?: () => void, allowOverlap = false): void {
-        this.movementController?.moveTo(playerNode, target, attackDistance, openColor, callBack, allowOverlap);
+    static MoveTo(playerNode: Node, target: { row: number, col: number }, attackDistance: AttackDistance, openColor: boolean, callBack?: () => void, allowOverlap = false, moveDuration?: number): void {
+        this.movementController?.moveTo(playerNode, target, attackDistance, openColor, callBack, allowOverlap, moveDuration);
     }
 
     static CancelMove(playerNode: Node, preserveCurrent = false): void {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cc-component/cc-pathfinding",
-    "version": "1.0.8",
+    "version": "1.0.9",
     "engine": ">=3.8.6",
     "description": "系统组件添加常用扩展方法",
     "main": "index.ts",