LottieAnimation QML 类型

Qt 的 Bodymovin 播放器。 更多...

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

属性

• autoPlay : bool
• direction : 枚举类型
• endFrame : int
• frameRate : int
• loops : int
• quality : 枚举类型
• source : url
• startFrame : int
• status : 枚举类型

信号

• 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 文件。当前，仅支持 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();
    }

信号文档

方法文档