视频水印

注意:水印模板由于需要上传文件,且水印图片要上传到 对象存储(融合版),因此,调用该接口需要 3 步

STEP1:传递创建水印模板的基本参数。

STEP2:成功之后,点播服务返回参数中带一个 presigned 的 url 地址。使用该地址将图片上传到 对象存储(融合版) 服务器中。

STEP3:上传成功后,通过一个接口通知点播服务图片上传完成。

创建水印模板

创建水印模板url

/template/watermark/create

创建水印模板参数
{
    /**
     * 必填参数,模板名称,支持大小写字母数字以及汉字以及下划线,长度最长为20个字符,并且同一个用户名称唯一。
     */
    "name": "",
    /**
     * 可选参数,是否为选定模板,不填默认为 false。
     */
    "favorite": "true",
    /**
     *必填参数,水印所在的位置信息
     */
    "position": {
        /**
         * 可选参数,水印离屏幕顶部的距离,默认为 0。
         * 可以指定像素(例如 30px)或者百分比(例如 5%)
         * 注意:top  bottom 只能指定其中一个,如果两个都传入取 top 
         */
        "top": "10%",
        /**
         * 可选参数,水印离屏幕底部的距离,默认为 0。
         * 可以指定像素(例如 30px)或者百分比(例如 5%)
         * 注意:top  bottom 只能指定其中一个,如果两个都传入取 top 
         */
        "bottom": "10px",
        /**
         * 可选参数,水印离屏幕左侧的距离,默认为 0。
         * 可以指定像素(例如 30px)或者百分比(例如 5%)
         * 注意:left  right 只能指定其中一个,如果两个都传入取 left 
         */
        "left": "10%",
        /**
         * 可选参数,水印离屏幕右侧的距离,默认为 0。
         * 可以指定像素(例如 30px)或者百分比(例如 5%)
         * 注意:left  right 只能指定其中一个,如果两个都传入取 left 
         */
        "right": "10%",
        /**
         * 可选参数,图片的高度和宽度
         * 可以指定像素(例如 30px)或者百分比(例如 5%)
         * 当指定其中一个,另一个不指定时,另一个参数会根据实际高宽比进行缩放
         */
        "height": "10%",
        "width": "10%"
    },
    "remark":"测试转码模板1"
}
创建水印模板返回值
{
    /***
     * 本次请求的结果码。
     * 0: 创建任务成功。
     * 400: 传入参数错误。
     * 500: 系统发生错误。
     */
    "code": 0,
    /***
     * 错误文本信息,创建成功时,为空字符串。
     */
    "message": "",
    /***
     * 执行结果数据
     */
    "data" : {
        /***
         * 模板 id。
         */
        "templateId" : "100001",
        "presignedUrl": "http://watermark-uuidxxx.xstore.ctyun.cn/xxxxxx?signature=xxxxxx"
    }
}

上传水印图片

在创建水印模板中,您得到一个地址,该地址是一个预签名的标准 S3 协议的 Restful URL,您需要将文件通过 PUT 的方式上传到该地址。该地址相关的参数请参考 S3 put object 相关的文档。

水印文件支持 5M 以内的 PNG 格式的图片。

由于水印文件都不大,因此不需要在此业务中支持 multipart-upload。

完成上传水印

完成上传水印url

/template/watermark/create/complete

完成上传水印入参
{
    "templateId": "10001"
}
完成上传水印返回值
{
    /***
     * 本次请求的结果码。
     * 0: 创建任务成功。
     * 400: 传入参数错误。
     * 500: 系统发生错误。
     */
    "code": 0,
    /***
     * 错误文本信息,创建成功时,为空字符串。
     */
    "message": ""
}