获取依赖

Android:

implementation 'io.github.galacean:effects:0.0.1.202311221223'

iOS:

pod 'GalaceanEffects'

开始使用

最低系统版本：

• Android 6.0 及以上
• iOS 11 及以上

线程模型：

• 所有方法应在 UI 线程调用。
• 所有回调都在 UI 线程。
• iOS 回调中应避免强引用

1. 创建 Player

Android:

GEPlayer.GEPlayerParams params = new GEPlayer.GEPlayerParams();
params.url = "https://xxx"; // 或包内文件: "assets://yourFilePath"
player = new GEPlayer(context, params);

iOS:

GEPlayerParams *params = [[GEPlayerParams alloc] init];
params.url = @"https://xxx"; // 或包内文件: "assets://yourFilePath"
player = [[GEPlayer alloc] initWithParams:params];

1.1. 构造参数说明

目前支持的属性：

• url：动画资源url链接
• downgradeImage【可选】：Bitmap/UIImage 类型，创建失败或运行时异常的降级图。
• variables【可选】：数据模版 map，key 是数据模版的 key，value 是替换的图片 url 或文本内容
• variablesBitmap【可选】：数据模版 map，key 是数据模版的 key，value 是替换的Bitmap/UIImage 类型的图片

2. 加载动画资源

Android:

player.loadScene(new GEPlayer.Callback() {
    @Override
    public void onResult(boolean success, String errorMsg) {
    }
});

iOS:

[player loadScene:^(bool success, NSString * errorMsg) {
}];

3. 获取动画宽高比

Android:

player.getAspect();

iOS:

[player getAspect];

4. 获取动画总帧数

Andriod:

player.getFrameCount();

iOS:

[player getFrameCount];

5. 播放

Android:

// 完整播放
player.play(repeatCount, new GEPlayer.Callback() {
    @Override
    public void onResult(boolean success, String errorMsg) {
    }
});
// 区间播放
player.play(fromFrame, toFrame, repeatCount, new GEPlayer.Callback() {
    @Override
    public void onResult(boolean success, String errorMsg) {
    }
});

iOS:

// 完整播放
[player playWithRepeatCount:repeatCount
 				   Callback:^(bool success, NSString * errorMsg) {
}];
// 区间播放
[player playWithFromFrame:fromFrame
 				  ToFrame:toFrame
              RepeatCount:repeatCount
              	 Callback:^(bool success, NSString * errorMsg) {
}];

5.1. 参数说明

• fromFrame【可选】：播放起始帧，闭区间
• toFrame【可选】：播放结束帧，闭区间
• repeatCount：重复次数。-1 表示一直播放；0 表示不循环，只播放一次
• callback：播放完成回调

5.2. 回调说明

• success：是否完成播放

• 如果是循环播放，只会在最后一轮播放结束后回调

• errorMsg：如果播放失败，或播放中出现异常，这里返回错误信息

6. 播放控制

Android:

// 暂停
player.pause();
// 恢复
player.resume();
// 停止
player.stop();

iOS:

// 暂停
[player pause];
// 恢复
[player resume];
// 停止
[player stop];

7. 销毁

Android:

player.destroy();
player = null;

iOS:

[player destroy];
player = nil;

生命周期