云点播转动图-开发指南-文档中心-腾讯云

转动图是选取视频片段生成动图（GIF 和 WEBP 等）的过程，是一种离线任务。动图是一组连续帧的无缝循环，以较小的体积实现动画效果。
说明：
支持转动图时，指定动图在原始视频中的起始和结束时间，即「截取视频的一段」转成动图。
转动图模板
转动图的目标规格，包含动图格式、宽高和帧率等参数。云点播使用转动图模板表示转动图参数集合，通过转动图模板，可以指定以下动图相关参数。
参数
说明
格式（Format）
动图文件的输出格式，目前仅支持 GIF 和 WEBP。
宽度（Width）
动图宽度，范围是128px - 4096px。
高度（Height）
动图高度，范围是128px - 4096px。
帧率（FPS）
支持的帧率范围是1fps - 60fps。
针对常见的规格，云点播提供了 预置转动图模板。另外，您还可以通过控制台创建和管理自定义转动图模板，具体操作请参考 模板设置。
任务发起
发起转动图任务，有“通过服务端 API 直接发起”，“通过控制台直接发起”和“上传时指定要执行的任务”三种方式。具体请参照视频处理的 任务发起。
以下是各种方式发起转动图任务的说明：
调用服务端 API ProcessMedia 发起任务：在请求中的MediaProcessTask.AnimatedGraphicTaskSet参数指定 转动图模板 的模板 ID。
通过控制台对视频发起任务：在控制台 添加任务流，任务流中设置目标转动图规格；在控制台使用该任务流 发起视频处理。
服务端上传时指定任务：在控制台 添加任务流，任务流中设置目标转动图规格；申请上传 中的procedure参数指定为该任务流。
客户端上传时指定任务：在控制台 添加任务流，任务流中设置目标转动图规格；在 客户端上传签名 中的procedure指定该任务流。
控制台上传：在控制台 添加任务流，任务流中设置目标转动图规格；通过控制台上传视频，选择 上传的同时对视频进行处理操作 并指定视频上传后执行该任务流。
结果获取
发起转动图任务后，您可以通过异步等待 结果通知 和同步进行 任务查询 两种方式获取转动图的执行结果。下面是发起转动图任务后，普通回调方式下结果通知的示例（省略了值为 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有一个Type为AnimatedGraphics类型的转动图结果，Definition为20001。
参数	说明
格式（Format）	动图文件的输出格式，目前仅支持 GIF 和 WEBP。
宽度（Width）	动图宽度，范围是128px - 4096px。
高度（Height）	动图高度，范围是128px - 4096px。
帧率（FPS）	支持的帧率范围是1fps - 60fps。
转动图

本页目录：

转动图模板

任务发起

结果获取
