接口規范 14.轉碼接口

14 轉碼相關接口

14.1.轉碼接口

• 用途
  對上傳到服務器上的視頻進行轉碼，轉碼后可以面向互聯網或局域網發布播出。

• 請求
  transcodeMgr/?request=transcode&application=vod&src=案例視頻8.mp4&src_id=video89&video_bitrate=800&audio_bitrate=60&width=0&height=0&deinterlace=OFF&encoding=UTF-8&audio_stream=&output_formats=hls;flv;mp4&publish=&title=
  參數說明：
  src 輸入文件名，如果文件在轉碼目錄的下級子目錄內，則需要包含該子目錄，如： subdir/myvideo.mp4。中文文件名參數使用UTF-8字符集編碼。
  encoding 輸入文件名在服務器上的實際字符集編碼。如果是UTF-8可以省略。
  src_id 轉碼后輸出資源的資源編號，由轉碼方提供（可以和集成的業務系統關聯對應）,只能包含英文字符和數字，要確保其唯一性。這個編號就是資源在流媒體服務器上的播出流名稱，可以使用該編號獲取播出視頻流。
  application 應用名，定義轉碼結束后資源發布到流媒體服務器上的哪個應用下。該應用名和流名稱（對應src_id）可以確定一個資源的播出地址。
  video_bitrate 視頻轉碼的比特率，單位Kbps，如果省略表示不對視頻進行轉碼。只有視頻格式是H264，并且碼率大小適合播出（如在2Mbps以下），才可以省略該參數。
  audio_bitrate 音頻轉碼的比特率，單位Kbps，如果省略表示不對音頻進行轉碼。只有音頻格式是AAC，并且碼率大小適合播出（如在100Kbps以下），才可以省略該參數。
  width 視頻轉碼輸出的畫面寬度，省略或者設為0表示不改變畫幅，使用原始視頻的畫幅大小。
  height 視頻轉碼輸出的畫面高度，省略或者設為0表示不改變畫幅，使用原始視頻的畫幅大小。
  deinterlace 對于隔行掃描的視頻畫面，該參數定義是否進行畫面的反交錯處理，ON表示要進行反交錯，OFF或者省略表示不進行反交錯處理。
  audio_stream 音頻流索引號，對于多語言的多媒體提文件，會包含多個語言的音頻流，使用該參數可以選擇一種語言輸出。不清楚怎么使用時，請省略該參數，大部分情況下不需要提供。
  output_formats 轉碼輸出格式，可以是flv,hls,mp4格式的一種或幾種，多種格式使用分號隔開。
  publish 如果需要將轉碼輸出的視頻信息發布到第三方系統，可以提供發布地址，轉碼結束后會將視頻信息提交給該地址。如果沒有該需求，請省略該參數和title參數。
  title 如果要進行轉碼信息發布，可以提供一個發布的標題。

• 響應

  {
  "code":0
  }

14.2.轉碼接口

• 用途
  查詢服務器上正在轉碼的轉碼任務的進度，該接口返回所有正在轉碼任務的列表。
• 請求
  transcodeMgr/?request=list_working
• 響應

  {
  "code":0,
  "data":{
      "count":1,
      "items":[
          {
              "status":"working",
              "src_file":"案例視頻8.mp4",
              "application":"vod",
              "bitrate":"800",
              "width":"640",
              "height":"352",
              "bitrate_audio":"56",
              "src_id":"8ass3",
              "add_time":"1516947498",
              "from":null,
              "start_time":"1516947498",
              "encode_progress":"1.0%",
              "work_duration":1
          }
      ]
  }
  }

  返回0或多個轉碼任務的進度信息。
  src_file 轉碼文件名
  application 輸出應用名
  src_id 資源編號
  start_time 開始轉碼時間，Unix時間戳
  encode_progress 轉碼進度，百分比格式
  work_duration 轉碼持續時間，單位秒
  bitrate 視頻轉碼碼率，Kbps
  bitrate_audio 音頻轉碼碼率,Kpbs
  width 轉碼輸出畫幅寬度
  height 轉碼輸出畫幅高度

14.3.停止轉碼接口

• 用途
  停止一個正在轉碼的任務。

• 請求
  transcodeMgr/?request=stop_transcode&src_id=8ass3
  src_id 轉碼任務的資源編號，由轉碼接口傳入。

• 響應

  {
  "code":0
  }