创建任务

  • API名称: create_task_with_conf
  • HTTP方法类型: GET
  • 所需HTTP头字段:
    • xvs-signature 签名字段
    • xvs-timestamp 签名时间戳
  • URL查询参数:
    • service_code 调用者的服务码
    • config 所要创建任务的描述字串,以xml的形式描述任务

以下是请求的抓包数据:

GET /api/20140928/create_task_with_conf?service_code=TESTING&config=%3Croot%3E%3Ctask%3E%3Cinput%3E%3Curl%3Ehttp://s3.cn-north-1.amazonaws.com.cn/developer.zhiboyun.com/v/won_640_360.flv%3C/url%3E%3C/input%3E%3Coutput%20tag=%22tr1%22%3E%3Cextension%3Eflv%3C/extension%3E%3Ccodec-v%3Eh264%3C/codec-v%3E%3Ccodec-a%3Ecopy%3C/codec-a%3E%3Csize%3E480x180%3C/size%3E%3C/output%3E%3C/task%3E%3C/root%3E HTTP/1.1
Host: c.zhiboyun.com
Connection: keep-alive
Accept: application/json, text/javascript, */*; q=0.01
xvs-timestamp: 1444286064854
User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/45.0.2454.101 Safari/537.36
Origin: http://developer.zhiboyun.com
xvs-signature: 7a1d4315efdc8f5b5a9b9d478a8b5ca870f573587cc031d7c40c8ade93180588

以下是返回数据:

HTTP/1.1 200 OK
Access-Control-Allow-Origin: *
Content-Type: text/plain
Date: Thu, 08 Oct 2015 06:34:25 GMT
transfer-encoding: chunked
Connection: keep-alive

3a
{"ret": 0, "task_id": "aws-cn_north_1-5-59e69cb54674f82d"}
0

这个例子中请求参数config的值实际上是以下xml字串做了urlencode,

<root> 
  <task> 
    <input> 
      <url>http://s3.cn-north-1.amazonaws.com.cn/developer.zhiboyun.com/v/won_640_360.flv</url> 
    </input>  
    <output tag="tr1"> 
      <extension>flv</extension>  
      <codec-v>h264</codec-v>  
      <codec-a>copy</codec-a>  
      <size>480x180</size> 
    </output> 
  </task> 
</root>

这个xml字串,描述了一个任务,这个任务包含有一个input和一个output, 在output中定义了任务输出的容器格式、视频编码和音频编码,而且定义了输出画面的大小,实际上这个任务就是一个将原有视频转码为480x180大小的一个转码任务,源来自于一个http服务器上的flv视频文件。

  • ret 调用结果 0 表示成功,非0失败。错误代码参考API返回代码表
  • task_id 为新建任务的id

有关任务的说明参考基本概念中有关任务的描述

创建任务可以用于以下应用场景:

  • 转码,如上例子
  • 将远端的直播源拉取到直播云进行直播和存储。支持的协议有rtmp, rtsp, http等。
  • 视频编辑,裁剪。
  • 视频特效处理,如加水印
  • 将多路直播源合并成一路