LottieAnimation QML Type

用于 Qt 的 Bodymovin 播放器。更多

• 所有成员（包括继承成员）的列表

属性

• autoPlay : bool
• direction : enumeration
• endFrame : int
• frameRate : int
• loops : int
• quality : enumeration
• source : url
• startFrame : int
• status : enumeration

信号

• finished()

方法

• double getDuration(bool inFrames)
• void gotoAndPlay(int frame)
• bool gotoAndPlay(string frameMarker)
• void gotoAndStop(int frame)
• bool gotoAndStop(string frameMarker)
• void pause()
• void play()
• void start()
• void stop()
• void togglePause()

详细说明

LottieAnimation 类型用于显示 Bodymovin 格式文件。

LottieAnimation 用于加载和渲染从 Adobe After Effects 导出的 Bodymovin 文件。目前，LottieAnimation 仅支持完整 Bodymovin 规范的子集。最显著的偏差包括

• 仅支持形状层
• 只支持时间线的整数帧模式（实际帧数和时间四舍五入为最接近的整数）
• 不支持表达式

有关偏差的完整列表，请参阅限制部分。

使用示例

以下示例展示了 LottieAnimation 类型的简单用法

LottieAnimation {
    loops: 2
    quality: LottieAnimation.MediumQuality
    source: "animation.json"
    autoPlay: false
    onStatusChanged: {
        if (status === LottieAnimation.Ready) {
            // any acvities needed before
            // playing starts go here
            gotoAndPlay(startFrame);
        }
    }
    onFinished: {
        console.log("Finished playing")
    }
}

渲染性能

在内部，渲染帧数据会被缓存以提高性能。你可以通过设置 QLOTTIE_RENDER_CACHE_SIZE 环境变量（默认值为 2）来控制内存使用量。

你可以通过开启两种日志类别来监控渲染性能：

• qt.lottieqt.bodymovin.render - 提供动画渲染过程的信息
• qt.lottieqt.bodymovin.render.thread - 提供渲染过程如何进行的信息。

具体来说，你可以监控帧缓存是否持续满载，或者渲染过程是否需要等待帧准备就绪。第一种情况意味着动画过于复杂，渲染跟不上节奏。试着让动画更简单，或优化 QML 场景。

属性文档

LottieAnimation {
    source: "animation.json"
    onStatusChanged: {
        if (status === LottieAnimation.Ready)
            frameRate = 60;
    }

LottieAnimation {
    source: "animation.json"
    autoPlay: false
    onStatusChanged: {
        if (status === LottieAnimation.Ready)
            start();
    }

信号文档

方法文档