涂图

  • 首页
  • 解决方案
    • 拍照和图片编辑
    • 视频录制和后期编辑
    • 模板视频
    • 人像美颜
    • 人脸特效
    • 滤镜特效
    • 贴纸特效
  • API服务
    • 人像服务
    • 视频融合
    • 人脸云
    • 在线滤镜
  • 客户案例
  • 下载
  • 文档
  • 关于我们
  • 控制台
  • 一、新手上路
  • 控制台操作说明
    • 控制台使用说明
    • 自定义资源上传说明
  • 二、SDK 文档
  • 图像 SDK
    • 产品说明
      • 产品指南
      • 性能测试报告
    • iOS 文档
      • 快速开始
      • 安装与更新
      • 集成向导
      • 相机组件的使用
      • 相册组件的使用
      • 照片美化组件的使用
      • 主题包基础使用
      • 自定义滤镜
      • 自定义贴纸
      • 自定义界面
      • 自定义 ProgressHUD 提示框(2.0.0~3.2.7)
      • 自定义 ProgressHUD 提示框
      • API 文档
      • 致谢
    • Android 文档
      • 快速开始
      • 安装与更新
      • 集成向导
      • 相机组件的使用
      • 照片美化组件的使用
      • 头像设置组件的使用
      • 多选相册组件的使用
      • 主题包基础使用
      • 自定义贴纸
      • 自定义滤镜
      • 自定义界面
      • 自定义进度信息提示框
      • 自定义 Activity 打开相机
      • API 文档
      • 致谢
    • iOS 技术问题
      • 「Incorrenct app key」
      • 更换滤镜效果图
      • 导航栏与状态栏
      • 组件中使用部分滤镜
      • Cocoapods 相关问题
      • 图片尺寸变化
      • Photos.framework 相关错误
      • 多包名发布
      • GPUImage 的相关错误
      • TuSDKTSALAsset 转换系统对象
      • 滤镜无法显示名称
      • 获取相机的点击事件
    • Android 技术问题
      • Incorrenct app key
      • 重复引用包
      • Recyclerview 库缺失
      • 方法数超出 65536 限制
      • 传入图片路径
      • 指定裁剪比例
      • 指定相册每行列数
      • 禁用相册自动跳转
      • 如何使用部分滤镜?
      • 代码混淆
      • TuSDK 使用的依赖库
      • 多渠道打包
      • 设置相机输出尺寸
      • 相机横屏设置
      • 自定义照片美化组件各功能模块效果默认参数值
    • 拼图设计
      • 拼图模板导出
    • 版本更新日志
      • iOS 版本更新日志
      • Android 更新日志
  • 视频剪辑 SDK
    • 产品说明
      • 产品指南
    • iOS文档
      • TuSDK Video Editor iOS 接入文档
    • Android文档
      • TuSDK Video Editor Android 接入文档
    • 版本更新日志
      • iOS 版本更新日志
      • Android 版本更新日志
  • 流处理(特效相机) SDK
    • 产品说明
      • 产品指南
    • iOS 文档
      • TuSDK特效相机接入文档-iOS
      • TuSDK直播特效接入说明-iOS
    • Android 文档
      • TuSDK特效相机接入文档-Android
      • TuSDK直播特效接入说明-Android
    • 版本更新日志
      • iOS 版本更新日志
      • Android 版本更新日志
  • 视频融合 SDK
    • 产品说明
      • 产品指南
      • 模板管理
    • iOS 文档
      • 快速开始
      • 安装与更新
      • TuSDK EVA 接入说明 2.0
      • API文档
    • Android 文档
      • 快速开始
      • 安装与更新
      • TuSDK EVA 接入说明 (2.0.0+)
      • API 文档
    • 模板设计
      • (新)标准模板设计规范
      • (旧)标准模板设计规范
      • 支持的 AE 功能和属性
      • 动态模板设计规范
    • 模板导出
      • (新)模板导出插件安装
      • (新)模板导出插件使用
      • (旧)模板导出插件安装
      • (旧)模板导出插件使用
      • (旧)模板效果查看器
      • (旧)模板打包规范
    • 版本更新日志
      • iOS 版本更新日志
      • Android 版本更新日志
      • 导出插件版本更新日志
      • 效果查看器更新日志
  • 短视频 SDK
    • 产品说明
      • 产品指南
      • 性能测试报告
    • iOS 文档
      • 快速开始
      • 集成向导
      • 录制相机的使用
      • 视频编辑器的使用
      • 功能 API 的使用
      • API 文档
    • Android 文档
      • 快速开始
      • 集成向导
      • 录制相机的使用
      • 视频编辑器的使用
      • 功能 API 的使用
      • API 文档
    • iOS 技术问题
      • 常见问题
    • Android 技术问题
      • 常见问题
    • 版本更新日志
      • iOS 版本更新日志
      • Android 版本更新日志
  • 三、云服务文档
  • 人像服务
    • 使用文档
      • 快速入门
      • 核心功能
    • API概述
      • API 概述
      • API 文档
    • 常见问题
      • 常见问题
  • 视频融合(云渲染)
    • 使用文档
      • 快速入门
      • 模板管理
    • API概述
      • API概述
      • API 文档
    • 模板设计
      • (新)标准模板设计规范
      • (旧)标准模板设计规范
      • 支持的 AE 功能和属性
      • 动态模板设计规范
    • 模板导出
      • (新)模板导出插件安装
      • (新)模板导出插件使用
      • (旧)模板导出插件安装
      • (旧)模板导出插件使用
      • (旧)模板效果查看器
      • (旧)模板打包规范
    • 常见问题
    • 版本更新日志
      • 导出插件版本更新日志
      • 效果查看器更新日志
  • 人脸云
    • 使用文档
      • 快速入门
      • 核心功能
    • API 概述
      • API 概述
    • 常见问题
      • 常见问题
  • 在线滤镜
    • 使用文档
      • 快速入门
      • 核心功能
      • FILTER API
      • API 错误码表
    • API概述
      • API 概述
    • 常见问题
      • 常见问题
  • 四、综合
  • 涂图隐私协议
  • 用户退出机制
  • 动态贴纸设计规范
  • 美妆贴纸设计规范
  • 云服务账单说明
  • 应用包名与密钥
  • 基础服务开发者升级流程
  • 五、常见问题
  • 常见问题
  • 遇到问题,怎么办?
  • 如何使用贴纸管理、滤镜管理?

模块命名

模块名称 命名规范
主合成main
入场模块entry
出场模块exit
前景模块foreground
背景模块background
转场模块以 part 前缀,从 1 开始的数字为后缀,比如 part1,part2,part3 等。

可替换素材命名规范

源类型 目标类型 命名规范 说明
图片图层图片/视频以 dyn_img_ 为前缀,任意数字或则英文为后缀,比如 dyn_img_entry_1,dyn_img_part1_1,dyn_img_exit_1应用在入场、出场、前景、转场模块,可以有多个,图层名称彼此不重复。
视频图层图片/视频以 dyn_vid_ 为前缀,任意数字或则英文为后缀,比如 dyn_vid_entry_1,dyn_vid_part1_1,dyn_vid_exit_1应用在入场、出场、前景、转场模块,可以有多个,图层名称彼此不重复。
音频图层音频dyn_aud_bg仅支持应用到背景模块,仅有一个或没有,其作为模板的背景音乐存在。

动态模板结构

动态模板是一种特殊的模板类型,与标准模板采用不同结构形式。动态模板中包含:入场模块、出场模块、前景模块、背景模块、转场模块 5 个模块。其中转场模块是必要项,其余均是非必要项。

  • 入场模块(非必要) 可以使用可替换的图片。入场模块是指在视频开始,用户素材出现之前展示的视觉动画。这部分在 AE 中必须以一个预合成层的形式存在于主合成当中,并且需要从第 0 帧开始。 若模板中含有入场模块,那么用户最终生成的视频会以入场模块作为开场,然后开始播放后续的转场模块。

  • 出场模块(非必要) 可以使用可替换的图片。出场模块是指在视频结束之前,用户素材播放完成之后展示的用来过渡结束该段视频的视觉动画。这部分在 AE 中必须以一个预合成层的形式存在于主合成当中,且该层的结束视觉动画必须为主合成的结尾。 若模板中含有出场模块,那么用户最终生成的视频会在所有图片/视频素材动画播放完成之后播放该出场模块的动画,直至整个视频结束。

  • 前景模块(非必要) 可以使用可替换的图片。前景模块是指在整个视频中作为背景展示在最上层的视觉动画。前景模块必须以预合成层的形式存在于主合成当中。当用户上传的素材过多,且时长超过了前景模块层的时长时,前景模块将重复循环播放。

  • 背景模块(非必要) 可以使用可替换的背景音乐。背景模块是指在整个视频中作为背景展示在最底层的视觉动画。背景模块必须以预合成层的形式存在于主合成当中。当用户上传的素材过多,且时长超过了背景模块层的总时长时,背景模块将重复循环播放。

  • 转场模块(必要) 可以使用可替换的图片/视频。转场模块指的是对于每个用户一个图片/视频素材进行动画的一个片段。每个转场模块都必须是一个预合成,设计师可以在预合成中对用户的素材添加动画和特效。一个转场模块中必须使用 1~N 张用户素材。

虽然一个转场模块允许设计师同时展示多张用户素材,但一个模板中必需包含一个转场模块只展示一个用户图片素材。主要原因为:防止用户上传的图片数量不确定的情况下,最后剩下单张素材无法找到合适的转场模块。模板的简略图如下:

Alt text

用户上传素材和动画模块对应关系

动态模板渲染引擎对于用户上传素材的处理逻辑:

  • 获取用户上传素材后,检查对应模板入场模块中可替换素材的数量,并从用户上传的素材当中提取对应数量的素材填入入场模块中(从用户上传素材的第 1 个开始取)。如果用户上传素材数量小于模板中可替换素材数量,则缺少的素材将会使用预设素材进行代替。

    举例说明:模板入场模块中设置为 3 个可替换素材,但用户仅上传 2 个素材。替换执行逻辑为:用户上传的第 1 个素材将会替换模板中的第1个素材;用户上传的第 2 个素材将会替换模板中的第 2 个素材;渲染后视频的第 3 个素材为模板中第 3 个预设素材。

  • 将入场模块素材替换完成后,从用户上传素材列表剩余的素材中取对应数量的素材放到出场模块中(从用户上传素材的最后 1 个开始取)。如果用户上传素材数量小于模板中可替换素材数量。则缺少的素材仍然是用预设素材代替。

    举例说明:出场模块中设置为 3 个可替换素材,但用户只上传了 2 个素材。替换执行逻辑为:用户上传的第 1 个素材将会替换模板中出场模块的第 1 个素材;用户上传的第 2 个素材将会替换模板中出场模块的第 2 个素材;渲染后视频的第 3 个素材为模板中第 3 个预设素材。

  • 入场模块、出场模块素材替换完成后,其余素材将被放置到转场模块中。若有多个转场模块,则在素材足够的情况下按照转场模块顺序依次替换其素材。

    举例说明:模板中入场模块、出场模块分别含有 1 个可替换素材。2 个转场模块(下文称之为转场模块 A 和 B)的可替换素材数量为 2 个 和 4 个。若用户素材数量为 10 个,则最终的渲染结果如下图所示:

Alt text

  • 在转场模块替换素材时,若剩余素材数量小于当前转场模块中可替换素材数量时,渲染引擎将在全部转场模块当中依次遍历直至找到合适的转场模块。并将素材填入其中。

    举例说明:如上述例子所示,用户上传 12 个素材,依次替换顺序为:[入场模块 1个]、[出场模块 1 个]、[转场模块 A 2个]、[转场模块 B 4个]、[转场模块 A 2个]、[转场模块 A 2个],刚好全部使用,因此最终的渲染结果如下图所示:

Alt text

  • 若剩余素材数量小于当前转场模块可替换素材数量,且小于所有转场模块中可替换素材数量。则剩余的素材将会被引擎抛弃掉,此素材不参与视频渲染。

    举例说明:如上述例子所示,用户上传 13 个素材,依次替换顺序为:[入场模块 1个]、[出场模块 1 个]、[转场模块 A 2个]、[转场模块 B 4个]、[转场模块 A 2个]、[转场模块 A 2个],完成上述替换后,剩余 1 个用户上传的素材,因无任何转场模块的坑位数量为 1,因此将其舍弃。因此最终的渲染结果如下图所示:

Alt text

设计要求

  • 背景模块在最底层,入场模块在次底层,转场模块在中间层,出场模块在最上层。如图:

Alt text

转场模块、出场模块、入场模块若存在重叠情况,则制作的效果为:上一个动画片段未结束,但下一个动画已经出现。

  • 主合成 main 合成中除了入场(entry)、出场(exit)、前景(foreground)、背景(background)、转场(part)之外禁止含有其他图层,并且均需以预合成的形式存在。

  • 出场、入场、转场需在一个预合成中,且该合成不能添加缩放、位移等效果。

  • 可替换图层只能是图片图层,用户可以上传图片/视频来替换。

  • 背景音乐有且仅能有 1 个,放在背景模块中,名称固定为dyn_aud_bg,用户可上传音频文件进行替换。

  • 模块命名
  • 可替换素材命名规范
  • 动态模板结构
  • 用户上传素材和动画模块对应关系
  • 设计要求
  • 在线技术支持
  • 专业售前售后团队
  • 版本定期更新
  • 全方位解决方案

商务合作

  • 177-6716-7529
  • 2969573855
  • sales@tusdk.com
  • 浙江省 杭州市 西湖区 西斗门9号 福地创业园1号楼3楼301室

关注我们

qrcode

©2019-2025 TUTUCLOUD. All Rights Reserved. 杭州元凡视觉智能科技有限公司 | 浙ICP备14040447号-1 | 浙公网安备33010602001649号

  • 177-6716-7529
  • sales@tusdk.com
  • 2969573855