【亲测免费】 SVGAPlayer-iOS 使用指南

1. 项目介绍

SVGAPlayer-iOS 是一个轻量级的动画渲染器，它允许你在iOS应用中播放由Adobe Animate CC或Adobe After Effects导出的.svga文件格式的动画。通过利用iOS的CoreAnimation框架，SVGAPlayer提供了一种高性能、低资源消耗的动画体验。若需了解更多详细信息，可以访问官方网站。

2. 项目快速启动

安装

CocoaPods

将以下代码添加至你的Podfile中的相应目标:

target 'YourTargetName' do
  pod 'SVGAPlayer', '~> 2.3'
end

然后，在终端执行：

pod install

示例使用

导入必要的库并创建SVGAPlayer实例：

import SVGAPlayer

class ViewController: UIViewController {
    var player: SVGAPlayer!

    override func viewDidLoad() {
        super.viewDidLoad()
        
        player = SVGAPlayer(frame: CGRect(x: 100, y: 100, width: 100, height: 100))
        player.loops = 1
        player.clearsAfterStop = false
        player.delegate = self
        view.addSubview(player)
        
        // 加载SVGA文件
        if let path = Bundle.main.path(forResource: "animation_name", ofType: "svga") {
            player.videoItem = SVGAParser.parse(withFileAtPath: path)
            player.startAnimation()
        }
    }
}

3. 应用案例与最佳实践

• 动态调整播放区间：可以通过startAnimationWithRange:reverse:方法控制动画播放特定的片段。
• 循环播放：设置loops为大于零的值，实现无限循环播放。
• 监听事件：通过遵循SVGAPlayerDelegate协议，实现播放过程中的状态回调。

extension ViewController: SVGAPlayerDelegate {
    func svgaPlayer(_ svgaPlayer: SVGAPlayer, didStopAt frameIndex: Int, reason: SVGAPlayerStoppedReason) {
        switch reason {
        case .userStopped:
            print("用户停止")
        case .animationFinished:
            print("动画完成")
        default:
            break
        }
    }
}

4. 典型生态项目

• SVGAEditor: 用于创建和编辑.svga文件的桌面应用。
• SVGAParser: 解析.svga文件以供SVGAPlayer使用的库。
• SVGAFramework: 提供更底层支持的动画框架，可用于自定义实现。

此外，社区还提供了如SVGAExPlayer这样的增强版播放器，增加了更多的特性和便利性，比如动态播放区间控制，静音，反转播放等功能。

请注意，本教程基于SVGAPlayer-iOS的官方仓库，对于最新的更新和附加特性，请查看GitHub仓库的最新说明和示例代码。