音视频开发之旅(62) -Lottie 源码分析之json解析

2024-06-12 06:18

本文主要是介绍音视频开发之旅(62) -Lottie 源码分析之json解析,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

目录

  1. Lottie能做什么
  2. Lottie 动画使用调用流程
  3. Json字段介绍
  4. 解析为LottieComposition
  5. 资料
  6. 总结

一、Lottie能做什么

在实现动画方面,原生的方式开发成本比较高,airbnb开源的lottie有Android、iOS、RN等多个版本的支持,设计师通过AE设计好动画后,通过AE插件Bodymovin导出json和素材文件。

可以上 https://lottiefiles.com/popular 看看一些流行的 Lottie 动效

客户端通过加载解析渲染播放 即可实现对应的动画效果,这个思路和设计非常值得学习借鉴。接下来两篇我们对其进行学习分析,欢迎讨论交流。

二、Lottie 动画使用调用流程

Lottie 的动画调用流程

1. 创建LottieAnimationView
2. 创建LottieDrawable
3. 解析json文件为LottieComposition对象
4. lottieDrawable.setComposition(lottieComposition)lottieAnimationView.setImageDrawable(lottieDrawable)
5. 播放动画playAnimation()
在onValueChanged时,各个创建好的Drawable会根据需求进行重绘,达到动画的效果。

对于开发者使用非常简单, 可以参考lottie源码中sample的使用。

三、Json字段介绍

我们以Lottie-android提供的demo中的AndroidWave.json和anima.json 为例来学习
object

下面我们看下assets中的字段
object->assets:资源

可以看到object中有layers ,assets中也可能有layers,那边layers这个图层字段包含了什么信息呐。
object->layers:图层

object->layers->ty:图层类型

object->layers->ks:图层变换

“o 、r、 p、 a、 s”中字段相同,都是a、k、x、ix 下面对a、k做说明。x、ix也不知道什么用处。
object->layers->ks-> o 、r、 p、 a、 s

Lottie json的字段基本解释完,下面我们结合Lottie-android的源码看下解析为LottieComposition的过程

四、 解析为LottieComposition

json的解析器,解析为LottieComposition对象

 

4.1 LottieComposition解析的过程

LottieComposition对象

json的解析器,解析为LottieComposition对象

//lottie json的解析器,解析为LottieComposition对象
public class LottieCompositionMoshiParser {private static final JsonReader.Options NAMES = JsonReader.Options.of("w", // 0"h", // 1"ip", // 2"op", // 3"fr", // 4"v", // 5"layers", // 6"assets", // 7"fonts", // 8"chars", // 9"markers" // 10);public static LottieComposition parse(JsonReader reader) throws IOException {float scale = Utils.dpScale();float startFrame = 0f;float endFrame = 0f;float frameRate = 0f;final LongSparseArray<Layer> layerMap = new LongSparseArray<>();final List<Layer> layers = new ArrayList<>();int width = 0;int height = 0;Map<String, List<Layer>> precomps = new HashMap<>();Map<String, LottieImageAsset> images = new HashMap<>();Map<String, Font> fonts = new HashMap<>();List<Marker> markers = new ArrayList<>();SparseArrayCompat<FontCharacter> characters = new SparseArrayCompat<>();LottieComposition composition = new LottieComposition();reader.beginObject();while (reader.hasNext()) {switch (reader.selectName(NAMES)) {case 0:width = reader.nextInt();break;case 1:height = reader.nextInt();break;case 2:startFrame = (float) reader.nextDouble();break;case 3:endFrame = (float) reader.nextDouble() - 0.01f;break;case 4:frameRate = (float) reader.nextDouble();break;case 5:String version = reader.nextString();String[] versions = version.split("\\.");int majorVersion = Integer.parseInt(versions[0]);int minorVersion = Integer.parseInt(versions[1]);int patchVersion = Integer.parseInt(versions[2]);if (!Utils.isAtLeastVersion(majorVersion, minorVersion, patchVersion,4, 4, 0)) {composition.addWarning("Lottie only supports bodymovin >= 4.4.0");}break;case 6://重点看下parseLayers的实现parseLayers(reader, composition, layers, layerMap);break;case 7:parseAssets(reader, composition, precomps, images);break;case 8:parseFonts(reader, fonts);break;case 9:parseChars(reader, composition, characters);break;case 10:parseMarkers(reader, markers);break;default:reader.skipName();reader.skipValue();}}// w、h会根据像素密度自动适配int scaledWidth = (int) (width * scale);int scaledHeight = (int) (height * scale);Rect bounds = new Rect(0, 0, scaledWidth, scaledHeight);//json内容解析完之后,调用composition的init进行LottieComposition字段的赋值,完成json对LottieComposition的工作composition.init(bounds, startFrame, endFrame, frameRate, layers, layerMap, precomps,images, characters, fonts, markers);return composition;}private static void parseLayers(JsonReader reader, LottieComposition composition,List<Layer> layers, LongSparseArray<Layer> layerMap) throws IOException {int imageCount = 0;reader.beginArray();//遍历解析每个layer图层,while (reader.hasNext()) {//图层解析Layer layer = LayerParser.parse(reader, composition);if (layer.getLayerType() == Layer.LayerType.IMAGE) {imageCount++;}//加入到layers和map提高效率layers.add(layer);layerMap.put(layer.getId(), layer);}reader.endArray();}

4.2 layers图层的解析过程

被解析为Layer对象

通过LayerParser把json中layers解析为Layer对象

//通过LayerParser把json中layers解析为Layer对象
public class LayerParser {//对应 json中layers的字段private static final JsonReader.Options NAMES = JsonReader.Options.of("nm", // 0"ind", // 1"refId", // 2"ty", // 3"parent", // 4"sw", // 5"sh", // 6"sc", // 7"ks", // 8"tt", // 9"masksProperties", // 10"shapes", // 11"t", // 12"ef", // 13"sr", // 14"st", // 15"w", // 16"h", // 17"ip", // 18"op", // 19"tm", // 20"cl", // 21"hd" // 22);private static final JsonReader.Options TEXT_NAMES = JsonReader.Options.of("d","a");private static final JsonReader.Options EFFECTS_NAMES = JsonReader.Options.of("ty","nm");public static Layer parse(JsonReader reader, LottieComposition composition) throws IOException {// This should always be set by After Effects. However, if somebody wants to minify// and optimize their json, the name isn't critical for most cases so it can be removed.String layerName = "UNSET";Layer.LayerType layerType = null;String refId = null;long layerId = 0;int solidWidth = 0;int solidHeight = 0;int solidColor = 0;int preCompWidth = 0;int preCompHeight = 0;long parentId = -1;float timeStretch = 1f;float startFrame = 0f;float inFrame = 0f;float outFrame = 0f;String cl = null;boolean hidden = false;BlurEffect blurEffect = null;DropShadowEffect dropShadowEffect = null;Layer.MatteType matteType = Layer.MatteType.NONE;AnimatableTransform transform = null;AnimatableTextFrame text = null;AnimatableTextProperties textProperties = null;AnimatableFloatValue timeRemapping = null;List<Mask> masks = new ArrayList<>();List<ContentModel> shapes = new ArrayList<>();reader.beginObject();while (reader.hasNext()) {switch (reader.selectName(NAMES)) {case 0:layerName = reader.nextString();break;case 1:layerId = reader.nextInt();break;case 2:refId = reader.nextString();break;case 3:int layerTypeInt = reader.nextInt();//看下Layer.LayerType的值 对应json中tyif (layerTypeInt < Layer.LayerType.UNKNOWN.ordinal()) {layerType = Layer.LayerType.values()[layerTypeInt];} else {layerType = Layer.LayerType.UNKNOWN;}break;case 4:parentId = reader.nextInt();break;case 5:solidWidth = (int) (reader.nextInt() * Utils.dpScale());break;case 6:solidHeight = (int) (reader.nextInt() * Utils.dpScale());break;case 7:solidColor = Color.parseColor(reader.nextString());break;case 8://图层变换,动画的 这个重点看下 transform = AnimatableTransformParser.parse(reader, composition);break;case 9:int matteTypeIndex = reader.nextInt();if (matteTypeIndex >= Layer.MatteType.values().length) {composition.addWarning("Unsupported matte type: " + matteTypeIndex);break;}matteType = Layer.MatteType.values()[matteTypeIndex];switch (matteType) {case LUMA:composition.addWarning("Unsupported matte type: Luma");break;case LUMA_INVERTED:composition.addWarning("Unsupported matte type: Luma Inverted");break;}composition.incrementMatteOrMaskCount(1);break;case 10://蒙层解析reader.beginArray();while (reader.hasNext()) {masks.add(MaskParser.parse(reader, composition));}composition.incrementMatteOrMaskCount(masks.size());reader.endArray();break;case 11:reader.beginArray();while (reader.hasNext()) {ContentModel shape = ContentModelParser.parse(reader, composition);if (shape != null) {shapes.add(shape);}}reader.endArray();break;case 12:reader.beginObject();while (reader.hasNext()) {switch (reader.selectName(TEXT_NAMES)) {case 0:text = AnimatableValueParser.parseDocumentData(reader, composition);break;case 1:reader.beginArray();if (reader.hasNext()) {textProperties = AnimatableTextPropertiesParser.parse(reader, composition);}while (reader.hasNext()) {reader.skipValue();}reader.endArray();break;default:reader.skipName();reader.skipValue();}}reader.endObject();break;case 13://特效reader.beginArray();List<String> effectNames = new ArrayList<>();while (reader.hasNext()) {reader.beginObject();while (reader.hasNext()) {switch (reader.selectName(EFFECTS_NAMES)) {case 0:int type = reader.nextInt();if (type == 29) {blurEffect = BlurEffectParser.parse(reader, composition);} else if (type == 25) {dropShadowEffect = new DropShadowEffectParser().parse(reader, composition);}break;case 1:String effectName = reader.nextString();effectNames.add(effectName);break;default:reader.skipName();reader.skipValue();}}reader.endObject();}reader.endArray();composition.addWarning("Lottie doesn't support layer effects. If you are using them for " +" fills, strokes, trim paths etc. then try adding them directly as contents " +" in your shape. Found: " + effectNames);break;case 14:timeStretch = (float) reader.nextDouble();break;case 15:startFrame = (float) reader.nextDouble();break;case 16:preCompWidth = (int) (reader.nextInt() * Utils.dpScale());break;case 17:preCompHeight = (int) (reader.nextInt() * Utils.dpScale());break;case 18:inFrame = (float) reader.nextDouble();break;case 19:outFrame = (float) reader.nextDouble();break;case 20:timeRemapping = AnimatableValueParser.parseFloat(reader, composition, false);break;case 21:cl = reader.nextString();break;case 22:hidden = reader.nextBoolean();break;default:reader.skipName();reader.skipValue();}}reader.endObject();List<Keyframe<Float>> inOutKeyframes = new ArrayList<>();// Before the in frameif (inFrame > 0) {Keyframe<Float> preKeyframe = new Keyframe<>(composition, 0f, 0f, null, 0f, inFrame);inOutKeyframes.add(preKeyframe);}// The + 1 is because the animation should be visible on the out frame itself.outFrame = (outFrame > 0 ? outFrame : composition.getEndFrame());Keyframe<Float> visibleKeyframe =new Keyframe<>(composition, 1f, 1f, null, inFrame, outFrame);inOutKeyframes.add(visibleKeyframe);Keyframe<Float> outKeyframe = new Keyframe<>(composition, 0f, 0f, null, outFrame, Float.MAX_VALUE);inOutKeyframes.add(outKeyframe);if (layerName.endsWith(".ai") || "ai".equals(cl)) {composition.addWarning("Convert your Illustrator layers to shape layers.");}//根据上面解析的值,生成对应的Layer对象。这个对象是进行绘制return new Layer(shapes, composition, layerName, layerId, layerType, parentId, refId,masks, transform, solidWidth, solidHeight, solidColor, timeStretch, startFrame,preCompWidth, preCompHeight, text, textProperties, inOutKeyframes, matteType,timeRemapping, hidden, blurEffect, dropShadowEffect);}
}

4.3 ks图层变换的解析过程

被解析为对象AnimatableTransform

通过AnimatableTransformParser把json中ks解析为AnimatableTransform对象

//通过AnimatableTransformParser把json中ks解析为AnimatableTransform对象
public class AnimatableTransformParser {private static final JsonReader.Options NAMES = JsonReader.Options.of("a",  // 1"p",  // 2"s",  // 3"rz", // 4"r",  // 5"o",  // 6"so", // 7"eo", // 8"sk", // 9"sa"  // 10);private static final JsonReader.Options ANIMATABLE_NAMES = JsonReader.Options.of("k");public static AnimatableTransform parse(JsonReader reader, LottieComposition composition) throws IOException {AnimatablePathValue anchorPoint = null;AnimatableValue<PointF, PointF> position = null;AnimatableScaleValue scale = null;AnimatableFloatValue rotation = null;AnimatableIntegerValue opacity = null;AnimatableFloatValue startOpacity = null;AnimatableFloatValue endOpacity = null;AnimatableFloatValue skew = null;AnimatableFloatValue skewAngle = null;boolean isObject = reader.peek() == JsonReader.Token.BEGIN_OBJECT;if (isObject) {reader.beginObject();}while (reader.hasNext()) {switch (reader.selectName(NAMES)) {case 0: // areader.beginObject();while (reader.hasNext()) {switch (reader.selectName(ANIMATABLE_NAMES)) {case 0:anchorPoint = AnimatablePathValueParser.parse(reader, composition);break;default:reader.skipName();reader.skipValue();}}reader.endObject();break;case 1: // pposition =AnimatablePathValueParser.parseSplitPath(reader, composition);break;case 2: // sscale = AnimatableValueParser.parseScale(reader, composition);break;case 3: // rzcomposition.addWarning("Lottie doesn't support 3D layers.");case 4: // rrotation = AnimatableValueParser.parseFloat(reader, composition, false);if (rotation.getKeyframes().isEmpty()) {rotation.getKeyframes().add(new Keyframe<>(composition, 0f, 0f, null, 0f, composition.getEndFrame()));} else if (rotation.getKeyframes().get(0).startValue == null) {rotation.getKeyframes().set(0, new Keyframe<>(composition, 0f, 0f, null, 0f, composition.getEndFrame()));}break;case 5: // oopacity = AnimatableValueParser.parseInteger(reader, composition);break;case 6: // sostartOpacity = AnimatableValueParser.parseFloat(reader, composition, false);break;case 7: // eoendOpacity = AnimatableValueParser.parseFloat(reader, composition, false);break;case 8: // skskew = AnimatableValueParser.parseFloat(reader, composition, false);break;case 9: // saskewAngle = AnimatableValueParser.parseFloat(reader, composition, false);break;default:reader.skipName();reader.skipValue();}}if (isObject) {reader.endObject();}if (isAnchorPointIdentity(anchorPoint)) {anchorPoint = null;}if (isPositionIdentity(position)) {position = null;}if (isRotationIdentity(rotation)) {rotation = null;}if (isScaleIdentity(scale)) {scale = null;}if (isSkewIdentity(skew)) {skew = null;}if (isSkewAngleIdentity(skewAngle)) {skewAngle = null;}//根据解析的属性生成AnimatableTransform对象return new AnimatableTransform(anchorPoint, position, scale, rotation, opacity, startOpacity, endOpacity, skew, skewAngle);}

五、资料

  1. Lottie 的使用
  2. Lottie实现思路和源码分析
  3. 如何看懂json参数
  4. Lottie—json文件解析
  5. Lottie 还可以做这些?

六、收获

通过本篇的学习

  1. 了解Lottie动画的流程
  2. 了解lottie json的中每个字段的含义
  3. 分析lottie json解析过程

感谢你的阅读
下一篇我们分析学习Layer渲染和动画部分的实现,欢迎关注公众号“音视频开发之旅”,一起学习成长。
欢迎交流

这篇关于音视频开发之旅(62) -Lottie 源码分析之json解析的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1053411

相关文章

python常见环境管理工具超全解析

《python常见环境管理工具超全解析》在Python开发中,管理多个项目及其依赖项通常是一个挑战,下面:本文主要介绍python常见环境管理工具的相关资料,文中通过代码介绍的非常详细,需要的朋友... 目录1. conda2. pip3. uvuv 工具自动创建和管理环境的特点4. setup.py5.

全面解析HTML5中Checkbox标签

《全面解析HTML5中Checkbox标签》Checkbox是HTML5中非常重要的表单元素之一,通过合理使用其属性和样式自定义方法,可以为用户提供丰富多样的交互体验,这篇文章给大家介绍HTML5中C... 在html5中,Checkbox(复选框)是一种常用的表单元素,允许用户在一组选项中选择多个项目。本

Python实例题之pygame开发打飞机游戏实例代码

《Python实例题之pygame开发打飞机游戏实例代码》对于python的学习者,能够写出一个飞机大战的程序代码,是不是感觉到非常的开心,:本文主要介绍Python实例题之pygame开发打飞机... 目录题目pygame-aircraft-game使用 Pygame 开发的打飞机游戏脚本代码解释初始化部

Python包管理工具核心指令uvx举例详细解析

《Python包管理工具核心指令uvx举例详细解析》:本文主要介绍Python包管理工具核心指令uvx的相关资料,uvx是uv工具链中用于临时运行Python命令行工具的高效执行器,依托Rust实... 目录一、uvx 的定位与核心功能二、uvx 的典型应用场景三、uvx 与传统工具对比四、uvx 的技术实

使用Python开发一个现代化屏幕取色器

《使用Python开发一个现代化屏幕取色器》在UI设计、网页开发等场景中,颜色拾取是高频需求,:本文主要介绍如何使用Python开发一个现代化屏幕取色器,有需要的小伙伴可以参考一下... 目录一、项目概述二、核心功能解析2.1 实时颜色追踪2.2 智能颜色显示三、效果展示四、实现步骤详解4.1 环境配置4.

SpringBoot排查和解决JSON解析错误(400 Bad Request)的方法

《SpringBoot排查和解决JSON解析错误(400BadRequest)的方法》在开发SpringBootRESTfulAPI时,客户端与服务端的数据交互通常使用JSON格式,然而,JSON... 目录问题背景1. 问题描述2. 错误分析解决方案1. 手动重新输入jsON2. 使用工具清理JSON3.

Springboot3+将ID转为JSON字符串的详细配置方案

《Springboot3+将ID转为JSON字符串的详细配置方案》:本文主要介绍纯后端实现Long/BigIntegerID转为JSON字符串的详细配置方案,s基于SpringBoot3+和Spr... 目录1. 添加依赖2. 全局 Jackson 配置3. 精准控制(可选)4. OpenAPI (Spri

MyBatis Plus 中 update_time 字段自动填充失效的原因分析及解决方案(最新整理)

《MyBatisPlus中update_time字段自动填充失效的原因分析及解决方案(最新整理)》在使用MyBatisPlus时,通常我们会在数据库表中设置create_time和update... 目录前言一、问题现象二、原因分析三、总结:常见原因与解决方法对照表四、推荐写法前言在使用 MyBATis

Python主动抛出异常的各种用法和场景分析

《Python主动抛出异常的各种用法和场景分析》在Python中,我们不仅可以捕获和处理异常,还可以主动抛出异常,也就是以类的方式自定义错误的类型和提示信息,这在编程中非常有用,下面我将详细解释主动抛... 目录一、为什么要主动抛出异常?二、基本语法:raise关键字基本示例三、raise的多种用法1. 抛

MySQL JSON 查询中的对象与数组技巧及查询示例

《MySQLJSON查询中的对象与数组技巧及查询示例》MySQL中JSON对象和JSON数组查询的详细介绍及带有WHERE条件的查询示例,本文给大家介绍的非常详细,mysqljson查询示例相关知... 目录jsON 对象查询1. JSON_CONTAINS2. JSON_EXTRACT3. JSON_TA