全部產品
Search
文件中心

ApsaraVideo Live:拉流轉推

更新時間:Aug 06, 2026

ApsaraVideo for Live拉流轉推功能可以協助您將已有的直播源或點播源進行轉推(偽直播情境),本文將詳細為您介紹如何使用拉流轉推功能。

功能說明

當您需要將第三方直播源轉推出去,或者希望將錄製好的視頻轉換成直播形式推流時,可以利用拉流轉推功能,藉助這一功能,您可以從不同的直播源或點播源中抓取內容,並將其即時轉播給觀眾。整個過程中無需執行傳統的直播推流步驟。這樣便能高效地實現內容的傳輸與分發。

  • 拉流轉推功能支援內容拉取和轉推,您可以通過控制台或API介面實現建立任務、查看任務和管理工作。

拉流轉推任務處理流程:

典型情境

車載監控接入

車載裝置若輸出 JT/T 1078 或蘇標等私人協議視頻流,需先通過協議轉換網關將其轉換為 RTMP 標準格式,再接入拉流轉推功能。建立拉流轉推任務時,源流類型選擇直播,源流協議選擇 RTMP,填寫轉換後的 RTMP 源流地址和目標推流地址。任務建立完成後,移動端可通過阿里雲播放器 SDK 拉流播放。

注意事項

  • 拉流轉推屬於收費功能,於 2025年12月05日 00:00 起正式計費。費用詳情請參見拉流轉推費用

  • 一條拉流轉推任務,只支援進行一路流的轉推操作,多路流需要建立多個任務。

  • 拉流轉推功能只提供轉推服務,您需要確保轉推內容符合相關法律法規,若存在法律風險,ApsaraVideo for Live會停止相關內容的轉推服務,並保留追究法律責任的權利。

  • 在使用拉流轉推功能進行海外流的拉取或向海外推送時,務必調整任務的地區設定為海外,以確保操作順利進行。

  • 拉流轉推提供回調功能,具體可參考拉流轉推事件回調

  • 每個帳號最多支援 100 路任務並發,具體資訊請參見使用限制

前提條件

  • 開通ApsaraVideo for Live功能,並登入到ApsaraVideo for Live控制台開通與購買ApsaraVideo for Live

  • 已擷取直播源或點播源的相關資訊。

    情境

    資訊

    直播

    • 直播播放地址。

    • 直播的源流協議包括:RTMP、SRT、HTTP-FLV。

    點播

    視頻

    • 視頻源的地址路徑。

      說明

      視頻路徑地址固定首碼 http:// 或 https:// ,以 .mp4 或 .flv 結尾

    說明
    • 點播源的媒資ID或視頻源的地址路徑最多可添加30個。

    • 點播源視頻編碼格式僅支援H.264與H.265格式。

    • 點播源音頻編碼格式僅支援AAC格式,音頻採樣率需要控制在16 kHz - 44.1 kHz。

    • 點播源的VOD檔案格式建議使用MP4或FLV格式。

  • 根據添加的推流網域名稱產生推流地址,具體方式可參見產生直播地址

操作步驟

建立拉流轉推任務

  1. 登入ApsaraVideo for Live控制台
  2. 在左側導覽列選擇功能管理 > 拉流轉推,進入拉流轉推頁面。

  3. 選擇直播中心地區。

  4. 單擊創建任務

  5. 配置拉流轉推任務參數。

    拉流轉推任務參數及說明如下表所示。

    參數

    描述

    地域

    拉流轉推任務所屬地區,使用者可根據需要拉取的來源資料所屬地區或推流所屬地區配置。

    說明

    當前拉流轉推支援華東2(上海)、華北2(北京)、華南1(深圳)、亞太地區東南1(新加坡)和印尼(雅加達)五個地區。

    任務名稱

    使用者自訂當前任務名稱。

    任務時間

    任務的開始時間與結束時間,由使用者選擇。

    說明

    目前時間到達使用者佈建的開始時間時,任務將自動啟動,若任務因其他原因出現異常停止或啟動失敗。則使用者可通過控制台手動執行啟用重啟操作。

    事件回調資訊

    拉流轉推任務事件的回調地址,需要使用者提供並填寫。

    源流類型

    當前拉流轉推任務的源視頻流類型,具體參數填寫可參考此清單項目

    • 直播。

    • 點播。

    • 視頻地址路徑。

    播放次數

    由使用者選擇播放清單中視頻的迴圈播放次數,可選擇無限迴圈或指定迴圈次數。

    • 無限迴圈。

    • 指定播放。

    說明

    僅當源流類型為點播視頻地址路徑時配置此參數。

    目標推流地址

    當前拉流轉推任務轉推的目標地址,僅支援RTMP協議。

    說明

    以阿里雲ApsaraVideo for Live推流地址為例:

    rtmp://tuiliuyuming.cn/***/***?auth_key=****922353-0-0-*****f68cba72490a3328a1167c9****

    源流型別參數說明如下:

    1. 當源流類型為直播時,源流協議支援RTMP、SRT和HTTP-FLV三種。

    2. 當源流類型為點播時,需要輸入所需視頻的點播媒資ID,相關ID擷取可參考擷取/更新媒資資訊。在視頻列表中輸入焦點播媒資 ID,最多可添加 30 個視頻,系統將按順序輪播。在播放次數中選擇無限迴圈指定播放

    3. 當源流類型為視頻地址路徑時,輸入所需視頻地址路徑。

      說明

      視頻路徑地址固定首碼 http:// 或 https:// ,以 .mp4 或 .flv 結尾。

  6. 單擊提交,完成建立。

說明

要建立拉流轉推任務除控制台操作外,您還可通過API介面實現,具體可參考建立拉流轉推任務

查詢任務

  1. 登入ApsaraVideo for Live控制台
  2. 在左側導覽列選擇功能管理 > 拉流轉推,進入拉流轉推頁面。

  3. 選擇建立拉流轉推任務時所選的地區,然後您可根據任务ID任務名稱目標流地址進行精確查詢。

說明

要查詢拉流轉推任務除控制台操作外,您還可通過API介面實現,具體可參考查詢拉流轉推任務

修改任務

  1. 登入ApsaraVideo for Live控制台
  2. 在左側導覽列選擇功能管理 > 拉流轉推,進入拉流轉推頁面。

  3. 拉流轉推頁面找到需要修改的任務,點擊操作編輯按鈕。

  4. 在編輯頁面上根據您的需求進行相關參數修改,修改完成後點擊提交

    1. 當任務處於未開始狀態時,您可編輯任務時間事件回調資訊源流類型中的部分參數

    2. 當任務處於停止運行狀態時,您可編輯事件回調資訊源流類型中的部分參數

    3. 當任務處於其他狀態時,您不能對任務進行編輯操作。

說明

要修改拉流轉推任務除控制台操作外,您還可通過API介面實現,具體可參考更新拉流轉推任務

刪除任務

重要

注意拉流轉推任務刪除後無法再次找回。

  1. 登入ApsaraVideo for Live控制台
  2. 在左側導覽列選擇功能管理 > 拉流轉推,進入拉流轉推頁面。

  3. 拉流轉推頁面找到需要刪除的任務,點擊操作刪除按鈕。

  4. 在彈框中選擇刪除,即可刪除當前任務。

說明

要刪除拉流轉推任務除控制台操作外,您還可通過API介面實現,具體可參考刪除拉流轉推任務

啟動任務

說明
  • 當任務處於停止運行狀態時,可對任務進行啟用操作。

  • 當到達開始時間時,任務會自動啟動。

  1. 登入ApsaraVideo for Live控制台
  2. 在左側導覽列選擇功能管理 > 拉流轉推,進入拉流轉推頁面。

  3. 拉流轉推頁面找到需要啟動的任務,點擊操作啟用按鈕。

  4. 在彈框中選擇啟用,即可啟動當前任務。

重啟任務

說明

當任務處於運行中狀態時,可對任務進行重啟操作。

  1. 登入ApsaraVideo for Live控制台
  2. 在左側導覽列選擇功能管理 > 拉流轉推,進入拉流轉推頁面。

  3. 拉流轉推頁面找到需要重啟的任務,點擊操作重啟按鈕。

  4. 在彈框中選擇重啟,即可重啟當前任務。

說明

要重啟拉流轉推任務除控制台操作外,您還可通過API介面實現,具體可參考重啟拉流轉推任務

停用任務

說明

當任務處於運行中狀態時,可對任務進行停止操作。

  1. 登入ApsaraVideo for Live控制台
  2. 在左側導覽列選擇功能管理> 拉流轉推,進入拉流轉推頁面。

  3. 拉流轉推頁面找到需要重啟的任務,點擊操作停止按鈕。

  4. 在彈框中選擇停止,即可停止當前任務。

說明

要停用拉流轉推任務除控制台操作外,您還可通過API介面實現,具體可參考停止拉流轉推任務

常見問題

建立拉流轉推任務後,如何產生直播播放地址?

拉流轉推的直播播放地址須基於“目標推流地址”對應的關聯播流網域名稱、AppName 和 StreamName 產生。您可以使用控制台的地址產生器或通過自訂拼接產生,詳情請參見產生直播地址

第三方源流斷開後,拉流轉推任務會自動回復嗎?

當第三方源流斷開後,任務進入 Recovering(異常運行)狀態,系統預設每 1 分鐘嘗試重新拉流一次,最多重試 3 次。

  • 若 3 分鐘內源流恢複且拉流成功,任務狀態自動回復為 Running(正常運行)。

  • 若 3 次重試均未成功,任務狀態變為 Offline(已停止),系統不再自動嘗試拉流。此時必須通過控制台單擊重啟按鈕或調用 RestartLivePullToPush 介面手動重啟任務。