Android -Lottie加载动画喂饭指南

简单的说,Lottie就是airbnb开源的一个使用json文件快速加载动画且支持多平台的库。

更多介绍请查看官网。官网地址:https://airbnb.design/lottie/

怎么使用Lottie

在项目的build.gradle文件中直接添加依赖:

dependencies {
  implementation 'com.airbnb.android:lottie:$lottieVersion'
}

image.gif

这里需要注意的是,lottie最低支持API 16,Lottie版本2.8.0及其以上升级了androidx,本篇文章主要介绍2.7.0的使用方法。

关于最新版本请查看lottie的GitHub地址:https://github.com/airbnb/lottie-android,现在最新版本号已经到了3.4.0,版本更新有些快。

加载动画方式

使用资产文件(src/main/assets)

将json文件和image文件夹放到资产文件下方,代码加载:

lottieAnimationView.setImageAssetsFolder(imagesPath);
lottieAnimationView.setAnimation(jsonPath);
lottieAnimationView.playAnimation();

image.gif

或者只使用json文件可在xml文件中直接加载:

<com.airbnb.lottie.LottieAnimationView      
    android:id="@+id/lottieAnimationView"    
    android:layout_width="wrap_content"    
    android:layout_height="wrap_content"    
    app:lottie_fileName="test.json"   
    app:lottie_loop="true"   
    app:lottie_autoPlay="true" />
image.gif

使用服务器json文件

LottieComposition.Factory
         .fromJson(getResources(), json, new OnCompositionLoadedListener() {
          @Override
          public void onCompositionLoaded(LottieComposition composition) {
             lottieAnimationView.setComposition(composition);
             lottieAnimationView.playAnimation();
  }
});
image.gif

使用服务器上zip文件

1、直接网络加载:

lottieAnimationView.setAnimationFromUrl(ZIPURL);
lottieAnimationView.playAnimation();
image.gif

2、下载zip文件本地解压加载

关于文件下载这里就不多介绍了,网络上有很多介绍。下载zip文件之后我们要进行解压缩:

/** 
 * 解压assets的zip压缩文件到指定目录(包含子目录) 
 * @param zipFileName 压缩文件名 
 * @param outputDirectory 输出目录 
 * @throws IOException 
 */
 public static void unZip(String zipFileName, String outputDirectory) {
        ZipFile zipFile = null;
        try {
            zipFile = new ZipFile(zipFileName);
            Enumeration e = zipFile.entries();
            ZipEntry zipEntry;
            File dest = new File(outputDirectory);
            dest.mkdirs();
            while (e.hasMoreElements()) {
                zipEntry = (ZipEntry) e.nextElement();
                String entryName = zipEntry.getName();
                InputStream in = null;
                FileOutputStream out = null;
                try {
                    if (zipEntry.isDirectory()) {
                        String name = zipEntry.getName();
                        name = name.substring(0, name.length() - 1);

                        File f = new File(outputDirectory + File.separator
                                + name);
                        f.mkdirs();
                    } else {
                        int index = entryName.lastIndexOf("\\");
                        if (index != -1) {
                            File df = new File(outputDirectory + File.separator
                                    + entryName.substring(0, index));
                            df.mkdirs();
                        }
                        index = entryName.lastIndexOf("/");
                        if (index != -1) {
                            File df = new File(outputDirectory + File.separator
                                    + entryName.substring(0, index));
                            df.mkdirs();
                        }
                        File f = new File(outputDirectory + File.separator
                                + zipEntry.getName());
                        in = zipFile.getInputStream(zipEntry);
                        out = new FileOutputStream(f);

                        int c;
                        byte[] by = new byte[1024];

                        while ((c = in.read(by)) != -1) {
                            out.write(by, 0, c);
                        }
                        out.flush();
                    }

                } catch (IOException ex) {
                    ex.printStackTrace();
                    Log.e("unZip", "解压失败:" + ex.toString());
                    UnAnimationZipFinshEvent.post("Zip.class", false,null);
                } finally {
                    if (in != null) {
                        in.close();
                    }
                    if (out != null) {
                        out.close();
                    }
                }
            }
            Log.e("unZip", "解压成功");
            UnAnimationZipFinshEvent.post("Zip.class", true,outputDirectory);
            deleteDir(new File(zipFileName));
        } catch (IOException ex) {
            ex.printStackTrace();
            Log.e("unZip", "解压失败:" + ex.toString());
            UnAnimationZipFinshEvent.post("Zip.class", false,null);
        } finally {
            if (zipFile != null) {
                try {
                    zipFile.close();
                } catch (IOException ex) {
                    ex.printStackTrace();
                }
            }
        }
    }

image.gif
/** 
 * 删除整个文件夹 或者 文件 
 */
private static void deleteDir(File file) {    
    if (!file.exists()) {        
        return;    
    }    
    if (file.isDirectory()) {        
        File[] childFiles = file.listFiles();        
        if (childFiles == null || childFiles.length == 0) {            
            file.delete();        
        }        
        for (File childFile : childFiles) {            
             deleteDir(childFile);        
        }    
    }    
    file.delete();
}
image.gif

使用Lottie加载本地动画资源:

/** 
 *  加载本地动画资源 
 * @param lottieAnimationView 展示动画view 
 * @param imagesPath  本地动画资源图片地址 
 * @param dataPath    本地动画资源json数据地址 
 */
public static void loadLottie(LottieAnimationView lottieAnimationView,String imagesPath,String dataPath){
        // 动效图片资源
        final File imagesFiles = new File(imagesPath);
        // data.json路径
        final File jsonFile = new File(dataPath);
        if (!jsonFile.exists() || !imagesFiles.exists()) {
            Log.e("lottieUtils", "动画资源不存在");
            return;
        }

        try {
            FileInputStream fis = new FileInputStream(jsonFile);

            final String absolutePath = imagesFiles.getAbsolutePath();
            // 开启硬件加速
            lottieAnimationView.useHardwareAcceleration(true);
            // 设置动画文件夹代理类
            lottieAnimationView.setImageAssetDelegate(new ImageAssetDelegate() {
                @Override
                public Bitmap fetchBitmap(LottieImageAsset asset) {
                    BitmapFactory.Options opts = new BitmapFactory.Options();
                    opts.inScaled = true;
                    Bitmap bitmap = null;
                    try {
                        bitmap = BitmapFactory.decodeFile(absolutePath + File.separator + asset.getFileName(), opts);
                    } catch (Exception e) {
                        e.printStackTrace();
                    }
                    return bitmap;
                }
            });

            // 设置动画
            LottieComposition.Factory.fromInputStream(fis, new OnCompositionLoadedListener() {
                @Override
                public void onCompositionLoaded(@Nullable LottieComposition composition) {
                    lottieAnimationView.setComposition(composition);
                    lottieAnimationView.playAnimation();
                    try {
                        fis.close();
                    } catch (IOException e) {
                        e.printStackTrace();
                    }

                }
            });
        } catch (FileNotFoundException e) {
            e.printStackTrace();
        }

    }
image.gif

另外,我们在下载动画资源到本地之后,手机相册会自动扫描到,这样相册里会有很多动画分解的图片,一是对于相册展示不太好,二是用户有可能会删除某张分解动画的图片。所以,这里简单介绍下一下2种避免图片自动扫描到相册的方法:

1、创建隐藏文件夹存放动画资源,只需要在文件名前加. (例如:.lottie)。

2、在存储动画资源的文件的文件夹下添加.nomedia 文件,告诉系统改文件夹下没有多媒体 文件。

常用API

成功和失败监听

LottieCompositionFactory.fromUrl(this,ZIPURL)        
         .addFailureListener(new LottieListener<Throwable>() {            
           @Override            
           public void onResult(Throwable result) {                
                // TODO: 添加加载失败逻辑             
            }        
        }).addListener(new LottieListener<LottieComposition>() {    
           @Override    
           public void onResult(LottieComposition result) {        
               lottieAnimationView.setComposition(result);        
               lottieAnimationView.playAnimation();    
       }
});
image.gif

动画进度监听

lottieAnimationView.addAnimatorUpdateListener(new ValueAnimator.AnimatorUpdateListener() {    
        @Override    
        public void onAnimationUpdate(ValueAnimator valueAnimator) { 
         if (valueAnimator.getAnimatedFraction() == 0 ){    
            //动画开始
          }else if (valueAnimator.getAnimatedFraction() == 1f){    
            //动画结束}          }
    }
);
image.gif

也可以使用下边监听:

lottieAnimationView.addAnimatorListener(new Animator.AnimatorListener() {    
    @Override    
    public void onAnimationStart(Animator animator) {    
    //动画开始
    }    
    @Override    
    public void onAnimationEnd(Animator animator) {
    //动画结束    
    }    
    @Override    
    public void onAnimationCancel(Animator animator) {
    //动画取消    
    }    
    @Override    
    public void onAnimationRepeat(Animator animator) {
    //动画重复    
    }
});
image.gif

自动播放

lottie_autoPlay="true"
image.gif

循环播放

app:lottie_loop="true"
image.gif

或者

lottieAnimationView.loop(true);
image.gif

播放

lottieAnimationView.playAnimation();
image.gif

暂停播放

lottieAnimationView.pauseAnimation();
image.gif

取消播放

lottieAnimationView.cancelAnimation();
image.gif
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 211,743评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,296评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,285评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,485评论 1 283
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,581评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,821评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,960评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,719评论 0 266
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,186评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,516评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,650评论 1 340
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,329评论 4 330
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,936评论 3 313
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,757评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,991评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,370评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,527评论 2 349

推荐阅读更多精彩内容