扫一扫咨询方案
首页
登录/注册

{user.username}

ID: {user.id}

模板 SDK 文档

  • 云渲染

    • Demo下载
    • SDK
    • 开发指南
    • AI API 文档
    • 开发者 API 文档
    • 控制台指南
    • 快速入门
    • 产品简介
  • 模板SDK

    • 用户常见问题
    • Demo 下载
    • 开发指南
    • 服务端 SDK
    • iOS SDK
    • 安卓端 SDK
    • 产品简介
  • 剪辑SDK

    • Demo下载
    • SDK
    • 开发指南
    • 产品简介
  • 模板制作教程

    • 模板制作进阶教程
    • 测试模板素材案例下载
    • 常见模板制作案例
    • 模板制作教程
    • 模板制作工具下载
    • 入门指南
  • 剪辑制作教程

    • 剪辑特效导出教程
    • 剪辑特效测试素材
    • 剪辑特效制作工具下载
    • 入门指南
产品简介
安卓端 SDK
iOS SDK
服务端 SDK
开发指南
Demo 下载
用户常见问题
首页 > 开发指南 > 动态模板结构config说明

动态模板结构config说明

更新时间 : 2021-07-30 17:47:45

动态模板结构及 config.json 说明

模板文件夹结构

  1. assets:存放所有参与模板渲染资源文件
  2. datas:存放左右动画数据文件
  3. ui:存放ui界面设计所需配饰图文件
  4. config.json:模板配置文件
  5. music.mp3:音频文件

动态模板config文件介绍

{
    "settings": {
        "attr": 0 //属性设置 1:打开OIT渲染
    },
    "fps": 30, //模板的主帧速率
    "size": [
        720,
        1280
    ], // 模板的宽高,像素为单位
    "duration": 592, // 模板的设计时长,帧为单位。注意,动态模板的实际时长会根据用户素材数量进行调整,实际时长请使用SDK接口来获取
    "description": "合成 1", //模板的描述,对应AE中主合成的名称
    "version": "1.3.0.beta", //SDK内核版本号,与渲染效果息息相关
    "ui_version": "2.0", //编辑界面版本号目前分为1.0与2.0 2.0界面更加完善更加易懂
    "type": 2, //模版属性,按位设置, 1:普通模版, 2:动态模版,4:滤镜, 512:字符动画
    "expand": 1, // 模板素材宽高适配方式,具体请看 [图片适配方式说明](https://www.seeshiontech.com/docs/page_81.html)
    "bg": "#ff000000", // 模板背景色,ARGB
    "entrance": {}, // 入场元素对应的合成对象,对象内结构为标准的comp对象结构。该字段根据实际设计情况,可选
    "exit": {}, // 出场元素对应的合成对象,对象内结构为标准的comp对象结构。该字段根据实际设计情况,可选
    "foreground": {}, // 前景元素对应的合成对象,对象内结构为标准的comp对象结构。该字段根据实际设计情况,可选
    "background": {}, // 背景元素对应的合成对象,对象内结构为标准的comp对象结构。该字段根据实际设计情况,可选
    "sources": [
        {}
    ], // 素材包裹元素对应的合成对象数组,数组内每个对象的内结构均为标准的comp对象结构。
    "segments": [
        {}
    ], // 动画片段元素对应的合成对象数组,数组内每个对象的内结构均为标准的comp对象结构。
    "others": [
        {}
    ], // 其他用到的合成对象数组,数组内每个对象的内结构均为标准的comp对象结构。
    "offsets": [
        {}
    ], // 每段转场的时长。
    "asset_layout": [
        {}
    ], // 素材对应关系数组。
    "assets": [
        { //保存所有素材对象数组。注意!动态模板的技术实现不需要设计师把需要替换的主素材标记为可编辑,但是也允许设计师进行标记,方便实现一些高级业务逻辑。
            "key": "assetkey0", //素材的唯一ID
            "ui_key": "", //设计师在导出工具中为素材设置的标识key
            "ui_extra": "", //设计师在导出工具中为素材设置的附加数据
            "fps": 30, //在AE中解释素材选项中如果指定帧速率,则存在此key,否则为0或不存在
            "name": "asset1.mp4", //素材的名称,根据素材类型type的不同,name字段的作用也不同  
            "type": 1, //素材的类型 0:未知的素材类型 1:图片或视频或图片序列帧素材 2:OpenGL纹理素材 3:预合成素材 4:固态颜色素材 5:自定义素材
            "num": 0, //如果该素材为图片序列帧素材,那么这个num代表序列帧文件的数量,其他情况下num字段为0
            "text_anim": "data.json", //文字动画数据,仅开启高级字符动画时存在
            "size": [
                1080,
                1920
            ], //素材大小,ui 2.0 文字素材不再使用这个尺寸(参考 editSize)
            "ui": { //变换信息仅支持2D 图片与文字只同时存在一种
                "f": "a.png", //前景图(配饰图)
                "b": "b.png", //背景图
                //图片素材信息
                "group": 10, //组索引
                "index": 0, //组内索引
                "duration": 278, //持续帧数(以主合成帧率为基准的最大帧数)
                "accept": 0, //接受素材类型
                "type": 1, //可编辑类型 1:图片 2:文字 3: 高级字符动画文字
                "editSize": [
                    100,
                    100
                ], // 编辑区域,图片素材大小
                "p": [
                    100.5,
                    38.0
                ],
                "a": [
                    100.5,
                    38.0
                ],
                "s": [
                    1.0,
                    1.0
                ],
                "t": 1.0,
                "r": 0.0,
            "area": [
                    0,
                    0,
                    100,
                    100
                ] // 设计师指定的点击选中区域
                //文字素材信息
                "group": 9, //组索引
                "index": 0, //组内索引
                "duration": 348, //持续帧数(以主合成帧率为基准的最大帧数)
                "type": 2, //可编辑类型 1:图片 2:文字 3: 高级字符动画文字
                "default": "编辑文字", //默认文字
                "max": 4, //最大字数
                "font": "SimHei", //字体完整名称
                "font_style": "Regular", //字体样式(例如粗体、细体或斜体等)
                "font_family": "STSong", //字体系列名称
                "font_file": "Songti.ttc", //字体文件名称(不保证为所有字体类型返回字符串;对于某些类型的字体,返回值可能是空字符串)
                "size": 92, //字体大小
                "line_height": 110, //行高
                "fill": "#ffffff", //填充颜色
                "stroke": "#000000", //描边颜色
                "width": 0, //描边宽度
                "strokeOverFill": true, //描边是画在填充之上
                "align": 0, //排版方式 0:左对齐 1:右对齐 2:居中对齐
                "direction": 0, //文字方向 0:横向文字 1:纵向文字
                //--------------------------------------------------------------------------------
                //type=3类型文字可调用SDK绘制图片,需要用到以下信息
                "box_text": true, //是否是文本框类型文字(仅高级字符动画支持)
                "adapt": true, //是否开启自适应(仅高级字符动画支持)
                "bound": [
                    -50,
                    -50,
                    100,
                    100
                ], //文本框[x,y,width,height](仅高级字符动画支持)
                //--------------------------------------------------------------------------------
                "faux_bold": true, //是否使用仿粗体 (高级字符动画暂未支持)
                "faux_italic": true, //是否使用仿斜体 (高级字符动画暂未支持)
                "shadow": "#000000", //投影 (弃用,图层样式投影已支持)
                "s_alpha": 0.0, //(弃用,图层样式投影已支持)
                "s_angle": 0, //(弃用,图层样式投影已支持)
                "s_dist": 0, //(弃用,图层样式投影已支持)
                "s_size": 0, //(弃用,图层样式投影已支持)
                "editSize": [
                    100,
                    100
                ], // 编辑区域,文字图片素材大小
                "p": [
                    0.0,
                    0.0
                ],//位置
                "a": [
                    0.0,
                    0.0
                ],// 锚点
                "s": [
                    1.0,
                    1.0
                ],//缩放
                "t": 1.0, //透明度
                "r": 0.0,  //旋转
                "area": [
                    0,
                    0,
                    100,
                    100
                ] // 设计师指定的点击选中区域
            }
        }
    ],
    "ui_group": [
        {
            "size": [
                720,
                1080
            ]
        },
        {
            "size": [
                720,
                1080
            ]
        }
    ]
}
首页 > 开发指南 > 动态模板结构config说明
动态模板结构config说明
更新时间 : 2021-07-30 17:47:45
  • 云渲染
    • Demo下载
    • SDK
    • 开发指南
    • AI API 文档
    • 开发者 API 文档
    • 控制台指南
    • 快速入门
    • 产品简介
  • 模板SDK
    • 用户常见问题
    • Demo 下载
    • 开发指南
    • 服务端 SDK
    • iOS SDK
    • 安卓端 SDK
    • 产品简介
  • 剪辑SDK
    • Demo下载
    • SDK
    • 开发指南
    • 产品简介
  • 模板制作教程
    • 模板制作进阶教程
    • 测试模板素材案例下载
    • 常见模板制作案例
    • 模板制作教程
    • 模板制作工具下载
    • 入门指南
  • 剪辑制作教程
    • 剪辑特效导出教程
    • 剪辑特效测试素材
    • 剪辑特效制作工具下载
    • 入门指南

动态模板结构及 config.json 说明

模板文件夹结构

  1. assets:存放所有参与模板渲染资源文件
  2. datas:存放左右动画数据文件
  3. ui:存放ui界面设计所需配饰图文件
  4. config.json:模板配置文件
  5. music.mp3:音频文件

动态模板config文件介绍

{
    "settings": {
        "attr": 0 //属性设置 1:打开OIT渲染
    },
    "fps": 30, //模板的主帧速率
    "size": [
        720,
        1280
    ], // 模板的宽高,像素为单位
    "duration": 592, // 模板的设计时长,帧为单位。注意,动态模板的实际时长会根据用户素材数量进行调整,实际时长请使用SDK接口来获取
    "description": "合成 1", //模板的描述,对应AE中主合成的名称
    "version": "1.3.0.beta", //SDK内核版本号,与渲染效果息息相关
    "ui_version": "2.0", //编辑界面版本号目前分为1.0与2.0 2.0界面更加完善更加易懂
    "type": 2, //模版属性,按位设置, 1:普通模版, 2:动态模版,4:滤镜, 512:字符动画
    "expand": 1, // 模板素材宽高适配方式,具体请看 [图片适配方式说明](https://www.seeshiontech.com/docs/page_81.html)
    "bg": "#ff000000", // 模板背景色,ARGB
    "entrance": {}, // 入场元素对应的合成对象,对象内结构为标准的comp对象结构。该字段根据实际设计情况,可选
    "exit": {}, // 出场元素对应的合成对象,对象内结构为标准的comp对象结构。该字段根据实际设计情况,可选
    "foreground": {}, // 前景元素对应的合成对象,对象内结构为标准的comp对象结构。该字段根据实际设计情况,可选
    "background": {}, // 背景元素对应的合成对象,对象内结构为标准的comp对象结构。该字段根据实际设计情况,可选
    "sources": [
        {}
    ], // 素材包裹元素对应的合成对象数组,数组内每个对象的内结构均为标准的comp对象结构。
    "segments": [
        {}
    ], // 动画片段元素对应的合成对象数组,数组内每个对象的内结构均为标准的comp对象结构。
    "others": [
        {}
    ], // 其他用到的合成对象数组,数组内每个对象的内结构均为标准的comp对象结构。
    "offsets": [
        {}
    ], // 每段转场的时长。
    "asset_layout": [
        {}
    ], // 素材对应关系数组。
    "assets": [
        { //保存所有素材对象数组。注意!动态模板的技术实现不需要设计师把需要替换的主素材标记为可编辑,但是也允许设计师进行标记,方便实现一些高级业务逻辑。
            "key": "assetkey0", //素材的唯一ID
            "ui_key": "", //设计师在导出工具中为素材设置的标识key
            "ui_extra": "", //设计师在导出工具中为素材设置的附加数据
            "fps": 30, //在AE中解释素材选项中如果指定帧速率,则存在此key,否则为0或不存在
            "name": "asset1.mp4", //素材的名称,根据素材类型type的不同,name字段的作用也不同  
            "type": 1, //素材的类型 0:未知的素材类型 1:图片或视频或图片序列帧素材 2:OpenGL纹理素材 3:预合成素材 4:固态颜色素材 5:自定义素材
            "num": 0, //如果该素材为图片序列帧素材,那么这个num代表序列帧文件的数量,其他情况下num字段为0
            "text_anim": "data.json", //文字动画数据,仅开启高级字符动画时存在
            "size": [
                1080,
                1920
            ], //素材大小,ui 2.0 文字素材不再使用这个尺寸(参考 editSize)
            "ui": { //变换信息仅支持2D 图片与文字只同时存在一种
                "f": "a.png", //前景图(配饰图)
                "b": "b.png", //背景图
                //图片素材信息
                "group": 10, //组索引
                "index": 0, //组内索引
                "duration": 278, //持续帧数(以主合成帧率为基准的最大帧数)
                "accept": 0, //接受素材类型
                "type": 1, //可编辑类型 1:图片 2:文字 3: 高级字符动画文字
                "editSize": [
                    100,
                    100
                ], // 编辑区域,图片素材大小
                "p": [
                    100.5,
                    38.0
                ],
                "a": [
                    100.5,
                    38.0
                ],
                "s": [
                    1.0,
                    1.0
                ],
                "t": 1.0,
                "r": 0.0,
            "area": [
                    0,
                    0,
                    100,
                    100
                ] // 设计师指定的点击选中区域
                //文字素材信息
                "group": 9, //组索引
                "index": 0, //组内索引
                "duration": 348, //持续帧数(以主合成帧率为基准的最大帧数)
                "type": 2, //可编辑类型 1:图片 2:文字 3: 高级字符动画文字
                "default": "编辑文字", //默认文字
                "max": 4, //最大字数
                "font": "SimHei", //字体完整名称
                "font_style": "Regular", //字体样式(例如粗体、细体或斜体等)
                "font_family": "STSong", //字体系列名称
                "font_file": "Songti.ttc", //字体文件名称(不保证为所有字体类型返回字符串;对于某些类型的字体,返回值可能是空字符串)
                "size": 92, //字体大小
                "line_height": 110, //行高
                "fill": "#ffffff", //填充颜色
                "stroke": "#000000", //描边颜色
                "width": 0, //描边宽度
                "strokeOverFill": true, //描边是画在填充之上
                "align": 0, //排版方式 0:左对齐 1:右对齐 2:居中对齐
                "direction": 0, //文字方向 0:横向文字 1:纵向文字
                //--------------------------------------------------------------------------------
                //type=3类型文字可调用SDK绘制图片,需要用到以下信息
                "box_text": true, //是否是文本框类型文字(仅高级字符动画支持)
                "adapt": true, //是否开启自适应(仅高级字符动画支持)
                "bound": [
                    -50,
                    -50,
                    100,
                    100
                ], //文本框[x,y,width,height](仅高级字符动画支持)
                //--------------------------------------------------------------------------------
                "faux_bold": true, //是否使用仿粗体 (高级字符动画暂未支持)
                "faux_italic": true, //是否使用仿斜体 (高级字符动画暂未支持)
                "shadow": "#000000", //投影 (弃用,图层样式投影已支持)
                "s_alpha": 0.0, //(弃用,图层样式投影已支持)
                "s_angle": 0, //(弃用,图层样式投影已支持)
                "s_dist": 0, //(弃用,图层样式投影已支持)
                "s_size": 0, //(弃用,图层样式投影已支持)
                "editSize": [
                    100,
                    100
                ], // 编辑区域,文字图片素材大小
                "p": [
                    0.0,
                    0.0
                ],//位置
                "a": [
                    0.0,
                    0.0
                ],// 锚点
                "s": [
                    1.0,
                    1.0
                ],//缩放
                "t": 1.0, //透明度
                "r": 0.0,  //旋转
                "area": [
                    0,
                    0,
                    100,
                    100
                ] // 设计师指定的点击选中区域
            }
        }
    ],
    "ui_group": [
        {
            "size": [
                720,
                1080
            ]
        },
        {
            "size": [
                720,
                1080
            ]
        }
    ]
}