THING.Sequence API 文档

简介

THING.Sequence 是一个用于处理序列帧动画的类，继承自 THING.Object3D。它提供了播放、暂停、停止等控制序列动画的方法，以及调整动画进度、播放速率等属性。

构造函数

Sequence(param)

创建一个序列帧动画对象。

参数:

• param (Object): 创建序列帧动画时的参数对象。

属性

type (只读)

获取对象类型，返回值为 "Sequence"。

progress

• 获取或设置动画的当前进度（0.0 到 1.0 之间）。
• 类型: Number

complete

• 获取或设置动画是否已完成。
• 类型: Boolean

playRate

• 获取或设置动画的播放速率。
• 类型: Number

sensor

• 获取或设置传感器的宽度和高度。
• 类型: Array

endTime (只读)

获取动画的结束时间。

currentTime

• 获取当前动画的时间。
• 类型: Number

currentProgress

• 获取当前动画的进度。
• 类型: Number

方法

play()

播放序列动画。

pause()

暂停序列动画。

stop()

停止序列动画。

playLooping()

循环播放序列动画。

playReverse()

反向播放序列动画。

playReverseLoop(loopNum)

反向循环播放序列动画。

参数:

• loopNum (Number): 循环播放的次数，默认为 -1，表示无限循环。

使用示例

// 获取一个序列帧动画对象
let sequence = app.query("Sequence")[0];

// 设置动画进度
sequence.progress = 0.5;

// 获取动画是否已完成
let isComplete = sequence.complete;

// 设置动画播放速率
sequence.playRate = 2.0;

// 设置传感器尺寸
sequence.sensor = [36, 24];

// 播放动画
sequence.play();

// 暂停动画
sequence.pause();

// 停止动画
sequence.stop();

// 循环播放动画
sequence.playLooping();

// 反向播放动画
sequence.playReverse();

// 反向循环播放动画，循环3次
sequence.playReverseLoop(3);

请注意，以上代码示例假设 THING 库已经被正确引入和初始化。实际使用时，需要根据实际情况调整引入路径和方法。

效果图