PAG官网 | PAG动效

PAG官网 | PAG动效

  • 首页
  • 产品
  • 功能
  • 文档
  • 案例
  • GitHub
  • 官方论坛
  • 免费下载

›SDK快速接入

PAG 介绍

  • 产品介绍
  • 使用流程
  • 常见问题

快速开始

  • 安装 PAGViewer
  • 安装 AE 导出插件
  • 导出 PAG 文件

SDK快速接入

  • 移动端接入指南
  • 桌面端接入指南
  • Web端接入指南
  • 小程序端接入指南

导出插件

  • 插件选项配置面板
  • AE 导出提示
  • BMP 预合成导出
  • PAG 填充模式
  • PAG 时间伸缩
  • 导出面板快捷键设置
  • 导出错误码说明
  • AE 导出自动检测规则
  • 文本制作规则
  • 如何添加文本背景框
  • 如何在 AE 中导出音频

预览工具

  • 使用 PAGViewer 编辑预览图层
  • 使用 PAGViewer 查看 PAG 文件结构
  • PAGViewer 快捷键说明
  • 使用 beta 版本的 PAGViewer
  • 从 PAG 导出其他图片格式

性能优化

  • 使用性能监测面板
  • PAG 素材优化指南

API参考

  • iOS API文档
  • Android API文档
  • Web API文档

移动端进阶

  • UI场景及列表播放优化
  • 占位图替换视频
  • 播放有声素材
  • 使用加密素材
  • 导出视频文件
  • SDK 鉴权

Web进阶

  • 平台特性
  • 安装
  • 加载 PAG 文件
  • 播放动效
  • 兼容性情况
  • 自适应
  • WebWroker 版本

素材迁移

  • Lottie 迁移指南
  • 素材迁移说明
  • PAG SDK 迁移指南

视频教程

  • PAG 制作与性能优化培训视频
  • PAG 新版导出插件面板培训视频
  • 线上答疑

文件格式

  • PAG 文件格式规范

桌面端接入指南


接入方式

桌面端(macOS、Windows、Linux)暂不提供统一的制品库,需要开发者根据源码自行构建,但我们会提供编译指引。PAG是跨平台的,不同平台之间的API接口具有一致性。

具体原因如下:

  1. Windows端没有统一的UI框架;
  2. Linux端由于服务端CPU型号或系统版本的差异,统一的制品库难以完全兼容

源码下载

PAG 的主体实现位于 C++ 层代码,平台侧为 PAG 的绘制提供渲染环境,因此所有的代码都位于 github 仓库 https://github.com/tencent/libpag

源码下载后需要拉取第三方库依赖

macOS 和 Linux 平台:

  ./sync_deps.sh

其它平台:

   npm install -g depsync
   depsync

在源码根目录下,有平台侧的文件夹,如 android、ios、web、linux、mac、 win 等,各平台侧的工程文件在这些目录下,工程文件均依赖仓库中的 C++ 主体代码。

API接口使用

在PAG的源码工程中,C++层基本上所有对外提供的方法都进行了测试用例的覆盖,如果想了解具体方法的使用,查看相关测试用例是一种很便捷的途径。


macOS端接入

基本要求

  • macOS 10.14 or later

编译构建

macOS 端的项目工程位于源码根目录 mac 文件夹下,为 Xcode 工程,开发者可以自行构建


Windows接入指南

编译工具

  • Visual Studio 最低版本要求 VS2015
  • Node.js PAG依赖管理的基础
  • depsync 用于PAG的依赖管理

环境准备

  1. 从Node.js官网获取并安装 Node.js
  2. 通过 npm 安装
    npm install depsync -g
    

运行Demo

  1. 执行libpag\win\Win32Demo.sln启动 Demo 工程
  2. 运行 Demo。首次执行时会同步依赖和编译 PAG,会比较耗时
  3. 随 Demo 构建的 pag.lib 是 release 的,需要构建 debug 版可以参考下边的指引

使用PAG【Angle backend】

  1. 首次运行时,在libpag根目录下执行

    depsync
    
  2. 在根目录执行 cmake-build 生成 PAG,会同时生成 32 位和 64 位的 pag.lib

    node .\vendor_tools\cmake-build pag -p win -o .\win\paglib -v -i -DPAG_BUILD_SHARED=OFF
    
    • -p platform,在Windows下选择win
    • -o output,指定输出目录
    • -i incremental,增量编译开关,关闭时会清理编译目录
    • -d debug,debug开关
    • -v verbose,详细打印日志
    • DPAG_BUILD_SHARED 动态库编译开关
  1. 头文件位置

    libpag\include
    
  2. 在自己的工程内使用的时候,还需要在工程属性->链接器->输入->附加依赖项中添加两个系统库

    Bcrypt.lib
    ws2_32.lib
    
  3. 在使用 Angle backend 时,可执行程序需要链接 Angle 动态库

    libpag\vendor\angle\win\
    

使用PAG【QT backend】

  • Demo的位置在
    libpag\qt
    
  • 请提前安装好 VS2019 版本,至少必须同时安装 [使用 C++ 的桌面开发] 和 [通用 Windows 平台开发] 两个子模块。
  • 在 CLion 的选项菜单里搜索 ToolChain ,设置默认编译工具为 Visual Studio,并选择 amd64 架构。
  • 用 CLion 打开根目录下的 qt 文件夹,首次刷新会提示 QT SDK 找不到,请打开自动生成的 qt/QTCMAKE.cfg 配置文件,修改其中的 QT 路径为本地安装路径即可。例如:C:/Qt/Qt5.13.0/5.13.0/msvc2017_64/lib/cmake。
  • 在 CLion 中打开 PAGViewer 目标的配置面板,在 Environment Variables 一行填入本地 QT 的 DLL 库路径,例如:PATH=C:\Qt\Qt5.13.0\5.13.0\msvc2017_64\bin。
  • 最后编译并运行 PAGViewer 目标即可。

Linux端接入

基本要求

  • gcc版本不低于7.0

编译构建

  1. 开发者参照源码根目录下的 Linux_build.md 完成依赖环境的安装

  2. 通过根目录下的 build_linux.sh 完成pag库文件的构建

  3. 编译生成的头文件和库文件位于 linux/vendor 目录下

Demo工程

Demo 工程通过 CMake 来组织,依赖的库文件来自于上一步的构建

在 linux 目录下

 mkdir build
 cd build
 cmake ../
 make -j8
 ./pag-linux

Demo工 程仅仅提供了库文件的编译和简单的使用范例,如果需要占位图填充视频或者导出视频,需要使用者自行开发

← 移动端接入指南Web端接入指南 →
  • 接入方式
    • 源码下载
    • API接口使用
  • macOS端接入
    • 基本要求
    • 编译构建
  • Windows接入指南
    • 编译工具
    • 环境准备
    • 运行Demo
    • 使用PAG【Angle backend】
  • Linux端接入
    • 基本要求
    • 编译构建
    • Demo工程
公司地址:广东省深圳市南山区海天二路33号腾讯滨海大厦
联系电话:0755-86013388
QQ群:893379574
备案号:粤B2-20090059
Copyright © 2018 - 2023 Tencent. All Rights Reserved.
隐私政策

粤公网安备 44030502009351号

Copyright © 2018 - 2023 Tencent. All Rights Reserved.
公司地址:广东省深圳市南山区海天二路33号腾讯滨海大厦
联系电话:0755-86013388
QQ群:893379574
隐私政策
备案号:粤B2-20090059

粤公网安备 44030502009351号