首页 > 动态模板高级素材替换规范（废弃）

动态模板高级素材替换规范（废弃）

更新时间 : 2021-01-20 15:34:08

该文档涉及的内容不再维护，推荐使用 ReplaceableJson 实现动态模板的字幕等效果

参考：https://www.seeshiontech.com/docs/page_103.html

动态模板最初只支持普通的素材（图片/视频）按顺序替换, 通过 VE 提供的高级素材替换规范和接口, 可以实现以下效果:

精确替换某个图片素材, 如: 用户头像, logo
精确替换某个文字素材, 如: 相册标题, 片尾作者昵称
按前缀替换主替换素材关联的文字素材, 如: 给每一张图片配上一个或多个字幕

实现步骤

务必先了解 ui_key 的作用

ui_key 的作用是什么
设计师按照以下视频教程标记导出动态模板

动态模板高级素材替换视频教程
需要和开发者约定好, 替换的 ui_key 或 ui_key 前缀
开发者按照规则拼装高级素材替换数据, 并调用相关接口提交数据

高级图片素材替换

DynamicSubFiles 数据格式

{
    "img_path" : "/workspace/assets/2.jpeg", // 引擎会根据图片实际路径找到对应的图层或合层，找到对应的 ui_key 比如 dimg1
    "d_key_prefix" : "dtext", // 通过 dimg1 得到序号 1, 使用d_key_prefix的值，
    "index" : 0,   // 替换次序, 可选,如果 img_path 在 setReplaceableFiles 中使用多次, 依次增加该参数, 0 = 第一次使用, 以此类推
    // 按下文的 d_img_paths 依次构造出 dtext1.1, dtext1.2 
    "d_img_paths" : [
        "/workspace/assets/235_41_text2.png", // 会替换  ui_key = dtext1.1 的图层
        "/workspace/assets/235_41_text3.png"  // 会替换 ui_key = dtext1.2 的图层
    ]
}

字段含义

img_path      主替换图片的路径，用于找到对应的主素材合层
d_key_prefix  附加素材图层　ui_key 的前缀或者全称  
d_img_paths   附加素材路径，用于依次替换 ui_key 以 d_key_prefix 为前缀的附加素材图层
index  替换次序, 如果 img_path 被重复使用, 需要指定该参数确定当前素材被绑定到第几次使用 img_path 的图层上, 从 0 开始依次递增

示例数据说明

以上数据示例有两个附加素材链接，假如 img_path 对应的 ui_key 是 dimg1, 则通过 dtext1 关联的附加素材. 会被依次替换：dtext1.1 会被替换成 d_img_paths 中的第一长图片, dtext1.2 会被替换成 d_img_paths 的第二张图片，以此类推
关联格式

img_path 对应素材的 ui_key 必须为 dimg 开头，格式为 dimg{#}， {#}代表整数序号，比如 dimg1, dimg2。

d_key_prefix 的 ui_key 格式为 dimg{#}.{#}，第1个{#}对应 dimg 的序号，第2个{#}对应附加素材的序号。

比如 dtext1.1 为 dimg1 第1个附加素材，dtext1.2 则对应 dimg1 的第2个附加素材

前缀查找替换数据格式

[
    {
        "img_path" : "/workspace/assets/2.jpeg",  // 必须设置为有效路径, 前缀查找替换
        "d_key_prefix" : "dtext",                  // 前缀匹配，按 ui_key 以 dtext 开头依次替换
        "d_img_paths" : [                          // 模板支持的附加素材数目请咨询对应模板设计师 
            "/workspace/assets/235_41_text2.png",
            "/workspace/assets/235_41_text3.png"
        ]
    }
]

精确匹配替换格式

[
    {
        "img_path" : "",                // 设置为空字符串, 精确匹配替换
        "d_key_prefix" : "dheadimg",    // 精确匹配, ui_key = dheadimg 时替换
        "d_img_paths" : [
            "./workspace/assets/235_41_text9.png"
         ]
    }
]

同时设置多个附加素材数据

[
    {                   
        "img_path" : "",                        // 精确替换
        "d_key_prefix" : "dheadimg",   
        "d_img_paths" : [
            "/workspace/assets/235_41_text9.png"
         ]
    },
    {
        "img_path" : "./workspace/assets/2.jpeg",  // 前缀替换
        "d_key_prefix" : "dtext",                  
        "d_img_paths" : [                         
            "/workspace/assets/235_41_text2.png",
            "/workspace/assets/235_41_text3.png"
        ]
    },
    {
        "img_path" : "/workspace/assets/3.jpeg",  // 前缀替换
        "d_key_prefix" : "dtext",                  
        "d_img_paths" : [                           
            "/workspace/assets/235_41_text4.png",
        ]
    }
]

重复使用 img_path 替换素材示例

主替换素材路径(通过 setReplaceableFiles 方法设置)如下:

[
"/workspace/assets/1.jpeg",
"/workspace/assets/2.jpeg", // 被使用第一次
"/workspace/assets/2.jpeg", // 被使用第二次
]

高级替换图片素材如下:

[
        {
        "img_path": "/workspace/assets/1.jpeg", // 前缀替换
        "d_key_prefix": "dtext",
        "d_img_paths": [
            "/workspace/assets/235_41_text4.png",
        ]
    },
    {
        "img_path": "/workspace/assets/2.jpeg", // 前缀替换
        "d_key_prefix": "dtext",
        "index" : 0, // 当前素材会被绑定到第1张 2.jpeg 上
        "d_img_paths": [
            "/workspace/assets/235_41_text4.png",
            "/workspace/assets/235_41_text4.png"
        ]
    },
    {
        "img_path": "/workspace/assets/2.jpeg", // 前缀替换
        "d_key_prefix": "dtext",
        "index" : 1, // 当前素材会被绑定到第2张 2.jpeg 上
        "d_img_paths": [
            "/workspace/assets/235_41_text4.png1",
            "/workspace/assets/235_41_text4.png"
        ]
    }
]

高级文字素材替换

DynamicSubTexts 数据格式

{
    "img_path" : "/workspace/assets/2.jpeg", // 引擎会根据图片实际路径找到对应的图层或合层，找到对应的 ui_key 比如 dimg1
    "d_key_prefix" : "dtext", // 通过 dimg1 得到序号 1, 使用d_key_prefix的值，
    "index" : 0,   // 替换次序, 可选,如果 img_path 在 setReplaceableFiles 中使用多次, 依次增加该参数, 0 = 第一次使用, 以此类推
    // 按下文的 d_texts 依次构造出 dtext1.1, dtext1.2 
    "d_texts" : [
        "文字内容", 　// 会替换  ui_key = dtext1.1 的图层
        "文字内容"  // 会替换 ui_key = dtext1.2 的图层
    ]
}