全部產品
Search
文件中心

ApsaraVideo VOD:上傳地址和憑證

更新時間:Jul 13, 2024

擷取上傳地址和憑證的環節為點播服務的核心基礎。本文介紹上傳地址和憑證的工作原理、使用說明、使用限制、擷取方式以及解析方式。

技術原理

上傳地址是上傳媒體檔案到點播儲存的檔案地址,上傳憑證是完成上傳動作的授權憑證。上傳地址和上傳憑證均由點播服務下發,主要解決媒體上傳過程中的授權和安全問題,防止惡意上傳。同時,點播服務在下發上傳地址和憑證時還會自動建立媒資資訊,即媒體ID(MediaId),用於媒資生命週期管理或ApsaraVideo for Media Processing。

媒體ID

媒體ID在某些場合也叫視頻ID(VideoId)或圖片ID(ImageId),可用於以下情境:

  • 上傳後追蹤和管理媒體的生命週期。利用上傳地址和憑證完成上傳後,媒體的初始狀態一般為上傳中。相應的處理完成後會自動更新為下一個狀態,如上傳完成轉碼中正常等。

  • 上傳後指定媒體(用媒體ID識別)發起轉碼、截圖、視頻AI處理及視訊剪輯等操作。

使用限制

  • 上傳地址和憑證只能用於單個媒體(單個音頻、單個視頻或單個圖片),不能多個混用,否則會互相覆蓋。

  • 同一個視頻,重複請求會擷取到不同的上傳地址和憑證。

  • 上傳地址(目錄)由點播服務自動分配,暫不支援自由指定。

  • 上傳憑證有效期間統一為3000秒(50分鐘)。

  • 由於視頻檔案可能較大、上傳耗時較長,憑證失效後需要重新整理上傳憑證,重新整理後新的憑證有效期間仍是3000秒,且上傳地址不變。

  • 圖片、輔助媒資(浮水印、字幕檔案等)檔案較小,憑證失效後只能重新擷取。

使用說明

上傳視頻、圖片和輔助媒資需要調用不同的服務端介面擷取對應的上傳地址和憑證。在所有面向開發人員的上傳方式中,僅部分方式需要關心如何擷取上傳地址和上傳憑證。詳情如下表所示。

說明

除了通過上傳地址和憑證方式,部分情境還支援通過STS臨時Token訪問點播服務。兩種方式的對比請參見憑證方式與STS方式對比。在上傳情境下,兩種方式在操作上的區別如下:

  • 使用上傳憑證在構造上傳請求時可直接傳入阿里雲帳號AK或者RAM使用者AK。

  • 使用STS臨時Token在構造上傳請求時需要傳入提前擷取的STS臨時Token。更多資訊請參見STS臨時Token

上傳方式

是否需要自行擷取上傳地址和憑證

是否需要自行解析上傳地址和憑證



上傳SDK(服務端)

重要

上傳SDK在服務端當前僅支援四種語言:

  • Java、Python、C/C++、PHP。



上傳SDK(用戶端)

說明

只需要下發給用戶端即可。

URL拉取上傳

基於OSS原生SDK上傳

說明

基於OSS原生SDK上傳的實質是整合點播服務端SDK擷取上傳地址和憑證,使用擷取到的上傳地址和憑證初始化OSS SDK完成上傳邏輯。

OSS檔案上傳

擷取上傳地址和憑證

ApsaraVideo for VOD提供兩種方式供開發人員自行擷取上傳地址和憑證。

說明

具體的程式碼範例請點擊使用說明中對應上傳方式跳轉至操作步驟中查看。

  • 推薦)通過ApsaraVideo for VODVOD SDK調用API來擷取上傳地址和憑證。更多內容,請參見服務端SDK

開發語言

SDK調用樣本

Java

Java媒體上傳

Python

Python媒體上傳

常用介面

解析上傳地址和憑證

只有基於OSS原生SDK或API實現上傳的方式需要關注如何解析上傳地址和憑證。其它上傳方式不需要解析上傳地址和憑證,也不需要關注其內部邏輯。

將點播服務端返回的上傳地址(UploadAddress)和上傳憑證(UploadAuth)分別進行Base64解碼,可得到OSS的上傳地址和授權資訊。解析的具體樣本請參見基於OSS原生SDK上傳視頻到點播