Cocos Creator
缓动接口
Tween 属性和接口说明
接口说明
接口 | 功能说明 |
---|---|
tag | 为当前缓动添加一个数值类型(number )的标签 |
to | 添加一个对属性进行 绝对值 计算的间隔动作 |
by | 添加一个对属性进行 相对值 计算的间隔动作 |
set | 添加一个 直接设置目标属性 的瞬时动作 |
delay | 添加一个 延迟时间 的瞬时动作 |
call | 添加一个 调用回调 的瞬时动作 |
target | 添加一个 直接设置缓动目标 的瞬时动作 |
union | 将上下文的缓动动作打包成一个 |
then | 插入一个 Tween 到缓动队列中 |
repeat | 执行几次(此前为重复几次,请及时适配) |
repeatForever | 一直重复执行 |
sequence | 添加一个顺序执行的缓动 |
parallel | 添加一个同时进行的缓动 |
start | 启动缓动 |
stop | 停止缓动 |
clone | 克隆缓动 |
show | 启用节点链上的渲染,缓动目标需要为 Node |
hide | 禁用节点链上的渲染,缓动目标需要为 Node |
removeSelf | 将节点移出场景树,缓动目标需要为 Node |
静态接口说明
这些方法为 Tween
的静态方法,调用方式示例:
ts
Tween.stopAll()
Tween.stopAllByTag(0);
Tween.stopAllByTarget(this.node);
接口 | 功能说明 |
---|---|
stopAll | 停止所有缓动 该接口会移除底层所有已注册的缓动动画 注意:该方法会影响所有对象 |
stopAllByTag | 停止所有指定标签的缓动 该接口将移除通过 tag 方法指定的所有缓动 可通过指定第二个参数 target?: object 来指定是否仅移除该对象上带有某个标签的缓动 |
stopAllByTarget | 停止所有指定对象的缓动 |
工具函数说明
接口 | 功能说明 |
---|---|
tween<T> | 这是一个工具函数,帮助实例化 Tween 类 注意:该方法并非 Tween 类的成员,开发者也可自行调用 new Tween<T>(target:T) 的方式实例化缓动。 |
示例
这里以一个的 to
缓动动画作为示例演示缓动的用法:
ts
let tweenDuration : number = 1.0; // 缓动的时长
tween(this.node.position).to( tweenDuration, new Vec3(0, 10, 0), // 这里以node的位置信息坐标缓动的目标
{ // ITweenOption 的接口实现:
onUpdate : (target:Vec3, ratio:number)=>{ // onUpdate 接受当前缓动的进度
this.node.position = target; // 将缓动系统计算出的结果赋予 node 的位置
}
}).start(); // 调用 start 方法,开启缓动
更多示例可查看 缓动示例
一些限制
为了降低更新 Node Transform
信息的频率,Node
内部维护了一个 dirty
状态,只有在调用了可能会改变 Node Transform
信息的接口,才会将 dirty
置为需要更新的状态。
但目前的接口存在一定的限制,例如:通过 this.node.position
获取到的 position
是一个通用的 Vec3
。
当执行 this.node.position.x = 1
这段代码的时候,只执行了 position
的 getter
,并没有执行 position
的 setter
。由于 dirty
并没有更新,便会导致渲染时使用的节点的 Transform
信息没有更新。
目前,我们也不支持这样的调用,而是鼓励使用 setPosition
或 position
的 setter
,如下所示:
typescript
let _pos = new Vec3(0, 1, 0);
this.node.position = _pos; // 这里将通过 position 的 setter
this.node.setPosition(_pos); // 这里将通过接口 setPosition