全部產品
Search
文件中心

ApsaraVideo VOD:擷取播放地址

更新時間:Dec 09, 2025

ApsaraVideo for VOD支援通過事件通知和API/SDK兩種方式擷取播放地址。

通過事件通知提前擷取

您可通過接收單個清晰度轉碼完成全部清晰度轉碼完成的事件通知擷取到播放地址,儲存到使用者自己的服務端,播放時訪問自己的服務端擷取到儲存的播放地址。

說明

如果有高並發播放視頻的情境,則建議使用該方式進行視頻播放,通過將擷取到的視頻URL(播放地址)儲存到您自己的業務系統,再下發給播放終端,並提前重新整理預熱新視頻,可滿足百萬層級的並發播放視頻業務需求。更多資訊,請參見重新整理預熱

使用說明

  • 訊息回調擷取到的播放地址為固定地址,若開啟了URL鑒權則需要自己產生帶鑒權的播放地址,否則無法播放。

  • 如果您禁用或刪除了舊的網域名稱,儲存的播放地址取出時請替換成新的網域名稱,否則無法播放。

  • 如果您配置了視頻加密,返回的播放地址需要經過播放器解密後才可進行播放。

通過API/SDK即時擷取

您需要在上傳音視頻檔案時儲存好VideoId,通過SDK調用擷取音視頻播放地址介面即時擷取播放地址。

使用說明

  • 為了保證每次播放的是最新轉碼輸出的流,播放介面預設每種清晰度和格式只返回一路最新轉碼完成的流。調用擷取音視頻播放地址介面時,可以設定ResultTypeMultiple來擷取該音視頻下的所有轉碼完成的流。

  • 如果您選擇了阿里雲視頻加密(私人加密)的方式,只有使用阿里雲播放器SDK才可正常播放。為了保障您的視頻安全,直接調用擷取播放地址介面預設不返回私人加密流,您可以通過設定介面參數ResultType值為Multiple來擷取所有轉碼完成的播放地址。

  • 如果您選擇了HLS標準加密的方式,預設會優先返回標準加密的流用於播放。

  • 如果您對音視頻進行了分級儲存,調用擷取音視頻播放地址介面擷取音視頻的播放地址時:

    • 預設情況下,若儲存類型為標準儲存,則播放介面會正常返回播放流;若儲存類型為媒資範圍的非標準儲存,則播放介面不返回播放流;若儲存類型為源檔案範圍的非標準儲存,則播放介面只返迴轉碼流,不返回原畫流。

    • 您可以通過設定介面參數PlayConfigStorageClass來返回指定的非標準儲存類型的音視頻流。

整體流程

我們以配置了CDN加速網域名稱為例,講解擷取視頻地址並播放視頻的整體流程。

  1. 用戶端向服務端發起請求,擷取播放地址。

  2. 服務端可通過服務端SDK調用擷取音視頻播放地址,擷取播放授權。

  3. 點播服務給服務端返回播放地址。

  4. 服務端向用戶端返回播放地址。

  5. 用戶端播放器根據返回的播放地址,請求播放資源。

  6. CDN節點不存在資源或者資源失效時需要回源OSS Bucket。

  7. OSS Bucket 返回資源給CDN節點,CDN節點緩衝資源。

  8. CDN節點返回媒體資源。

後續步驟

  • 您可以在用戶端整合阿里雲播放器通過URL播放視頻,參考播放器SDK簡介