视频水印
注意:水印模板由于需要上传文件,且水印图片要上传到 对象存储(融合版),因此,调用该接口需要 3 步
STEP1:传递创建水印模板的基本参数。
STEP2:成功之后,点播服务返回参数中带一个 presigned 的 url 地址。使用该地址将图片上传到 对象存储(融合版) 服务器中。
STEP3:上传成功后,通过一个接口通知点播服务图片上传完成。
/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。
/template/watermark/create/complete
{
"templateId": "10001"
}
{
/***
* 本次请求的结果码。
* 0: 创建任务成功。
* 400: 传入参数错误。
* 500: 系统发生错误。
*/
"code": 0,
/***
* 错误文本信息,创建成功时,为空字符串。
*/
"message": ""
}