mirror of
https://github.com/svga/SVGAPlayer-iOS.git
synced 2025-10-20 23:19:13 +08:00
105 lines
3.6 KiB
Markdown
105 lines
3.6 KiB
Markdown
# SVGAPlayer
|
|
|
|
## 2.5.0 版本
|
|
|
|
该版本增加了对遮罩图层和遮罩图片动态替换的支持。<br>
|
|
请参阅此处 [Dynamic · Matte Layer](https://github.com/yyued/SVGAPlayer-iOS/wiki/Dynamic-%C2%B7-Matte-Layer)
|
|
|
|
该版本增加了对音频进度切换的支持。
|
|
|
|
## 2.3.5 版本
|
|
|
|
该版本修正了 SVGAPlayer `clearsAfterStop 默认值为 YES`，请检查代码，修正不需要 clear 的 SVGAPlayer。
|
|
|
|
该版本修正了 SVGAPlayer 无法在 iOS 13.1 上播放异常的问题，请尽快升级。
|
|
|
|
## 介绍
|
|
|
|
`SVGAPlayer` 是一个轻量的动画渲染库。你可以使用[工具](http://svga.io/designer.html)从 `Adobe Animate CC` 或者 `Adobe After Effects` 中导出动画文件，然后使用 `SVGAPlayer` 在移动设备上渲染并播放。
|
|
|
|
`SVGAPlayer-iOS` 使用原生 CoreAnimation 库渲染动画，为你提供高性能、低开销的动画体验。
|
|
|
|
如果你想要了解更多细节，请访问[官方网站](http://svga.io/)。
|
|
|
|
## 用法
|
|
|
|
我们在这里介绍 `SVGAPlayer-iOS` 的用法。想要知道如何导出动画，点击[这里](http://svga.io/designer.html)。
|
|
|
|
### 使用 CocoaPods 安装依赖
|
|
|
|
添加依赖 'SVGAPlayer', '~> 2.3' 到 Podfile 文件中:
|
|
|
|
target 'MyApp' do
|
|
pod 'SVGAPlayer', '~> 2.3'
|
|
end
|
|
|
|
然后在终端执行 `pod install`。
|
|
|
|
### 放置 svga 文件
|
|
|
|
SVGAPlayer 可以从应用包，或者远端服务器上加载动画文件。
|
|
|
|
### 代码
|
|
|
|
#### 创建一个 `SVGAPlayer` 实例
|
|
|
|
```objectivec
|
|
SVGAPlayer *player = [[SVGAPlayer alloc] initWithFrame:CGRectMake(0, 0, 200, 200)];
|
|
[self.view addSubview:player]; // Add subview by yourself.
|
|
```
|
|
|
|
#### 创建一个 `SVGAParser` 实例，使用以下方法从应用包中加载动画。
|
|
```objectivec
|
|
SVGAParser *parser = [[SVGAParser alloc] init];
|
|
[parser parseWithNamed:@"posche" inBundle:nil completionBlock:^(SVGAVideoEntity * _Nonnull videoItem) {
|
|
|
|
} failureBlock:nil];
|
|
```
|
|
|
|
#### 创建一个 `SVGAParser` 实例，使用以下方法从远端服务器中加载动画。
|
|
|
|
```objectivec
|
|
SVGAParser *parser = [[SVGAParser alloc] init];
|
|
[parser parseWithURL:[NSURL URLWithString:@"https://github.com/yyued/SVGA-Samples/blob/master/posche.svga?raw=true"] completionBlock:^(SVGAVideoEntity * _Nullable videoItem) {
|
|
|
|
} failureBlock:nil];
|
|
```
|
|
|
|
#### 将 videoItem 赋值给 `SVGAPlayer`，然后播放动画。
|
|
|
|
```objectivec
|
|
[parser parseWithURL:[NSURL URLWithString:@"https://github.com/yyued/SVGA-Samples/blob/master/posche.svga?raw=true"] completionBlock:^(SVGAVideoEntity * _Nullable videoItem) {
|
|
if (videoItem != nil) {
|
|
player.videoItem = videoItem;
|
|
[player startAnimation];
|
|
}
|
|
} failureBlock:nil];
|
|
```
|
|
|
|
### 缓存
|
|
|
|
`SVGAParser` 使用 `NSURLSession` 请求远端数据，你需要通过以下方式缓存动画文件。
|
|
|
|
#### HTTP 结果头部信息
|
|
|
|
如果服务器返回的头部信息包含 cache-control / etag / expired 这些键值，这个请求会被合理地缓存到本地。
|
|
|
|
#### 自行缓存 NSData
|
|
|
|
如果你没有办法控制服务器返回的头部信息，你可以自行获取对应的 svga 文件 `NSData` 数据，然后使用 `SVGAParser` 解析这些数据。
|
|
|
|
## 功能示例
|
|
|
|
* [使用位图替换指定元素。](https://github.com/yyued/SVGAPlayer-iOS/wiki/Dynamic-Image)
|
|
* [在指定元素上绘制文本。](https://github.com/yyued/SVGAPlayer-iOS/wiki/Dynamic-Text)
|
|
* [隐藏指定元素。](https://github.com/yyued/SVGAPlayer-iOS/wiki/Dynamic-Hidden)
|
|
* [在指定元素上自由绘制。](https://github.com/yyued/SVGAPlayer-iOS/wiki/Dynamic-Drawer)
|
|
|
|
## APIs
|
|
|
|
请参阅此处 [https://github.com/yyued/SVGAPlayer-iOS/wiki/APIs](https://github.com/yyued/SVGAPlayer-iOS/wiki/APIs)
|
|
|
|
## CHANGELOG
|
|
|
|
请参阅此处 [CHANGELOG](./CHANGELOG.md)
|