ApsaraVideo Live：直播轉碼

• 窄帶高清模板

1. 登入ApsaraVideo for Live控制台。

2. 單擊功能管理>直播轉碼，進入直播轉碼頁面。

3. 選擇您所需要配置的網域名稱，單擊通用轉碼頁簽，單擊添加，配置轉碼模板。

   

   轉碼模板參數及說明如下表所示。

   參數	說明
   AppName	AppName必須與推流地址中的AppName名稱一樣，轉碼模板才會生效。 AppName不超過256字元，支援數字、大小寫字母、短劃線（-）、底線（_）。 AppName也支援輸入單個星號（*）字元，表示匹配任一字元串（包括Null 字元串）。 說明 如果配置了AppName為單個星號（*）的轉碼模板：當使用者拉流轉碼時，優先匹配和推流地址中AppName名稱一樣的轉碼模板；若不存在和推流地址中AppName名稱一樣的轉碼模板，則會匹配AppName為單個星號（*）的轉碼模板。
   觸發轉碼	開啟時：首次拉流時才啟動轉碼。 關閉時：只要有推流就啟動轉碼，與是否有拉流無關。
   轉碼模板類型	窄帶高清™模板提供四種轉碼模板：流暢、標清、高清、超清。 說明 轉碼模板可以一次選擇多個。 模板ID是拼接轉碼地址的參數，拼接方式參見產生推流地址和播放地址。 轉碼模板參數說明如下： 模板名稱：流暢、標清、高清、超清、原畫-僅轉音頻。 模板名稱：流暢、標清、高清、超清。 模板ID：不同轉碼模板的模板ID不同，詳見系統預設模板。 橫豎屏：支援選擇橫屏或豎屏。 解析度（寬*高）：顯示不同轉碼模板的寬度和高度。 編碼格式：支援選擇H264、H265、AAC、Opus。 編碼格式：支援選擇H264、H265。 轉碼模式：支援畫質優先、時延優先，時延優先模式下轉碼流的延時較低。
   直播加密	開啟後可選擇配置阿里雲視頻加密或DRM加密。 說明 DRM加密僅支援上海、新加坡直播中心。 阿里雲視頻加密 阿里雲視頻加密僅支援輸出HLS和FLV格式。 KMS主要金鑰：KMS密鑰的地區需要和網域名稱的直播中心保持一致。如果沒有密鑰，請先前往KMS服務建立一個密鑰， 具體操作請參見購買和啟用KMS執行個體。 換Key周期：取值範圍為60~3600內的整數。 更多阿里雲視頻加密功能使用可參見阿里雲視頻加密。 DRM加密 開啟前，需要先配置DRM密鑰。具體操作請參見配置DRM加密。 支援播放協議為HLS下Widevine和Fairplay的DRM加密，其中Fairplay需要在DRM認證管理中上傳從Apple擷取的認證。具體操作請參見申請Fairplay認證。

4. 完成配置後，單擊確定。

//需要<>內容替換成實際使用的值
DefaultProfile profile = DefaultProfile.getProfile("<regionId>", "<ALIBABA_CLOUD_ACCESS_KEY_ID>", "<ALIBABA_CLOUD_ACCESS_KEY_SECRET>");
IAcsClient client = new DefaultAcsClient(profile);
AddLiveStreamTranscodeRequest addLiveStreamTranscodeRequest = new AddLiveStreamTranscodeRequest();
addLiveStreamTranscodeRequest.setDomain("<DomainName>");
addLiveStreamTranscodeRequest.setApp("<AppName>");
addLiveStreamTranscodeRequest.setTemplate("<ld>");
addLiveStreamTranscodeRequest.setLazy("<true>");

try {
    AddLiveStreamTranscodeResponse addLiveStreamTranscodeResponse = client.getAcsResponse(addLiveStreamTranscodeRequest);
    System.out.println(new Gson().toJson(addLiveStreamTranscodeResponse));
    // todo something.
} catch (ServerException e) {
    // TODO Auto-generated catch block
    e.printStackTrace();
} catch (ClientException e) {
    // TODO Auto-generated catch block
    e.printStackTrace();
}           

1. 登入ApsaraVideo for Live控制台。

2. 單擊功能管理>直播轉碼，進入直播轉碼頁面。

3. 選擇您所需要配置的網域名稱，單擊自訂轉碼頁簽，單擊添加，配置轉碼模板。

   

   轉碼模板參數及說明如下表所示。

   參數	說明
   AppName	AppName必須與推流地址中的AppName名稱一樣，轉碼模板才會生效。
   模板ID	轉碼模板ID。 模板ID是拼接轉碼地址的參數，拼接方式參見產生推流地址和播放地址。輸出的直播地址後攜帶模板ID參數即可訪問指定解析度的轉碼流。 重要 請勿設定與通用轉碼模板ID相同的模板ID。通用轉碼模板ID包括：lld、lsd、lhd、lud、ld、sd、hd、ud。
   轉碼模板類型	轉碼模板類型：窄帶高清™模板和純音頻轉碼模板。 標準模板和窄帶高清™模板品質和效能不同，價格也不同。原畫模板不對視頻進行處理。純音頻轉碼模板刪除視頻只輸出音頻流。 純音頻轉碼模板刪除視頻只輸出音頻流。
   推薦模板參數	流暢、標清、超清、高清四種推薦參數，選中不同的檔位對應的幀率、碼率、解析度會根據系統預設的值進行填入，可在此基礎上進行調整。
   解析度	視頻輸出的解析度，單位：像素。可選擇固定解析度或解析度隨源. 解析度隨源：若源流解析度寬高尺寸小於自適應尺寸寬高，按源流輸出。若源流解析度寬高尺寸大於自適應尺寸寬高，按自適應尺寸輸出。可選擇不同的自適應方式： 短邊自適應 長邊自適應 橫豎屏自適應 固定解析度：按指定解析度輸出，不同的解析度檔位對應不同的價格，解析度檔位如下所示： LD：（640×480）及以下。 SD：（1280×720）及以下。 HD：（1920×1080）及以下。 2K：（2560×1440）及以下。 4K：（3840×2160）及以下。 說明 轉碼計費根據解析度檔位（LD、SD、HD、2K、4K）決定。解析度檔位與通用模板中標準模板的模板ID（包括lld、lsd、lhd、lud）和窄帶高清™模板的模板ID（包括ld、sd、hd、ud）無關，模板ID僅作為業務調用時的標識使用，請勿混淆。 控制台不支援解析度超過1080P的自訂設定，如果您的情境需要2K、4K規格解析度，可以提交工單申請。 關於如何提交工單，請參見聯絡我們。 解析度檔位判定規則：輸出規格按輸出視頻解析度的長邊和短邊是否屬於輸出規格劃定的範圍進行判定。 以輸出SD（1280×720）規格為例： 如果輸出視頻的解析度長邊小於等於1280且短邊小於等於720，則該視頻屬於該輸出規格。 如果輸出視頻的長邊大於1280或輸出視頻的短邊大於720，則該輸出視頻屬於更高的輸出規格。
   視訊框架率	幀率隨源：若幀率在限制範圍內，按源幀率輸出，超過上限按上限輸出，低於下限按下限輸出 固定幀率：輸出指定的視訊框架率，單位：FPS。數值低於或等於輸入幀率。
   視頻碼率	碼率隨源：若碼率在限制範圍內，按源碼率輸出，超過上限按上限輸出，低於下限按下限輸出，同時支援按倍率輸出。 固定碼率：使用指定的碼率，單位：kbps。解析度檔位指定的碼率如下所示： LD：100~800。 SD：200~1500。 HD：500~4000。 2K：2000~8000。 4K：4000~30000。
   視頻GOP	輸出視頻GOP即Group of picture（映像組），指兩個I幀之間的間隔，數值低於或等於輸入值。為了保障低延時效果不能大於3秒。
   音頻碼率（純音頻轉碼）	轉碼模板類型選擇純音頻轉碼模板時顯示。單位：kbps。取值範圍：8~1000。
   編碼檔次（純音頻轉碼）	轉碼模板類型選擇純音頻轉碼模板時顯示。 LC-AAC：低複雜性進階音頻編碼。轉碼效率較高。 HE-AAC：高效性進階音頻編碼。在低音頻碼率（通常128 kbps以下）時音效要高於LC-AAC。
   採樣率（純音頻轉碼）	轉碼模板類型選擇純音頻轉碼模板時顯示音頻採樣率。取值：22050、32000、44100、48000、96000。
   聲道數（純音頻轉碼）	轉碼模板類型選擇純音頻轉碼模板時顯示，聲音軌道的個數，取值：1或2。
   轉碼模式（進階配置）	支援畫質優先和時延優先，時延優先模式下轉碼流的延時較低。
   觸發轉碼（進階配置）	開啟時：首次拉流時才啟動轉碼。 關閉時：只要有推流就啟動轉碼，與是否有拉流無關。
   視頻加密（進階配置）	開啟後可選擇配置阿里雲視頻加密或DRM加密。 說明 DRM加密僅支援上海、新加坡直播中心。 阿里雲視頻加密 阿里雲視頻加密僅支援輸出HLS和FLV格式。 KMS主要金鑰：KMS密鑰的地區需要和網域名稱的直播中心保持一致。如果沒有密鑰，請先前往KMS服務建立一個密鑰， 具體操作請參見購買和啟用KMS執行個體。 換Key周期：取值範圍為60~3600內的整數。 更多阿里雲視頻加密功能使用可參見阿里雲視頻加密。 DRM加密 開啟前，需要先配置DRM密鑰。具體操作請參見配置DRM加密。 支援播放協議為HLS下Widevine和Fairplay的DRM加密，其中Fairplay需要在DRM認證管理中上傳從Apple擷取的認證。具體操作請參見申請Fairplay認證。
   透傳所有類型SEI（進階配置）	開啟後，可透傳所有類型SEI，不開啟則不透傳SEI。
   主要畫面格隨源（進階配置）	開啟後，轉碼輸出資料流主要畫面格與原始流主要畫面格一致。
   pts隨源（進階配置）	開啟後，轉碼輸出資料流pts與原始流pts一致。

4. 單擊確定添加。

由於自訂轉碼參數設定較為複雜，我們建議您使用API時結合控制台進行自訂轉碼配置。

首先，您通過控制台添加一個自訂轉碼配置。

完成各項參數調整後，通過調用DescribeLiveStreamTranscodeInfoAPI查詢轉碼配置資訊。

Java SDK查詢轉碼配置資訊範例程式碼如下：

        //需要<>內容替換成實際使用的值
        DefaultProfile profile = DefaultProfile.getProfile("<regionId>", "<ALIBABA_CLOUD_ACCESS_KEY_ID>", "<ALIBABA_CLOUD_ACCESS_KEY_SECRET>");
        IAcsClient client = new DefaultAcsClient(profile);
        DescribeLiveStreamTranscodeInfoRequest describeLiveStreamTranscodeInfoRequest=new DescribeLiveStreamTranscodeInfoRequest();
        describeLiveStreamTranscodeInfoRequest.setAppName("<AppName>");
        describeLiveStreamTranscodeInfoRequest.setDomainTranscodeName("<DomainName>");
        DescribeLiveStreamTranscodeInfoResponse describeLiveStreamTranscodeInfoResponse = null;
        try {
            describeLiveStreamTranscodeInfoResponse = client.getAcsResponse(describeLiveStreamTranscodeInfoRequest);
        } catch (ClientException e) {
            e.printStackTrace();
        }
        System.out.println(new Gson().toJson(describeLiveStreamTranscodeInfoResponse));

然後調用AddCustomLiveStreamTranscodeAPI根據網域名稱和AppName添加自訂轉碼配置資訊。

        AddCustomLiveStreamTranscodeRequest addCustomLiveStreamTranscodeRequest=new AddCustomLiveStreamTranscodeRequest();
        addCustomLiveStreamTranscodeRequest.setDomain("<DomainName>");
        addCustomLiveStreamTranscodeRequest.setApp("<AppName>");
        /**
         * 轉碼參數設定
         */
        AddCustomLiveStreamTranscodeResponse addCustomLiveStreamTranscodeResponse = null;
        try {
            addCustomLiveStreamTranscodeResponse = client.getAcsResponse(addCustomLiveStreamTranscodeRequest);
        } catch (ClientException e) {
            e.printStackTrace();
        }
        System.out.println(new Gson().toJson(addCustomLiveStreamTranscodeResponse));

1. 登入ApsaraVideo for Live控制台。

2. 單擊功能管理>直播轉碼，進入直播轉碼頁面。

3. 選擇您所需要配置的網域名稱，單擊多碼率轉碼頁簽，單擊添加，添加多碼率轉碼模板組。

   1. 單擊基本資料，編輯多碼率轉碼模板組基本資料。

      

      參數及說明如下表：

      參數	說明
      AppName	AppName必須與推流地址中的AppName名稱對應，轉碼模板才會生效。
      模板組ID	轉碼模板組ID。模板組ID是拼接多碼率轉碼地址的參數，支援數字、大小寫字母、虛線，添加不超過10個字元。
      封裝格式	目前僅支援HLS。
      觸發轉碼	目前僅支援推流時觸發轉碼。會產生轉碼費用，暫不支援播流時觸發轉碼。
      時間戳記對齊	開啟後每個模板的GOP項不可設定，採用源視頻的GOP。

   2. 單擊+添加模板，會添加一條模板資訊。

      單擊添加的模板，可以編輯模板參數。不同模板類型需填寫的參數可能不同，參數及說明如下表：

      參數	說明
      模板ID	轉碼模板ID。 模板ID是拼接轉碼地址的參數，拼接方式參見產生推流地址和播放地址。輸出的直播地址後攜帶模板ID參數即可訪問指定解析度的轉碼流。 重要 請勿設定與通用轉碼模板ID相同的模板ID。通用轉碼模板ID包括：lld、lsd、lhd、lud、ld、sd、hd、ud。
      轉碼模板類型	轉碼模板類型：窄帶高清™模板和純音頻轉碼模板。
      解析度	視頻輸出的解析度，單位：像素。不同的解析度檔位對應不同的價格，解析度檔位如下所示： LD：（640×480）及以下。 SD：（1280×720）及以下。 HD：（1920×1080）及以下。 2K：（2560×1440）及以下。 4K：（3840×2160）及以下。 說明 轉碼計費根據解析度檔位（LD、SD、HD、2K、4K）決定，與通用模板中窄帶高清™模板的模板ID（包括ld、sd、hd、ud）無關，請勿混淆。 解析度檔位判定規則：輸出規格按輸出視頻解析度的長邊和短邊是否屬於輸出規格劃定的範圍進行判定。 以輸出SD（1280×720）規格為例： 如果輸出視頻的解析度長邊小於等於1280且短邊小於等於720，則該視頻屬於該輸出規格。 如果輸出視頻的長邊大於1280或輸出視頻的短邊大於720，則該輸出視頻屬於更高的輸出規格。
      視頻碼率	解析度使用指定的碼率，單位：kbps。解析度檔位指定的碼率如下所示： LD：100~800。 SD：200~1500。 HD：500~4000。 2K：2000~8000。 4K：4000~30000。
      視訊框架率	輸出視訊框架率，單位：FPS。數值低於或等於輸入幀率。
      視頻GOP	輸出視頻GOP即Group of picture（映像組），指兩個I幀之間的間隔，數值低於或等於輸入值。為了保障低延時效果不能大於3秒。
      編碼格式（純音頻轉碼）	目前僅支援AAC編碼格式。
      編碼檔次（純音頻轉碼）	LC-AAC：低複雜性進階音頻編碼。轉碼效率較高。 HE-AAC：高效性進階音頻編碼。在低音頻碼率（通常128 kbps以下）時音效要高於LC-AAC。
      碼率（純音頻轉碼）	音頻碼率，取值範圍：8~1000。
      聲道數（純音頻轉碼）	聲音軌道的個數，取值：1或2。
      頻寬上限閾值	可支援100Kbps~100Mbps範圍內的整數或小數，保留兩位小數，建議設定為視頻碼率的1.2~1.5倍。

4. 配置完成後，單擊確定。