followCircle 跟随目标角色(圆形模式)

followCircle

类型: MethodDeclaration

所属类: ActorNavigator

定义位置: actor.ts

描述

跟随目标角色(圆形模式)

参数 target: 目标角色

参数 minDist: 保持最小距离

参数 maxDist: 保持最大距离

参数 offset: 跟随位置偏移[-0.8 ~ +0.8]

参数 bufferDist: 跟随缓冲距离

参数 navigate: 是否开启自动寻路

参数 bypass: 自动寻路是否绕过角色

参数 once: 跟随一次(到达位置后停止移动)

参数

参数名	类型	描述	默认值
target	Actor	-	-
minDist	number	-	-
maxDist	number	-	-
offset	number	-	n0
bufferDist	number	-	n0
navigate	boolean	-	false
bypass	boolean	-	false
once	boolean	-	false

返回值

类型: void

源代码

位置: 第 2344 行

public followCircle(
		target: Actor,
		minDist: number,
		maxDist: number,
		offset: number = 0,
		bufferDist: number = 0,
		navigate: boolean = false,
		bypass: boolean = false,
		once: boolean = false
	): void {
		if (this.mode !== "follow") {
			this.stopMoving();
			this.mode = "follow";
		} else {
			this.movementPath = null;
			this.animBufferTime = 0;
		}
		// 调整缓冲距离到合理范围
		const width = Math.max(maxDist - minDist - 0.1, 0);
		const buffer = Math.clamp(bufferDist, 0, width / 2);
		this.target = target;
		// 设置最小和最大距离(至少是最小距离 + 0.1)
		this.minDist = minDist;
		this.maxDist = Math.max(maxDist, minDist + 0.1);
		this.minDistInner = this.minDist + buffer;
		this.maxDistInner = this.maxDist - buffer;
		this.followingOffset = offset;
		this.followingNavigate = navigate;
		this.bypass = bypass;
		this.followOnce = once;
		this.followTarget = this._circleFollowTarget;
		// 设置更新函数为：跟随角色
		this.update = this.followTarget;
	}

---

文档生成时间：2026/2/1 16:51:38