1. 程式人生 > >接口規範 14.轉碼接口

接口規範 14.轉碼接口

返回 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)可以確定一個資源的播出地址。
    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
    }

接口規範 14.轉碼接口