SVGAPlayer-ReactNative

SVGAPlayer

Version

1.2.3

首个 SVGAPlayer - React Native 官方支持版本

使用

import SVGAPlayer from 'svgaplayer';

...
render() {
    return (
        <SVGAPlayer style={{width: 200, height: 200}} source="http://yourserver/xxx.svga" />
    )
}

参数

• source: String - SVGA 动画文件的路径，可以是 URL，或是本地 NSBundle.mainBundle / assets 文件
• loops: Int - 默认值为 0，用于指定动画循环次数，0 = 无限循环
• clearsAfterStop: Boolean - 默认值为 true，动画播放完成后，是否清空画布
• currentState: String - 用于控制 SVGA 播放状态，可设定以下值 >>> ‘start’ = 从头开始播放; ‘pause’ = 从当前位置暂停播放; ‘stop’ = ‘停止播放’; ‘clear’ = ‘停止播放并清空画布’;
• toFrame:Int - 控制当前动画停靠在某帧，如果 currentState 值为 ‘play’，则跳到该帧后继续播放动画
• toPercentage:Float - 控制当前动画停靠在某进度，如果 currentState 值为 ‘play’，则跳到该帧后继续播放动画
• onFinished:Function - 动画播放完成后，回调
• onFrame:Function(Int) - 动画播放至某帧时，回调
• onPercentage:Function(Float) - 动画播放至某进度时，回调

方法

• load(source: String) - 加载动画
• startAnimation() - 开始动画
• pauseAnimation() - 暂停动画
• stopAnimation() - 停止动画
• stepToFrame(toFrame: Int, andPlay: Boolean) - 跳到某帧，然后继续（暂停）播放动画
• stepToPercentage(toPercentage, andPlay) - 跳到某进度，然后继续（暂停）播放动画

安装

npm

npm install svgaplayer --save

iOS

Link 方式集成

在 npm install后你可以使用 react-native link svgaplayer集成

CocoaPods 方式集成

使用 CocoaPods 方式安装的前提是，React-Native 也使用 CocoaPods 进行集成。

在 Podfile 文件添加以下依赖

pod 'SVGAPlayer', :podspec => 'https://raw.githubusercontent.com/yyued/SVGAPlayer-iOS/1.1.2/SVGAPlayer-React.podspec'

pod install即可

Android

使用 Gradle 方式进行集成

在* build.gradle文件添加仓库

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

在目标 build.gradle文件添加依赖

compile 'com.github.yyued.SVGAPlayer-Android:library:1.2.3-react'
compile 'com.github.yyued.SVGAPlayer-Android:react:1.2.3-react'

同步后，添加 RCTSVGAPlayerPackage实例到 ReactInstanceManager.builder()即可。