回调说明
功能概述
视频转码、截图、切片、鉴黄等任务处理完成后,UMedia可以回调用户的接口,通知处理的结果。
客户需提供一个接收处理结果的URL地址,处理结果被封装成 json 字符串,通过 POST 请求,传递给用户的接口。
转码回调详情
使用带有“回调URL”的转码模版创建的转码任务完成后,UMedia会将处理结果传递到模版内所填写的回调地址。
详细参数如下:
{ "retcode":0, //0 表示处理成功, "task_id":"1", //提交转码生成的任务 id "src_url":"http://src.ufile.ucloud.cn/my.mp4", //原始 url 地址 "dest_video_name":"my_720p.mp4", //目标文件名 "dest_video_url":"http://dest.ufile.ucloud.cn/my_720p.mp4", //目标文件地址 "duration":587,//转码后 视频的时长,单位秒 "file_size":587, //视频的文件大小 "width":1280,//视频的宽,单位为像素 "height":720, //视频的高,单位为像素 "message":"succ" //处理结果描述 }
截图回调详情
截图任务完成后,UMedia会将处理结果传递到创建该任务时所填写的回调地址。
详细参数如下:
{ "retcode":0, //0 表示处理成功, "task_id":"1", //提交截图生成的任务 id "src_url":"http://src.ufile.ucloud.cn/my.mp4", //原始 url 地址 "image_count":3, //截图张数 "image_list":[ {"image_url":"http://dest.ufile.ucloud.cn/my_1.jpg"}, {"image_url":"http:// dest.ufile.ucloud.cn/my_2.jpg"}, {"image_url":"http://dest.ufile.ucloud.cn/my_3.jpg"} ], "message":"succ" //处理结果描述 }
切片回调详情
切片任务完成后,UMedia会将处理结果传递到创建该任务时所填写的回调地址。
详细参数如下:
{ "retcode":0, //0 表示处理成功, "task_id":"1", //提交转码生成的任务 id "src_url":"http://src.ufile.ucloud.cn/my.mp4", //原始 url 地址 "dest_video_name":"my.m3u8", //目标文件名 "dest_video_url":"http://dest.ufile.ucloud.cn/my.m3u8", //目标文件地址 "duration":587, //切片后视频的时长,单位秒 "message":"succ" //处理结果描述 }
鉴黄回调详情
UMedia当前通过API调用方式提供视频鉴黄服务。
鉴黄任务完成后,UMedia会将处理结果传递到调用API创建该任务时所填写的回调地址。
详细参数如下:
{ "retcode":0, //0 表示处理成功, "task_id":"1", //提交鉴黄生成的任务 id "src_url":"http://src.ufile.ucloud.cn/my.mp4", //原始 url 地址 "image_count":5, //总的鉴黄图片张数 "invalid_image_list":[ //有问题的图片列表 { "name":" http://dest.ufile.ucloud.cn/my_1.jpg", //图片地址 "rate":0.9999947547912598, //该图片被识别为某个分类的概率值 "label":0, //图片分类,0 为色情,1 为性感,2 为正常 "review":false //是否需要人工审核 }, { "name":" http://dest.ufile.ucloud.cn/my_2.jpg", "rate":0.9999947547912598, "label":0, "review":false //是否需要人工审核 } ], "message":"succ" //处理结果描述 }