服务端 API 文档

视频编辑

最近更新时间:2021-05-25 11:02:17

视频编辑,是对云点播中的视频进行剪辑和拼接的过程,是一种离线任务。视频编辑的功能包括以下几种:

  • 视频剪辑:对云点播中的一个文件进行剪辑,生成一个新的视频。
  • 视频拼接:对云点播中的多个文件进行拼接,生成一个新的视频。
  • 视频剪辑后拼接:对云点播中的多个文件进行剪辑,然后再拼接,生成一个新的视频。
  • 直播流转视频:对云点播中的一个流进行处理,生成一个新的视频。
  • 直播流剪辑:对云点播中的一个流进行剪辑,生成一个新的视频。
  • 直播流拼接:对云点播中的多个流进行拼接,生成一个新的视频。
  • 直播流剪辑后拼接:对云点播中的多个流进行剪辑,然后拼接,生成一个新的视频。
注意:

当对直播流做剪辑、拼接等操作时,请确保流结束后再操作,否则生成的视频可能不完整。

编辑后生成的新视频封装格式是 MP4。发起编辑时,可以指定是否对生成的新视频执行 任务流

任务发起

视频编辑任务,通过 服务端 API 方式发起。调用 API 的返回结果中包含任务 ID,用于关联 结果获取 时对应的任务结果。

结果获取

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

{
  "EventType":"EditMediaComplete",
  "EditMediaCompleteEvent":{
      "TaskId":"EditMedia-f5ac8127b3b6b85cdc13f237c6005d8",
      "Status":"FINISH",
      "ErrCode":0,
      "Message":"SUCCESS",
      "Input":{
          "InputType":"File",
          "FileInfoSet":[
              {
                  "FileId":"24961954183381008",
                  "StartTimeOffset":0,
                  "EndTimeOffset":300
              },
              {
                  "FileId":"24961954183381009",
                  "StartTimeOffset":0,
                  "EndTimeOffset":300
              },
              {
                  "FileId":"24961954183381010",
                  "StartTimeOffset":0,
                  "EndTimeOffset":300
              }
          ]
      },
      "Output":{
          "FileType":"mp4",
          "FileId":"24961954183923290",
          "FileUrl":"http://125676836723.vod2.myqcloud.com/xxx/xxx/f0.mp4"
      },
      "ProcedureTaskId":""
  }
}

回调结果中,Input.InputTypeFile,表示编辑的视频是文件类型。Input.FileInfoSet包含三个元素,其中StartTimeOffset0EndTimeOffset300,表示对三个视频各剪辑前5分钟的片段后再做拼接,拼接后的视频时长为15分钟。Output.FileId是视频编辑后生成的新视频的 FileId,视频的播放 URL 是FileUrl中的值。

目录