接口規範 14.轉碼接口
阿新 • • 發佈:2018-01-26
返回 working pbs 集成 dir 地址 一個 hls 查詢 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)可以確定一個資源的播出地址。
audio_bitrate 音頻轉碼的比特率,單位Kbps,如果省略表示不對音頻進行轉碼。只有音頻格式是AAC,並且碼率大小適合播出(如在100Kbps以下),才可以省略該參數。
width 視頻轉碼輸出的畫面寬度,省略或者設為0表示不改變畫幅,使用原始視頻的畫幅大小。
height 視頻轉碼輸出的畫面高度,省略或者設為0表示不改變畫幅,使用原始視頻的畫幅大小。
deinterlace 對於隔行掃描的視頻畫面,該參數定義是否進行畫面的反交錯處理,ON表示要進行反交錯,OFF或者省略表示不進行反交錯處理。
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 }
接口規範 14.轉碼接口