全部產品
Search
文件中心

ApsaraVideo VOD:下載媒體檔案

更新時間:Dec 18, 2024

ApsaraVideo for VOD支援將儲存在ApsaraVideo for VOD裡的媒體檔案下載到本地磁碟或其它儲存上,提供了控制台、用戶端和介面用於查詢各種媒體檔案的下載地址。本文為您介紹媒體檔案、下載地址類型、下載限制和擷取方法。

媒體檔案

使用ApsaraVideo for VOD服務時可能會產生多種可下載的媒體檔案,包括源檔案、轉碼輸出的流檔案、視頻截圖檔案、上傳的圖片檔案等,ApsaraVideo for VOD提供了各種媒體檔案的查詢和下載。媒體檔案的分類如下:

  • 音視頻

    • 源檔案:上傳至點播的音視頻源檔案。

    • 轉碼輸出檔案:下載轉碼輸出的流檔案(某個清晰度)。

  • 圖片

    • 上傳至點播的圖片檔案。

    • 經ApsaraVideo for VOD自動截圖處理後產生的圖片檔案(封面截圖和雪碧圖)。

    • 提交媒體截圖作業後產生的圖片檔案(普通截圖、雪碧圖和組成雪碧圖的原始小圖)。詳情請參見提交媒體截圖作業。

下載地址類型

擷取的媒體檔案下載地址,一般為儲存地址或加速地址,前者會產生媒資管理(儲存)費用,即OSS外網流出流量的費用。後者會產生CDN流量費用,即視頻加速(加速)的費用。

  • 儲存地址

    • 未配置加速網域名稱時,各媒體檔案的下載地址統一為儲存地址。更多資訊,請參見儲存管理

    • 配置加速網域名稱時,各媒體檔案的下載地址統一為加速地址。其中,源檔案和轉碼輸出檔案下載地址支援強制返回來源站點地址。更多資訊,請參見擷取源檔案資訊擷取視頻播放地址。調用以上介面時,需要設定OutputType值為oss。當您的視頻儲存地址為輸入bucket時(bucket名稱以in-開頭),配置加速網域名稱的情況下,源檔案下載地址仍然為儲存地址。

  • 加速地址

    當您在點播配置了加速網域名稱後,各媒體檔案的下載地址為加速地址。具體操作,請參見網域名稱管理

下載限制

如果使用了防盜鏈配置、視頻加密等功能,即便擷取到媒體檔案的下載地址,在下載媒體後仍可能受到同樣的使用限制。

  • 配置了訪問限制時,通過加速地址下載,會受到配置的Refer防盜鏈、IP黑名單等策略的限制,與線上播放相同;通過儲存地址下載,則不受此限制;

  • 使用視頻加密,不管通過哪種方式下載,得到的轉碼輸出的檔案仍然為加密檔案,需要解密後進行播放。更多資訊,請參見概述-視頻加密

  • OSS儲存如設定私人,則地址存在時效性,下載時要注意可能會到期,此時需要重新擷取,建議設定較長有效期間;

  • CDN加速網域名稱如開啟了URL鑒權,則地址會在一段時間後到期,此時需要重新擷取,建議設定較長有效期間。

通過控制台擷取下載地址

  • 查看

    登入ApsaraVideo for VOD控制台,在點播控制台左側的導覽列選擇媒資庫,單擊音/視頻圖片,進入音/視頻或圖片頁面,在音視頻或圖片頁面單擊要查看的檔案右側的管理。在詳情頁中單擊複製,即可擷取下載地址。

  • 匯出

    • 音視頻轉碼輸出檔案:

      登入ApsaraVideo for VOD控制台,在點播控制台左側的導覽列選擇媒資庫,單擊音/視頻,進入音視頻頁面,通過單擊右上方匯出媒體地址表徵圖匯出媒體地址,擷取當前篩選條件下的前200條音視頻對應的轉碼輸出檔案下載地址(各個清晰度)。

    • 上傳至點播的圖片檔案:

      登入ApsaraVideo for VOD控制台,在點播控制台左側的導覽列選擇媒資庫,單擊圖片,進入圖片頁面,通過單擊右上方匯出媒體地址表徵圖匯出媒體地址,擷取當前篩選條件下的前100條圖片對應的檔案下載地址。

通過API/SDK擷取下載地址

媒體檔案下載包括下載音視頻源檔案、下載音視頻流、下載自動截圖檔案、下載圖片檔案。您可以通過以下介面擷取到相應的檔案地址進行下載。

擷取資訊

描述

參考文檔

源檔案地址

返回結果Mezzanine對象中的FileURL欄位為源檔案地址。

擷取源檔案資訊

播放資訊

返回結果PlayInfo對象中的PlayURL欄位為轉碼輸出資料流地址。

擷取視頻播放地址

視頻資訊

返回結果Video對象中的CoverURL欄位為封面地址,Snapshots欄位為自動截圖處理後截圖地址數組。

擷取視頻資訊

圖片資訊

返回結果ImageInfo對象中的URL欄位為圖片地址。

擷取圖片資訊

媒資資訊

媒資類型為音視頻時,返回結果VideoAudio對象中的CoverURL欄位為封面地址,Snapshots欄位為視頻截圖地址數組,SpriteSnapshots欄位為自動截圖處理後的雪碧圖地址數組;媒資類型為圖片時,返回結果Image對象中的URL欄位為圖片地址。

搜尋媒體資訊

截圖資料

返回結果MediaSnapshot對象中的Snapshots欄位為與SnapshotType(截圖類型)對應的截圖地址數組。

查詢截圖資料

調用方式:

  • 推薦使用服務端SDK調用API來擷取媒資資訊,更為簡單、高效。更多資訊,請參見使用說明,API詳情可參考各API文檔的SDK樣本

  • 您也可以參見請求結構,來產生HTTP/HTTPS請求。

用戶端下載

針對移動端的使用情境,阿里雲播放器SDK提供了離線下載功能,您可以根據業務需要,通過啟用下載功能,允許終端使用者將音視頻流檔案快取至本地進行觀看。離線下載提供兩種下載方式——普通下載和安全下載。

下載設定

您可以登入ApsaraVideo for VOD控制台,在點播控制台左側的導覽列選擇組態管理,單擊分發加速配置 > 下載設定,進入下載設定頁面,在下載設定頁面中設定離線下載的方式。具體操作,請參見下載設定2021-12-28_17-15-08

  • 普通下載的音視頻檔案不會被加密,可拷貝,也可使用任意播放器播放,請謹慎使用。

  • 安全下載的音視頻檔案會使用產生的密鑰檔案進行加解密,保障視頻安全。需要使用阿里雲播放器SDK完成解密播放,點播控制台提供了加密私密金鑰的產生工具。2021-12-28_17-16-44

播放器SDK

iOS和Android播放器SDK同時支援用戶端下載和緩衝功能,具體操作,請參見iOS播放器功能使用和Android播放器功能使用