转动图

最后更新时间:2020-10-20 15:48:51

    转动图是选取视频片段生成动图(GIF 和 WEBP 等)的过程,是一种离线任务。动图是一组连续帧的无缝循环,以较小的体积实现动画效果。

    说明:

    支持转动图时,指定动图在原始视频中的起始和结束时间,即「截取视频的一段」转成动图。

    转动图模板

    转动图的目标规格,包含动图格式、宽高和帧率等参数。云点播使用转动图模板表示转动图参数集合,通过转动图模板,可以指定以下动图相关参数。

    参数 说明
    格式(Format) 动图文件的输出格式,目前仅支持 GIF 和 WEBP。
    宽度(Width) 动图宽度,范围是128px - 4096px。
    高度(Height) 动图高度,范围是128px - 4096px。
    帧率(FPS) 支持的帧率范围是1fps - 60fps。

    针对常见的规格,云点播提供了 预置转动图模板。另外,您还可以通过控制台创建和管理自定义转动图模板,具体操作请参考 模板设置

    任务发起

    发起转动图任务,有“通过服务端 API 直接发起”,“通过控制台直接发起”和“上传时指定要执行的任务”三种方式。具体请参照视频处理的 任务发起

    以下是各种方式发起转动图任务的说明:

    结果获取

    发起转动图任务后,您可以通过异步等待 结果通知 和同步进行 任务查询 两种方式获取转动图的执行结果。下面是发起转动图任务后,普通回调方式下结果通知的示例(省略了值为 null 的字段):

    {
        "EventType":"ProcedureStateChanged",
        "ProcedureStateChangeEvent":{
            "TaskId":"1256768367-Procedure-2e1af2456351812be963e309cc133403t0",
            "Status":"FINISH",
            "FileId":"5285890784246869930",
            "FileName":"动物世界",
            "FileUrl":"http://1256768367.vod2.myqcloud.com/xxx/xxx/AtUCmy6gmIYA.mp4",
            "MetaData":{
                "AudioDuration":60,
                "AudioStreamSet":[
                    {
                        "Bitrate":383854,
                        "Codec":"aac",
                        "SamplingRate":48000
                    }
                ],
                "Bitrate":1021028,
                "Container":"mov,mp4,m4a,3gp,3g2,mj2",
                "Duration":60,
                "Height":480,
                "Rotate":0,
                "Size":7700180,
                "VideoDuration":60,
                "VideoStreamSet":[
                    {
                        "Bitrate":637174,
                        "Codec":"h264",
                        "Fps":23,
                        "Height":480,
                        "Width":640
                    }
                ],
                "Width":640
            },
            "MediaProcessResultSet":[
                {
                    "Type":"AnimatedGraphics",
                    "AnimatedGraphicTask":{
                        "Status":"SUCCESS",
                        "ErrCode":0,
                        "Message":"",
                        "Input":{
                            "Definition":20001,
                            "StartTimeOffset":2,
                            "StartTimeOffset":5
                        },
                        "Output":{
                            "Url":"http://1256768367.vod2.myqcloud.com/xxx/xxx/v.f20001.webp",
                            "Definition":20001,
                            "Container":"webp",
                            "Height":480,
                            "Width":640,
                            "Bitrate":324271,
                            "Size":121601,
                            "Md5":"084d403c73930ca2f835679af1f37bd3",
                            "StartTimeOffset":3,
                            "EndTimeOffset":5
                        }
                    }
                }
            ],
            "TasksPriority":0,
            "TasksNotifyMode":""
        }
    }

    回调结果中,ProcedureStateChangeEvent.MediaProcessResultSet有一个TypeAnimatedGraphics类型的转动图结果,Definition为20001。