全部產品
Search
文件中心

ApsaraVideo VOD:轉碼常見問題

更新時間:Apr 04, 2026

本文為您介紹ApsaraVideo for VOD轉碼相關的常見問題。

轉碼失敗時,如何自主排查?

  • 確認轉碼源檔案能否在本地正常播放(非常重要),經統計大部分轉碼失敗是因為源檔案本身有問題(如:視頻流缺失、metadata存在問題、幀錯誤、視頻頭部資訊缺失等),會觸發轉碼效率監控,導致轉碼退出。

    • 使用ffprobe -show_streams -show_format -of json -i [filePath]命令檢查檔案meta資訊,是否有moov缺失、流異常等問題。

    • 使用ffprobe -show_packets -i [filePath]命令查看資料碼流是否有問題,碼流時間長度與metadata時間長度是否一致。

      說明

      metadata中的時間長度與實際持續的碼流時間長度不一致可能導致轉碼失敗,對於metadata有問題的檔案,建議您先本地使用ffmpeg工具處理,再進行上傳轉碼。

  • 錯誤碼中找到對應的錯誤碼,分析具體失敗原因。

  • 如果您添加的文本浮水印中包含特殊字元,可能會導致浮水印輸出截斷或失敗,需要在輸入前對特殊字元進行轉義。

  • 加密轉碼失敗,使用HLS標準加密轉碼時,常見錯誤原因請參見視頻加密常見問題

使用系統內建的不轉碼模板組轉碼後的視頻,為什麼無法播放?

請排查是否由下述原因造成:

  • 原因一:上傳的源視頻本身存在問題,不能正常播放。

  • 原因二:目前僅MP4、FLV、M3U8、MP3、WEBM格式的視頻支援不轉碼直接播放。

    • 上傳視頻到ApsaraVideo for VOD中時,如果使用ApsaraVideo for VOD系統內建的不轉碼模板組轉碼上傳,若源視頻是MP4、FLV、M3U8、MP3、WEBM格式,則視頻上傳完成後會產生原畫視頻流;若源視頻為其他格式時,則視頻上傳完成後會產生原始檔案視頻流。

    • 原始檔案視頻流無法通過ApsaraVideo for VOD控制台進行播放預覽,也無法通過擷取音視頻播放地址介面擷取到播放地址,只能通過擷取源檔案資訊介面擷取源檔案地址用於播放;原畫視頻流可以在ApsaraVideo for VOD控制台進行播放預覽,也可以通過擷取音視頻播放地址介面擷取到播放地址用於播放。

源視頻有多個音頻流,轉碼完成後只剩下一個音頻流怎麼解決?

目前僅支援保留一路音頻流,即在Output參數中添加音頻流的配置為audioMap=0,如果您有特殊情境需求,請提交工單

轉碼之後,視頻的寬高為什麼和設定的不一樣?

ApsaraVideo for VOD的轉碼模板中,可以設定橫豎屏自適應(LongShortMode),該功能預設開啟,開啟後視頻的width對應長邊,height對應短邊,只需設定寬或高其中的一個,另一個留空(不設定)即可。如果想要輸出指定的解析度,則需要關閉橫豎屏自適應(輸出可能會展開變形)。

轉碼之後,為什麼視頻解析度發生置換(豎屏變橫屏或橫屏變豎屏)?

通常是由於視頻源包含了rotation=-90而導致轉碼後視頻解析度發生置換。您可以使用FFmpeg工具,檢查源檔案是否包含rotation角度旋轉資訊。查詢源檔案資訊的方法如下:

ffprobe -show_streams -show_format -of json -i  [filepath]

mp4轉碼後的m3u8檔案播放黑屏,應該如何排查?

請先檢查您的源檔案視頻流是否正常。如果源檔案第一個ts沒有視頻流資料,會導致播放器認為沒有畫面。如果出現這種情況,可以先將源檔案先進行一次mp4轉碼,再進行m3u8轉碼,即可正常播放。

源檔案為HDR,轉SDR後過曝或亮度過暗?

當您的片源為HDR,可以在轉碼模板的 HDR 片源動態範圍,選擇映射SDR。 樣本如下:

截屏2025-04-08 17

映射SDR現處於公測,公測結束後將開始計費詳情請參見音視頻增強費用。如果尚未解決請提交工單適配處理。

ApsaraVideo for VOD轉碼能判斷moov box位置嗎?沒有moov的檔案怎麼辦?

轉碼後預設會將moov box放置在mp4檔案頭部,不支援自訂配置。沒有moov的檔案暫時無法處理,會導致轉碼失敗。

視頻轉為音頻後,為什麼時間長度與源視頻不一致?

當前ApsaraVideo for VOD的轉碼邏輯為了保證時間長度的一致性,會根據輸入檔案中音頻流時間長度最短的來計時轉碼。如果源檔案中部分切片時間戳記不連續,會導致無法擷取視頻流的媒體資訊,影響對於轉碼時間長度的估計,產生時間長度偏差的問題。

轉碼純音頻檔案後,播放檔案出現報錯如何處理?

請檢查轉碼模板中是否配置了禁用視頻設定,純音頻檔案轉碼時需要避免視頻轉碼,禁用視頻並選擇合適解析度(如圖所示後兩個解析度)。image

轉碼時轉碼模板設定的音/視頻碼率未生效?

請檢查轉碼模板中是否配置了碼率檢查機制(即點播控制台普通轉碼模板中條件轉碼參數下的檢查視頻碼率檢查音頻碼率),當配置了碼率檢查機制時,如果轉碼前後的音/視頻編碼器一致且轉碼後的音/視頻碼率大於轉碼前的音/視頻碼率,則轉碼模板中設定的音/視頻碼率不會生效,音/視頻碼率將會按您配置的碼率檢查機制按原片轉碼或不轉碼被重設。

一個轉碼作業需要多長時間?

重要

以下參考值僅描述典型測試條件下轉碼任務進入實際處理階段後的處理速度特徵,不包含等待時間長度,不代表任務總完成時間長度,不構成服務承諾。

以 H.264 720P的典型轉碼情境為參考,不同轉碼演算法的處理速度特徵如下:

轉碼演算法

處理速度參考

說明

普通轉碼

平均約 3 倍速

僅反映典型條件下的處理階段速度。

窄帶高清 1.0

平均約 1.5 倍速

實際處理時間長度通常高於普通轉碼。

窄帶高清 2.0

通常遠低於 1 倍速

處理時間長度通常長於源視頻時間長度,具體以實際任務為準。

倍速說明

倍速 = 每單位處理時間可完成的視頻時間長度倍數

樣本:
3 倍速表示每 1 分鐘處理時間可完成約 3 分鐘視頻內容
則 30 分鐘視頻在不考慮等待時間長度的前提下,處理階段理論耗時約為 10 分鐘
說明
  • 上述參考值僅適用於典型 H.264 720P 轉碼情境。

  • 不適用於估算任務總完成時間。

  • 解析度更高、編碼更複雜、參數更重時,處理速度通常低於上述參考值。

  • 不同源視頻的碼率、幀率、封裝格式和流結構差異,均可能顯著影響處理時間長度。

  • 窄帶高清 2.0 的處理複雜度通常顯著高於普通轉碼和窄帶高清 1.0。

  • 實際耗時請以任務狀態查詢或完成通知結果為準。

能否即時查詢轉碼進度?

目前不提供即時查詢轉碼進度的介面,您可以設定回調,通過事件通知來判斷轉碼處理的結果,詳情請參見事件通知

能否進行批量轉碼操作?

目前ApsaraVideo for VOD服務暫不支援批量轉碼操作。系統主要通過配置轉碼模板或工作流程,在視頻上傳過程中自動完成轉碼處理。對於使用OSS自有Bucket的使用者,您可以通過以下方式實現批量轉碼:首先綁定Intelligent Media Management專案,然後利用首碼匹配等條件建立批量轉碼任務,從而實現高效的多視頻轉碼處理。詳情請參見OSS批處理

為什麼我的轉碼作業一直失敗?

作業失敗有多種原因,請留意返回錯誤資訊。如果您收到預先處理失敗的錯誤,說明我們無法解碼您的源檔案,請提交工單協助診斷並提供以下資訊來協助診斷:阿里雲賬戶ID、視頻ID。

是否支援即時轉碼?

ApsaraVideo for VOD目前是基於檔案的轉碼服務,暫不支援即時轉碼。

已經上傳到ApsaraVideo for VOD中的視頻,是否可以大量設定轉碼?

針對已經上傳到ApsaraVideo for VOD中的視頻,暫不支援大量設定轉碼。

已經轉碼設定了浮水印,為什麼不生效或看不到浮水印?

請檢查轉碼所使用的浮水印模板的尺寸(寬×高)、位移等參數的設定是否能確保浮水印正常顯示在視頻畫面範圍(解析度寬×高)內,若超出視頻畫面範圍,會導致即使浮水印轉碼成功,也看不到浮水印。

轉碼常見問題-浮水印.png

為什麼收不到轉碼失敗的回調?

配置轉碼事件通知時,如果您僅配置了單個清晰度轉碼完成(StreamTranscodeComplete),未配置全部清晰度轉碼完成(TranscodeComplete)的事件,當您上傳視頻時發起轉碼,如果您上傳的源視頻有損壞導致所有轉碼流都失敗的情境下,則點播會返回TranscodeComplete失敗的回調給您,而由於您並未配置該回調,因此導致您轉碼失敗,卻收不到轉碼失敗的回調。