translate 角色朝指定角度位移一段距离

translate

类型: MethodDeclaration

所属类: Actor

定义位置: actor.ts

描述

角色朝指定角度位移一段距离

参数 angle: 位移角度(弧度)

参数 distance: 位移距离(单位:图块)

参数 easingId: 过渡曲线ID

参数 duration: 持续时间(毫秒)

参数 key: 位移更新器的键(指定以避免冲突)

参数

参数名	类型	描述	默认值
angle	number	-	-
distance	number	-	-
easingId	string	-	''
duration	number	-	n0
key	string	-	'translate'

返回值

类型: void

源代码

位置: 第 681 行

public translate(angle: number, distance: number, easingId: string = '', duration: number = 0, key: string = 'translate'): void {
    const distX = distance * Math.cos(angle)
    const distY = distance * Math.sin(angle)
    if (duration > 0) {
      // 创建过渡更新器，使用set方法:
      // 如果已有同名更新器，则替换
      let elapsed = 0
      let lastTime = 0
      const easing = Easing.get(easingId)
      this.updaters.set(key, {
        protected: true,
        update: deltaTime => {
          // 更新中不断设置角色位置
          elapsed += deltaTime
          const time = easing.get(elapsed / duration)
          const increase = time - lastTime
          const x = distX * increase
          const y = distY * increase
          this.move(x, y)
          lastTime = time
          // 过渡结束，延迟删除更新器
          if (elapsed >= duration) {
            this.updaters.deleteDelay(key)
          }
        }
      })
    } else {
      // 立即执行
      this.updaters.deleteDelay(key)
      const x = this.x + distX
      const y = this.y + distY
      this.setPosition(x, y)
    }
  }

---

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