Skip to main content

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

followCircle​

类型: MethodDeclaration

所属类: ActorNavigator

定义位置: actor.ts

描述​

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

参数 target: 目标角色

参数 minDist: 保持最小距离

参数 maxDist: 保持最大距离

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

参数 bufferDist: 跟随缓冲距离

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

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

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

参数​

参数名类型描述默认值
targetActor--
minDistnumber--
maxDistnumber--
offsetnumber-n0
bufferDistnumber-n0
navigateboolean-false
bypassboolean-false
onceboolean-false

返回值​

类型: void

源代码​

位置: 第 2165 行

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
  }

文档生成时间：2025/7/7 12:07:06