用戶端上傳，是指將移動端媒體檔案上傳到點播儲存。ApsaraVideo for VOD提供用戶端上傳SDK以及相應的使用Demo。本文介紹用戶端上傳SDK的使用情境、上傳流程和操作指引。
使用情境
用戶端上傳SDK適用於UGC（使用者生產內容）、PGC（專業生產內容）等情境，支援本地檔案上傳和網路檔案上傳。
用戶端上傳SDK中的Android端上傳還支援短視頻上傳。短視頻上傳通過上傳執行個體（VODSVideoUploadClient）完成，支援同時上傳視頻和封面圖片。
功能點 | 說明 | 備忘 |
支援用戶端 | 目前支援的用戶端包括：Web、iOS、Android、微信小程式。 | 暫無 |
媒體說明 | 支援的媒體格式請參見媒體上傳概述。 支援本地檔案上傳和網路檔案上傳（URL拉取方式）。 支援短視頻SDK錄製上傳。 同時上傳多個檔案支援檔案清單管理。包括檔案的增加、刪除、取消、恢複、遍曆、清空。 |
說明 設定URL上傳時需要將URL編碼後再傳入後使用，避免存在特殊字元導致無法上傳的情況。 |
儲存地址 | 支援使用預設儲存地址或指定儲存地址。 | 預設儲存地址可以修改。詳情請參見管理儲存Bucket。 URL上傳僅支援華東2（上海）地區。 可通過設定擷取上傳地址和憑證相關介面StorageLocation參數實現 |
媒資管理 | 支援設定中繼資料，如媒體標題、媒體標籤、媒體分類、視頻封面等。 | 可通過擷取上傳地址和憑證相關介面的參數（如Title、Tags、CateId、CoverURL等）設定。 |
音視頻轉碼 | 支援通過指定轉碼模板或工作流程設定轉碼。 也支援不轉碼。 | 可通過擷取上傳地址和憑證相關介面的參數（如TemplateGroupId、WorkflowId等）設定。 |
上傳控制 | 包括開始、停止、暫停、恢複。 支援斷點續傳。 | 上傳SDK內部會完成斷點續傳的功能，使用者不需要關心任何斷點和片段恢複，因為異常情況導致的視頻上傳失敗重新上傳都會從斷點處開始上傳。 |
事件通知 | 支援設定回調擷取上傳事件通知。支援的事件通知請參見上傳設定。 | 配置回調請參見回調設定。 |
上傳授權 | 支援上傳憑證方式（使用阿里雲帳號AK或經過授權的RAM使用者AK初始化）授權上傳。 支援STS方式（使用STS臨時AK初始化）授權上傳。 | 移動端或Web端推薦使用STS臨時方式。 STS方式需要使用者自行搭建服務擷取STS臨時AK。 用戶端上傳SDK提供了重新整理臨時Token的程式碼範例。 |
上傳加速 | 開通後支援。開通需提交工單。 | 申請開通後，可通過擷取上傳地址和憑證相關介面的 |
網路切換 | 支援移動網路3G/4G與WIFI之間切換。 | 為了避免浪費3G/4G網路下的流量，切換到3G/4G網路時，可以調用pause暫停上傳。在切換回WIFI網路時，調用resume恢複上傳（網路切換部分需要應用自己實現判斷）。 |
上傳地址和憑證相關介面包括：
上傳流程
用戶端上傳SDK封裝了OSS上傳邏輯。在用戶端上傳媒體檔案時，會直接將檔案上傳到點播儲存（基於OSS），不會再經服務端進行中轉，故用戶端上傳必須進行鑒權，也就是需要您在應用伺服器上部署授權服務以擷取上傳地址和憑證。目前用戶端上傳SDK支援兩種授權方式：
使用上傳地址和憑證授權：建議整合點播服務端SDK來擷取上傳地址和憑證。
使用STS方式授權：需要提前為RAM使用者建立角色並授權，也需要自行搭建STS授權服務。
上傳地址和憑證方式上傳流程詳解
以整合點播服務端SDK擷取上傳地址和憑證為例，完整的上傳流程如下圖所示：
使用者在上傳應用伺服器部署授權服務（如整合點播服務端SDK）用於擷取上傳地址和憑證。
用戶端向上傳應用伺服器發起請求擷取上傳地址和憑證。
上傳應用伺服器向ApsaraVideo for VOD服務發起請求擷取上傳地址和憑證。
點播服務返回上傳地址和憑證。
說明點播服務在下發上傳地址和憑證時還會自動建立媒資資訊，即媒體ID（MediaId），用於媒資生命週期管理或ApsaraVideo for Media Processing。
擷取視頻上傳地址和憑證返回的
VideoId即媒體ID。擷取圖片上傳地址和憑證返回的
ImageId即媒體ID。擷取輔助媒資上傳地址和憑證返回的
MediaId即媒體ID。請妥善儲存媒體ID，作為媒資管理、音視頻播放、ApsaraVideo for Media Processing等的輸入。
上傳應用伺服器向用戶端下發上傳地址和憑證。
重要下發地址和憑證即可，無需Base64解碼。
用戶端使用上傳地址和憑證初始化上傳執行個體。
用戶端構造上傳參數發起上傳請求。
OSS服務返回上傳結果。
說明上傳結果也可以通過提前配置回調接收上傳相關事件來監聽。
STS方式上傳流程詳解
使用STS方式上傳的完整的流程如下圖所示：
使用者在上傳應用伺服器部署授權服務（如整合阿里雲STS SDK）用於擷取STS臨時Token。
用戶端向上傳應用伺服器發起請求擷取STS臨時Token。
上傳應用伺服器向阿里雲STS服務發起請求擷取STS臨時Token。
阿里雲STS服務返回上傳地址和憑證。
上傳應用伺服器向用戶端下發STS臨時Token。
用戶端使用STS臨時Token初始化上傳執行個體。
用戶端構造請求發起上傳請求。
OSS服務返回上傳結果。
說明上傳結果也可以通過提前配置回調接收上傳相關事件來監聽。
操作指引
不同用戶端上傳SDK的整合與使用方法不同。請根據需要點擊以下連結跳轉至具體的操作指引。