常见问题
问：PAG 收费吗？
PAG 已正式对外开源，采用 Apache 2.0 协议，可以商用，是不收费的。
问：PAG 支持哪些平台？
PAG 的渲染 SDK 目前已经支持 Android、iOS、macOS、Windows、Linux 和 Web 等平台。 桌面预览工具 PAGViewer 和 AE 导出插件同时支持 macOS 和 Windows 平台。目前在 Android、iOS 和 Web 平台上我们会定期发布预编译的制品库，具体接入参考：
其他平台由于没有统一的 UI 框架或者使用上本来也需要自己做一些渲染桥接的适配，我们没有发布统一的预编译制品库，可以自行从 Github 的源码进行构建。对于小程序的适配也在进行中，预计还要过段时间。
问：PAG 源码编译的时候报错了怎么处理？
PAG 项目的编译依赖一些第三方库的下载同步，以及正确版本的编译工具安装。在运行 Demo 前请务必先阅读位于根目录的 README.md，根据 开发指南 一节的指引进 行依赖同步和编译环境配置。如还有问题，可以在 QQ 群向我们反馈。
问：PAG 支持模拟器吗？在模拟器上测试性能是否准确？
PAG 只保证 UI 动画在模拟器里的基本预览，不建议在模拟器上高强度使用或者进行性能测试。PAG 是一个全链路 GPU 加速的 渲染方案，在模拟器上由于无法开启 GPU 加速，性能会比实际情况差很多，另外模拟器也缺失部分必要的接口，导致一些配合高级 视频编辑功能的接口在模拟器上也不支持。例如无法绘制到 CVPixelBuffer 离屏对象上。另外模拟器也不是真实用户场景，性能测试 请使用真机进行。
问：PAG 支持 Flutter 使用吗？
PAG 支持 Flutter 使用，目前已经有成功使用的案例，需要业务层做些适配。具体原理是通过外部纹理做桥接，PAG 可以将动画逐帧 绘制到指定的纹理上。因此，外部的任何框架包括 Flutter 只要能提供一个纹理给 PAG 绘制，都可以完美实现桥接或融合。具体请搜 索 Flutter 外接纹理接口，提供一个纹理包装成 PAGSurface后，然后使用 PAGPlayer 正常进行绘制控制即可。
问：PAG 与视频编辑的关系？
PAG 诞生之初就是为了解决视频编辑场景下的复杂动画效果渲染需求，提供了相关接口可以便捷的与原生视频渲染链路相整合，但 PAG 本身并不是视频编辑框，它只负责动画的渲染的部分。视频编辑框架是另一个范畴的技术领域，需要业务方自己开发或者接入 行业里成熟的方案，解决视频编解码，合成，导出等能力。
问：PAG 文件为什么在移动端播放不出声音？
PAG 文件支持集成音频数据，导出方法具体方法参照 如何在AE中导出音频。 但 PAG SDK 仍然还是一个动画渲染库，目前只渲染画面的部分，播放或者合成到视频需要业务方使用音视频框架自行处理。研发侧 可以从 PAGFile.audioBytes 接口上读取 PAG 内置的音频数据，将它存储为本地文件使用或者直接在内存中解码都可以。 audioBytes 字节流的编码格式为 AAC，容器格式为 MPEG-4。
问：PAG Windows 版本是否可以直接和 DirectX 11 的现有游戏结合？
目前没有计划要去直接支持 DX 的渲染后端，但是通过 Google 的 ANGLE 项目把 DX 包装成 OpenGL 让 PAG 进行渲染。目前 Chrome 在 Windows 上也是采用的这种实现方案。
问：PAGViewer 里执行占位图替换或者文本编辑后，怎么导出 PAG 文件？
PAGViewer 并没有导出 PAG 文件的能力，只是一个预览工具。PAG 文件只能通过 AE 插件进行导出。这里可能是对 PAG 使用方式上 的理解存在误区。PAG 提供的运行时编辑替换功能不是用来生成新的 PAG 文件的，编辑的产物应该是生成一个视频或直接播放动画。 可以把 PAG 文件理解为一个动画模板，运行时可以替换为用户千变万化的个性信息，组合出无限的可能，如果每种可能都生成一个新的 PAG 文件就失去了模板的意义了，这样导致用户使用的时候要下载无数个 PAG 文件。而正确的用法应该是始终只有一个 PAG 文件， 但是可以播放或者渲染出无数的组合效果。
问：PAG 导出插件是否支持 AE 表达式？
AE 表达式还没有原生支持，因为涉及了 JS 虚拟机植入，包会很大，还在考虑最好的方案。但目前是可以导出包含表达式的动画内容的， 可以参考如下两种方式导出：
- 右键含有表达式的图层，使用快捷菜单可以把表达式转换为标准的关键帧，然后导出即可。
- 包含表达式效果的图层，如果不需要在运行时被编辑，也可以标记为 BMP 预合成 后导出，这种方式不仅可以导出表达，包含 3D 属性甚至第三方插件的效果也可导出。
问：导出 PAG 时弹出了一个优化建议页面，是什么意思？
提示页面包含两种信息，一种是性能优化建议，发现素材性能不理想时可以根据提示进行优化 另一种是显示当前不支持的能力，对于不支持的能力，可以转化为BMP预合成来导出，可以参考 BMP预合成导出，可以在 AE特性列表 查看支持直接被导出的 AE 特性列表。
问：添加了很多特效（Effect），但导出后不见了？
可以在 AE特性列表 里找到目前支持直接导出的特效。如果没有在这 个列表里，但特效并不是用在运行时可编辑的图层上（不打算替换内容），或者这是第三方插件的特效，可以转化为BMP预合成来导出，可以参考 BMP预合成导出。如果你需要用在运行时可编辑的图层上，目前又还 不支持直接导出，可以通过 QQ 群或者 Github 给我们提个需求，我们会 根据需求的通用程度排出优先级逐个提供支持。
问：标记为 BMP 预合成后，本来不支持的效果就可以导出了，但感觉清晰度不太够？
可以在对插件选项进行配置，请参考这个文档 插件选项配置面板 与清晰度有关的参数是：
通用页面下的图像压缩质量和位图像素密度BMP预合成页面下的图像压缩质量
但通常情况下并不需要修改这些默认参数，它们已经被设置在文件大小和清晰度的最佳平衡点上。通常情况下清晰度问题更多是由于额外的素材 转换操作导致的。例如提前把一些效果转换成视频放进 AE 里再标记为 BMP 预合成导出，或者自行对图片资源进行压缩后放进 AE 使用。 所有这些操作只会导致清晰度降低，并不会对最终导出的 PAG 文件带来任何的文件大小优化。PAG 导出插件已经内置了极高压缩率的算法， 请不要额外做任何额外的优化文件大小操作，在 AE 中请一律使用最高清的资源进行动画设计，最终交给 PAG 导出插件来进行统一的压缩就行。 我们推荐如下最佳实践：
- 能用矢量直接绘制的，比如图形或者文本，就不要使用 PS 转换为图片再导入 AE 使用。直接在 AE 里绘制。
- 如果必须从外部工具导入 AE 的资源，且原始资源本身就是矢量的，请尝试转换为 AE 原生的图层类型，否则 PAG 无法识别只能截图处理。
- 无法直接进行导出的 AE 特效，不要自行转成视频放进来再标记为 BMP 预合成导出，标记为 BMP 预合成本来就是帮你截图压缩成视频， 两次视频压缩会导致清晰度降低。直接标记为 BMP 预合成让 PAG 导出原始的图层即可。
- 注意一下导出的分辨率是否足够。如果是矢量的内容，跟分辨率无关。如果导出的动画包含位图或者 BMP 预合成，清晰度跟根节点的总 预合成的尺寸直接相关。在满足清晰度的情况下，尽可能选择合适的分辨率。
问：导出的 PAG 文件在客户端渲染时为什么会有色差？
桌面预览工具 PAGViewer(2.1.40版本以上) 和客户端 SDK 使用的色彩空间都已经修正为 sRGB。目前解决色差最佳的方式还是 sRGB， 类似 P3 这种广色域的色彩空间并不是所有设备都能支持。如果 AE 设置的是其他色彩空间，请修改为 sRGB，否则导出的 PAG 文件在 渲染的时候可能会出现色差。
问：导出的 PAG 文件为什么播放卡顿不流畅，如何优化素材性能？
PAG 同时支持纯矢量导出（包含图片图层）和 BMP 预合成导出。素材的性能问题通常都是因为过多使用了 BMP 预合成导致的， 针对 BMP 预合成的使用可以参考如下规则：
- 尽量不用：通常只有在正常导出效果不正确时，才使用BMP预合成。可以参考 AE特性列表 文档查看支持直接导出的 AE 特性。
- 尽量少用：如果有多个图层和预合成需要使用BMP预合成，尽量将它们合并，以减少BMP预合成的数目。
- 控制面积：尽可能避免巨大面积的预合成标记为 BMP 预合成导出，只拆解必要的动画区域出来标记为 BMP 预合成导出。
通过以上方式已经能解决绝大部分的素材性能问题，其他更多的素材优化技巧可以参考 PAG 素材优化指南 。 我们定期也会组织面向设计师的在线培训课程，分享素材制作的技巧和新的插件功能，如有需要请关注 QQ 群公告。