Android PAG动效的使用

开篇废话

PAG是由腾讯推出的一套完整的动效工作流解决方案,目标是降低或消除动效相关的研发成本,能够一键将设计师在AE中制作的动效内容导出成素材文件,并快速上线应用于几乎所有的主流平台。
PAG有付费版本,可以支持更多功能,免费的社区版本基本可以满足我们的日常使用。
PAG官网

PAG工作流程

pag工作流程图

PAG动效工作流主要包含三个部分:

  1. 导出插件PAG Exporter
  2. 桌面预览工具PAGViewer
  3. 跨平台渲染SDK

设计师通过AE插件PAG Exporter导出PAG动效文件,在桌面端通过PAGViewer预览效果和查看性能,确认无误再交付终端,终端接入PAG SDK,加载PAG文件完成对动效的渲染展示。
设计师在制作动效时需要注意的点——PAG 素材优化指南

PAG的优势

PAG相比其它动效解决方案有着非常多的优势:

  1. 文件体积小,相比lottie更小,动效越复杂,对比效果越明显
  2. 可以随意替换动效中的文字以及图片(比如天气温度变化,晴天变雨天等)
  3. AE大多数特性都可以支持,比如图层、蒙板、混合模式、图形形状、变换、路径、矢量图等
  4. PAG还支持视频剪辑,作为贴纸、字幕、特效、转场动效使用(付费版)
  5. 社区版完全开源免费,采用 Apache 2.0 协议,可以自由商用
  6. 支持lottie一键迁移——Lottie 迁移指南
  7. Android aar 4.18M,iOS 全功能的也不超过4M

PAG的实现方案

pag文件格式规范
个人根据官方文档,对PAG实现的一些猜想:

  1. PAG是纯GPU渲染方案
  2. PAG采用类似AE图层的形式导出,所以可以任意替换文字和图片
  3. PAG的图层分形状图层,图片图层等,lottie动效可能导出全部图片,而PAG会根据AE设计师导出相对应的形状图层,形状图层类似我们代码画形状,必然比png图片要小得多
  4. PAG导出图片图层时,可能采用的类似webp的编码方式,webp有损压缩基于VP8中的预测编码来压缩图像数据,而png是哈夫曼编码,webp更有优势
  5. PAG文件还有更多的优化,详见pag文件格式规范

PAG的SDK导入

PAG移动端接入指南

基本要求:

  • 支持android 4.4及以上系统
  • 推荐使用gradle 3.0及以上版本编译
  1. 在 root 工程目录下面修改 build.gradle 文件,增加mavenCentral()
buildscript {
 
    repositories {
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.2.1'
    }
}
  1. 在 app 的 gradle 文件 app/build.gradle,添加 libpag 的库依赖
dependencies {
    //基础版本,如需保持最新版本,可以使用 latest.release 指代
    implementation 'com.tencent.tav:libpag:latest.release'
}
  1. 注意:需要在混淆列表里面,添加 libpag 的 keep 规则:
-keep class org.libpag.** {*;}
-keep class androidx.exifinterface.** {*;}

PAG的API使用

PAG SDk中有PAGView和PAGImageView——PAGView和PAGImageView对比
结论是推荐使用PAGImageView

1.在xml中添加PAGImageView

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:background="#FFFFFF"
    android:padding="24dp">

    <org.libpag.PAGImageView
        android:id="@+id/pag_view"
        android:layout_width="375dp"
        android:layout_height="225dp" />

</LinearLayout>

2.在Activity或Fragment中使用

viewBinding.apply {
    //这里填入图片
    val pagFile = PAGFile.Load(assets, "pag_image.pag")
    pagFile.replaceText(0, pagFile.getTextData(0).apply {
        text = "替换文本0"
    })
    pagFile.replaceText(1, pagFile.getTextData(1).apply {
        text = "替换文本1"
    })
    pagView.composition = pagFile
    pagView.setRepeatCount(0)
    pagView.play()
}

对PAGImageView进行封装

在针对多语言场景,我们在使用时,需要自己在业务代码中处理多语言文案,也许我们可以通过封装一层,不需要业务层去写相对应替换方法,让基类帮我们把这事给干了,也就是把使用PAG给规范起来。

构思

  1. PAG文件由设计师导出,命名以pag_开头
  2. 我们将PAG文件放到assets://pag/目录下
  3. PAG文件内要替换为多语言的文案以[PAG文件名]_开头
  4. PAG所用到的多语言文案统一放到pag_strings
  5. PAG里展示的文案不是实际文案,而是我们Android用到的资源ID
  6. 封装PAGImageView,查找文案并对文案通过资源ID找到相对应的资源

例如:
动效文件名称:pag_run.pag
动效中的文字以及对应关系:

动效中的文字(非图层名) 对应的中文文案
pag_run_left 左边跑
pag_run_right 右边跑

开始撸

package com.glazero.android.view

import android.content.Context
import android.util.AttributeSet
import org.libpag.PAGComposition
import org.libpag.PAGFile
import org.libpag.PAGImageView

/**
 *  author : superc
 *  date : 2023/6/13 10:26
 *  description : https://pag.art/
 */
class SuperPAGImageView @JvmOverloads constructor (
    context: Context,
    attr: AttributeSet? = null,
    style: Int = 0
) : PAGImageView(context, attr, style) {

    override fun setPath(path: String): Boolean {
        return super.setPath(path)
    }

    override fun setPath(path: String, f: Float): Boolean {
        val composition = findPAGComposition(path)
        composition ?: return false
        setComposition(composition, f)
        return true
    }

    fun setPAGName(path: String): Boolean {
        return setPAGName(path, 30.0F)
    }

    fun setPAGName(path: String, f: Float): Boolean {
        val composition = findPAGComposition("assets://pag/$path")
        composition ?: return false
        setComposition(composition, f)
        return true
    }

    override fun setComposition(compostion: PAGComposition) {
        super.setComposition(compostion)
    }

    override fun setComposition(compostion: PAGComposition, f: Float) {
        if (compostion is PAGFile) {
            for (i in 0 until compostion.numTexts()) {
                //查找文案并对文案通过资源ID找到相对应的资源
                compostion.replaceText(i, compostion.getTextData(i).apply {
                    val resId = context.resources.getIdentifier(text, "string", context.packageName)
                    text = context.getString(resId)
                })
            }
        }
        super.setComposition(compostion, f)
    }

    private fun findPAGComposition(path: String): PAGComposition? {
        return if (path.startsWith("assets://")) {
            PAGFile.Load(context.assets, path.substring(9))
        } else {
            PAGFile.Load(path)
        }
    }

}

PAG有谁在使用

腾讯系、京东系、迅雷系、虎牙系、知乎、小红书、知乎、陌陌、豆瓣、bilibili、全民K歌、同程旅行、央视频、小睡眠等

写在最后

PAG 的渲染 SDK 目前已经支持 Android、iOS、macOS、Windows、Linux、Web 和微信小程序等平台。 桌面预览工具 PAGViewer 和 AE 导出插件同时支持 macOS 和 Windows 平台。可以说是解决了我们在开发过程中很多问题。

更多内容戳这里(整理好的各种文集)

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

推荐阅读更多精彩内容