上傳媒體檔案到VOD - ApsaraVideo VOD

媒體上傳的實質是將媒體資源註冊到ApsaraVideo for VOD服務，因此也是使用ApsaraVideo for VOD其它服務（媒資管理、ApsaraVideo for Media Processing、分發播放等）的前提。本文描述媒體上傳需要關注的媒體格式、上傳方式、上傳相關設定以及上傳後的注意事項等。

媒體格式

ApsaraVideo for VOD可使用視訊、音頻、圖片、輔助媒資（浮水印、字幕、素材檔案）等媒體檔案上傳。檔案可以是本地檔案也可以是網路檔案（網路檔案採用URL拉取上傳）。各類型檔案的詳細格式支援情況請參見下表。

說明

上傳時需要包含副檔名，大小寫都支援，如MP4和mp4等同。

媒體類型	支援檔案格式
視頻	MPEG格式：MP4、TS、3GP、MPG、MPEG、MPE、DAT、VOB、ASF等。 AVI格式：AVI。 Windows Media Video格式：WMV、ASF。 Flash Video格式：FLV、F4V。 Real Video格式：RM、RMVB。 QuickTime格式：MOV。 Matroska格式：MKV。 HLS格式：M3U8。說明 M3U8格式的檔案，通過ApsaraVideo for VOD控制台上傳時，僅支援URL拉取方式上傳；對於本地M3U8檔案，您可以通過ApsaraVideo for VODAPI或SDK進行本地M3U8檔案上傳，上傳方式請參見通過ApsaraVideo for VODAPI上傳媒資檔案。其它格式：DV、GIF、M2T、M4V、MJ2、MJPEG、MTS、OGG、QT、SWF、WEBM。
音頻	MP3、WMA、WAV、AAC、RA、M4A、FLAC、APE、AC3、AMR、CAF、ACM。
圖片	PNG、JPG、JPEG、GIF、HEIC。
輔助媒資	浮水印檔案：PNG、GIF、APNG、MOV。字幕檔案：SRT、ASS、STL、TTML、VTT。素材檔案：JPG、GIF、PNG、MP4、MAT、ZIP。

上傳方式

ApsaraVideo for VOD針對不同操作環境，提供工具上傳和開發上傳兩大類上傳方式。

工具上傳

為滿足部分使用者快速上傳或在較低門檻的營運情境下上傳大檔案等需求，ApsaraVideo for VOD提供介面化的上傳工具，包括ApsaraVideo for VOD控制台和PC端上傳工具。兩種工具的說明如下：

上傳方式	適用情境	使用說明
控制台	快速、便捷地將媒體資源上傳到點播的情境。說明控制台由於安全性原則，長時間上傳可能會登入失效導致大檔案上傳失敗，大檔案建議使用PC用戶端工具上傳，能有效避免此問題。	開通點播服務後，使用瀏覽器登入控制台即可進行上傳。針對音視頻媒體，控制台支援本地檔案上傳，也支援URL拉取上傳。
PC端上傳工具	大檔案、長時間上傳，以及低門檻的營運情境。	需要下載並安裝點播用戶端工具，目前僅支援Windows用戶端。僅支援本地檔案上傳。

開發上傳

為滿足開發人員使用者的上傳需求，ApsaraVideo for VOD提供SDK或API的上傳方式，其基礎流程為：

在ApsaraVideo for VOD服務內擷取上傳憑證和上傳地址。
調用OSS上傳能力上傳媒體。

目前支援的開發人員上傳方式包括：

上傳SDK（含服務端與用戶端）：上傳SDK封裝了擷取上傳憑證及地址的邏輯和OSS上傳的邏輯。開發人員僅需要簡單配置就可以實現上傳功能，推薦使用。
URL批量拉取上傳：ApsaraVideo for VOD提供一個封裝好的服務（URL批量拉取上傳介面），協助開發人員將媒體檔案通過公網訪問的URL地址拉取並上傳到ApsaraVideo for VOD的儲存地址。這種方式可以免去先將檔案下載到本機伺服器或終端再使用上傳SDK上傳到點播的過程。
說明
URL拉取上傳是非同步任務，非即時，不保證時效性，一般提交後會在數小時、甚至數天內完成遷移上傳。如果對時效性要求較高，建議使用上傳SDK上傳。
基於OSS原生SDK：當上傳SDK無法滿足業務需求（如開發語言不匹配）時，開發人員可以結合點播服務端SDK（擷取上傳憑證及地址）和OSS原生SDK（Base64解碼擷取到的上傳憑證及地址，然後調用OSS介面）完成上傳。
基於OSS服務端API（不推薦）：開發人員也可以直接調用點播服務端介面擷取上傳地址和憑證，再調用OSS原生API完成上傳。考慮到上傳效率和出錯機率等因素，一般不推薦這種方式。

說明

關於如何選擇上傳方式，請參見如何選擇上傳方式。

各開發人員上傳工具的說明如下：

上傳方式	適用情境	使用說明
上傳SDK（服務端）	自動化上傳、大批量遷移視頻上傳等情境。網路媒體檔案上傳。說明推薦使用上傳SDK。如果上傳SDK支援的語言不滿足要求，還可以使用OSS原生SDK完成上傳。	服務端上傳SDK封裝了ApsaraVideo for VOD內擷取上傳憑證及地址的邏輯和OSS的上傳能力，僅需要簡單配置就可以實現上傳功能。目前支援的開發語言套件括：Java、Python、PHP、C/C++。
上傳SDK（用戶端）	UGC（使用者生產內容）、PGC（專業生產內容）等情境。	用戶端上傳SDK封裝了OSS的上傳邏輯。需要使用者自行擷取上傳地址和憑證，推薦在應用伺服器整合點播服務端SDK擷取。擷取後無需解碼，直接下發給用戶端即可。目前支援的用戶端包括：Android端、iOS端、Web端（JavaScript）、微信小程式。
URL批量拉取上傳	檔案沒有儲存在本機伺服器或終端，需要通過公網訪問的URL地址上傳的情境。	僅支援上傳到華東2（上海）和新加坡地區。不適用於本地檔案上傳。
基於OSS原生SDK上傳	自動化上傳、大批量遷移視頻上傳等情境。網路媒體檔案上傳。	使用基於OSS原生SDK方式需要開發人員使用者自行實現所有上傳邏輯，包括在點播服務擷取上傳地址和憑證、Base64解碼上傳憑證和地址和調用OSS能力完成上傳。目前支援的開發語言套件括：Java、Python、PHP、.NET、Go、Node.js、C/C++。說明 Java、Python、PHP、C/C++語言推薦使用點播上傳SDK。
基於OSS API上傳不推薦	自動化上傳、大批量遷移視頻上傳等情境。網路媒體檔案上傳。	調用ApsaraVideo for VOD相關服務端API擷取上傳地址和憑證。 Base64解碼上傳憑證和地址後再使用OSS能力上傳檔案。

儲存說明

儲存地區

ApsaraVideo for VOD基於阿里雲Object Storage Service（Object Storage Service）提供媒體資源儲存服務。ApsaraVideo for VOD的儲存節點遍布全球，每個儲存節點為一個儲存地區，每個儲存地區由點播系統分配一個儲存地址。

儲存地址

說明

ApsaraVideo for VOD預設同一帳號不同地區資料不互連，上傳檔案前請確認您的上傳地區和實際業務地區一致，否則可能導致找不到檔案。

儲存地址設定	說明
啟用點播系統儲存地址	開通ApsaraVideo for VOD服務後，不同的服務地區會預設分配一個獨立的儲存Bucket（類型為點播系統Bucket），通過啟用該Bucket，無需其他配置即可進行上傳和媒體資源管理。詳情請參見啟用點播系統Bucket。
添加新地址	支援將自有的OSS Bucket添加到ApsaraVideo for VOD服務中，以實現對儲存在OSS Bucket中的媒體檔案進行轉碼、截圖、播放等操作。詳情請參見添加OSS自有Bucket。
修改預設地址	啟用多個儲存地區的儲存地址或添加多個儲存地址後，可修改預設儲存地址。上傳檔案時可以指定儲存地址或不指定儲存地址，不指定時點播系統將選用預設儲存地址。詳情請參見設定預設儲存地址。

ApsaraVideo for VOD支援的儲存地區及對應的儲存地區標識如下。

說明

使用ApsaraVideo for VOD控制台或PC端上傳工具上傳時根據登入（或選擇）的地區使用儲存地址。使用SDK或API上傳時，可通過參數（如URL拉取上傳介面的StorageLocation參數）指定儲存地址。

儲存地區	儲存地區標識
華東2（上海）	cn-shanghai
華北2（北京）	cn-beijing
華南1（深圳）	cn-shenzhen
中國香港	cn-hongkong
日本（東京）	ap-northeast-1
新加坡	ap-southeast-1
印尼（雅加達）	ap-southeast-5
德國（法蘭克福）	eu-central-1
美國（矽谷）	us-west-1
印度（孟買）關停中	ap-south-1

儲存計費

ApsaraVideo for VOD儲存服務支援隨用隨付（後付費）和資源套件（預付費）兩種付費方式。

隨用隨付詳情請參見媒資儲存計費。
資源套件詳情請參見ApsaraVideo for VOD儲存包。

上傳設定

ApsaraVideo for VOD支援多種上傳時的功能設定，如媒資管理、音視頻轉碼、上傳事件通知、上傳控制等。

功能列表

各上傳方式支援上傳時功能設定的詳情如下：

分組	詳細功能	控制台	PC端上傳工具	上傳SDK（服務端）	上傳SDK（用戶端）	URL批量拉取上傳	基於OSS原生SDK上傳	基於OSS API上傳
媒資管理	設定媒體標題	支援	支援	支援	支援	支援	支援	支援
	指定媒體分類	支援	支援	支援	支援	支援	支援	支援
	設定媒體標籤	不支援	支援	支援	支援	支援	支援	支援
	設定視頻封面	不支援	不支援	支援	支援	支援	支援	支援
音視頻轉碼	轉碼模板組	支援	支援	支援	支援	支援	支援	支援
	工作流程	支援	不支援	支援	支援	支援	支援	支援
	不轉碼	支援	支援	支援	支援	支援	支援	支援
上傳控制	擷取上傳進度	支援	支援	支援	支援	支援	支援	支援
	斷點續傳	不支援	不支援	僅Java上傳SDK支援	支援	不支援	僅Java語言支援	不支援
	分區上傳	預設啟用	預設啟用	預設啟用	預設啟用	預設啟用	預設啟用	預設啟用

媒資管理（上傳時）

設定媒體標題：上傳時設定音視頻、圖片的標題。
指定媒體分類：建立好分類後，上傳時指定媒體檔案屬於某個分類。
設定媒體標籤：上傳時設定媒體標籤。
設定視頻封面：上傳視頻時附帶一張圖片作為該視頻的封面。

音視頻轉碼

上傳音視頻檔案時設定轉碼（通過指定轉碼模板組或指定工作流程），上傳完成後自動觸發轉碼。也可以設定不轉碼，但需要注意的是目前僅以下格式支援不轉碼直接播放：MP4、FLV、M3U8、MP3、WEBM。

指定轉碼模板組轉碼：指定轉碼模板組是點播的預設處理方式，上傳時選擇轉碼模板組處理方式。上傳完成後點播系統會自動觸發轉碼。
指定工作流程轉碼：建立好含轉碼任務的工作流程後，上傳時選擇工作流程處理方式。上傳完成後，點播系統會自動執行指定的工作流程完成轉碼任務。
不轉碼：如果上傳時不需要轉碼，可通過選擇轉碼模板組中的不轉碼模板實現。

上傳控制

分區上傳：將待上傳的檔案分成多個片段（Part）分別上傳，上傳完成之後將這些Part組合成一個Object。ApsaraVideo for VOD上傳功能預設採用分區上傳的方式上傳檔案。
說明
使用分區上傳時，若上傳失敗則可能會產生片段檔案，一般7天后會自動清除。開發人員使用者還可以調用刪除上傳中的片段檔案介面手動清除片段檔案。
擷取上傳進度或狀態。
斷點續傳：如果上傳過程中出現網路錯誤導致上傳失敗，ApsaraVideo for VOD支援從最後一塊成功上傳的片段（Part）開始繼續上傳，從而實現斷點續傳效果。
說明
上傳SDK（用戶端）內部會完成斷點續傳的功能，使用者不需要關心任何斷點和片段恢複，因為異常情況導致的視頻上傳失敗重新上傳都會從斷點處開始上傳。

上傳事件通知

在媒體檔案上傳完成後，可通過事先配置的回調地址及時擷取處理進展和狀態。ApsaraVideo for VOD支援HTTP回調（相容HTTPS）、MNS回調兩種方式擷取事件通知。瞭解回調配置請參見事件通知概述。完成回調配置請參見回調設定。所有上傳方式均支援上傳事件通知。上傳相關的事件如下表所示。

說明

關於每個事件的內容詳情，請參見事件通知。

事件名稱	事件類型	說明
視頻上傳完成	FileUploadComplete	點播服務端接收完上傳的音視頻檔案後，會產生FileUploadComplete事件。說明對於不轉碼的音視頻（或音頻）接收到視頻上傳完成事件通知後方可擷取播放地址播放。如果上傳時設定了不轉碼，接收到視頻上傳完成事件通知後，還可再調用提交媒體轉碼作業介面轉碼。
圖片上傳完成	ImageUploadComplete	點播服務端接收完上傳的圖片檔案上傳後，會產生ImageUploadComplete事件。
輔助媒資上傳完成	AttachedMediaUploadComplete	點播服務端接收完上傳的輔助媒資檔案後，會產生AttachedMediaUploadComplete事件。
URL上傳視頻完成	UploadByURLComplete	調用URL批量拉取上傳任務後，雲端拉取視頻上傳完成會產生UploadByURLComplete事件。
單個清晰度轉碼完成	StreamTranscodeComplete	視頻的某個清晰度、某種格式的流（如：標清的MP4格式）轉碼完成時會產生此事件。說明對於轉碼的音視頻，接收到單個清晰度轉碼完成事件通知後方可擷取播放地址播放。未收到回調前播放可能會導致播放失敗。
視頻轉碼完成	TranscodeComplete	視頻所有流轉碼完成會產生TranscodeComplete事件。說明若要確保播放前所有清晰度都能擷取到，可接收到視頻轉碼完成事件通知後再處理。未收到回調前播放可能會導致播放失敗。

上傳授權

在開發上傳情境下，通過上傳憑證和STS方式都能解決上傳中的授權和安全問題，防止媒體檔案被惡意上傳和播放。

兩種方式的適用情境請參見憑證方式與STS方式對比。
具體使用請參見各開發人員上傳方式的操作文檔。
自2024年01月31日起，ApsaraVideo for VOD將不再支援通過OSS Header x-oss-object-acl的方式修改檔案許可權，可有效避免您直接上傳公用讀取的檔案從而導致您的媒體資源外泄或被惡意訪問導致費用激增等問題。在此之前，您可以通過下述許可權管理的方法來限制上傳公用讀取檔案到點播的OSS自有Bucket中的行為，具體方法如下：
1. 授權ApsaraVideo for VOD服務訪問您的OSS等資源，可點擊雲資源訪問授權頁面進行授權。
2. 建立禁止上傳Object ACL許可權為公用讀取的檔案到OSS自有Bucket中的自訂權限原則，具體操作及權限原則內容請參見禁止上傳Object ACL許可權為公用讀取的檔案到OSS自有Bucket中。
3. 為AliyunVODDefaultRole角色授予上一步建立的禁止上傳Object ACL許可權為公用讀取的檔案到OSS自有Bucket中的許可權。
  登入RAM控制台進行授權，具體操作請參見為RAM使用者授權。

上傳加速

功能說明

ApsaraVideo for VOD服務提供上傳加速的功能，以提升遠距離檔案傳輸和GB、TB級大檔案的上傳效能。上傳加速適用於跨地區（如跨海情況）上傳，例如在中國內地將視頻上傳到新加坡儲存地區的儲存地址。

開通方式

開通上傳加速功能需提交工單，您需要提供阿里雲帳號UID和需要使用上傳加速的儲存地址。

計費說明

上傳加速是點播的增值功能，按使用方式收費。具體計費詳情，請參見儲存傳輸加速計費。

說明

只開通不使用不收費。

使用限制及支援的上傳方式

上傳加速僅限於上傳視頻。各上傳方式的支援情況如下：

上傳方式	上傳加速
控制台	不支援
PC端上傳工具	支援
上傳SDK（服務端）	支援
上傳SDK（用戶端）	支援
URL批量拉取上傳	支援
基於OSS原生SDK上傳	支援
基於OSS API上傳	支援

上傳之後

說明

媒體資源上傳到ApsaraVideo for VOD之後，根據業務處理的情況和階段不同，會處於不同的媒體狀態。處於不同媒體狀態的音視頻等媒體資源在ApsaraVideo for VOD中可以執行的操作不同，例如：處於上傳中、上傳失敗、屏蔽狀態的音視頻僅可以刪除，無法進行其他動作，即無法發起轉碼處理、視頻截圖、媒資審核等操作；而處於正常狀態的音視頻可以進行所有操作，包括髮起轉碼處理、視頻截圖、媒資審核、播放等其他動作。有關媒體狀態的詳細資料，請參見Status：視頻狀態和Status：圖片狀態。

媒體上傳完成後可使用的ApsaraVideo for VOD服務及後續分發播放的注意事項如下：

點播服務	描述	相關文檔
媒資管理（上傳後）	上傳完成後，可使用點播服務管理媒體檔案，如視頻源檔案、轉碼後的流檔案、圖片檔案等。	媒資管理
ApsaraVideo for Media Processing	點播支援媒體檔案上傳後的音視頻轉碼、智能審核、雲剪輯、AI處理等。說明上傳到點播儲存的音視頻檔案會預設提取Meta資訊（如視頻解析度、時間長度、碼率等），對視頻也會預設截取封面圖，且這部分預先處理完全免費。	ApsaraVideo for Media Processing
音視頻播放	使用者上傳音視頻完成後，並不代表音視頻已準備就緒，還需點播服務端確認接收完成，可根據事件通知來確定上傳的音視頻何時能播放。對於不轉碼的音視頻（或音頻）接收到視頻上傳完成事件通知後即可擷取播放地址播放。對於轉碼的音視頻，接收到單個清晰度轉碼完成事件通知後即可擷取播放地址播放。若要確保所有清晰度都能擷取到，可接收到視頻轉碼完成事件通知後再處理。	視頻上傳完成擷取音視頻播放地址單個清晰度轉碼完成視頻轉碼完成