獲取上傳地址和憑證的環節為點播服務的核心基礎。本文介紹上傳地址和憑證的工作原理、使用說明、使用限制、獲取方式以及解析方式。
技術原理
上傳地址是上傳媒體文件到點播存儲的文件地址,上傳憑證是完成上傳動作的授權憑證。上傳地址和上傳憑證均由點播服務下發,主要解決媒體上傳過程中的授權和安全問題,防止惡意上傳。同時,點播服務在下發上傳地址和憑證時還會自動創建媒資信息,即媒體ID(MediaId),用于媒資生命周期管理或媒體處理。
媒體ID
媒體ID在某些場合也叫視頻ID(VideoId)或圖片ID(ImageId),可用于以下場景:
上傳后追蹤和管理媒體的生命周期。利用上傳地址和憑證完成上傳后,媒體的初始狀態一般為上傳中。相應的處理完成后會自動更新為下一個狀態,如上傳完成、轉碼中、正常等。
上傳后指定媒體(用媒體ID識別)發起轉碼、截圖、視頻AI處理及視頻剪輯等操作。
使用限制
上傳地址和憑證只能用于單個媒體(單個音頻、單個視頻或單個圖片),不能多個混用,否則會互相覆蓋。
同一個視頻,重復請求會獲取到不同的上傳地址和憑證。
上傳地址(目錄)由點播服務自動分配,暫不支持自由指定。
上傳憑證有效期統一為3000秒(50分鐘)。
由于視頻文件可能較大、上傳耗時較長,憑證失效后需要刷新上傳憑證,刷新后新的憑證有效期仍是3000秒,且上傳地址不變。
圖片、輔助媒資(水印、字幕文件等)文件較小,憑證失效后只能重新獲取。
使用說明
上傳視頻、圖片和輔助媒資需要調用不同的服務端接口獲取對應的上傳地址和憑證。在所有面向開發者的上傳方式中,僅部分方式需要關心如何獲取上傳地址和上傳憑證。詳情如下表所示。
除了通過上傳地址和憑證方式,部分場景還支持通過STS臨時Token訪問點播服務。兩種方式的對比請參見憑證方式與STS方式對比。在上傳場景下,兩種方式在操作上的區別如下:
使用上傳憑證在構造上傳請求時可直接傳入阿里云賬號AK或者RAM用戶AK。
使用STS臨時Token在構造上傳請求時需要傳入提前獲取的STS臨時Token。更多信息請參見STS臨時Token。
上傳方式 | 是否需要自行獲取上傳地址和憑證 | 是否需要自行解析上傳地址和憑證 |
否 重要 上傳SDK在服務端當前僅支持四種語言:
| 否 | |
是 說明 只需要下發給客戶端即可。 | 否 | |
否 | 否 | |
是 說明 基于OSS原生SDK上傳的實質是集成點播服務端SDK獲取上傳地址和憑證,使用獲取到的上傳地址和憑證初始化OSS SDK完成上傳邏輯。 | 是 | |
是 | 是 |
獲取上傳地址和憑證
視頻點播提供兩種方式供開發者自行獲取上傳地址和憑證。
具體的代碼示例請點擊使用說明中對應上傳方式跳轉至操作步驟中查看。
(推薦)通過視頻點播VOD SDK調用API來獲取上傳地址和憑證。更多內容,請參見SDK概述。
開發語言 | SDK調用示例 |
Java | |
Python |
通過生成HTTP/HTTPS請求獲取上傳地址和憑證需要自行構造簽名,相對復雜。詳細信息請參見請求構造指引和獲取上傳地址和憑證相關接口。
常用接口
解析上傳地址和憑證
只有基于OSS原生SDK或API實現上傳的方式需要關注如何解析上傳地址和憑證。其它上傳方式不需要解析上傳地址和憑證,也不需要關注其內部邏輯。
將點播服務端返回的上傳地址(UploadAddress)和上傳憑證(UploadAuth)分別進行Base64解碼,可得到OSS的上傳地址和授權信息。解析的具體示例請參見基于OSS原生SDK上傳視頻到點播。