媒體上傳概述
媒體上傳的實質(zhì)是將媒體資源注冊到視頻點播服務，因此也是使用視頻點播其它服務（媒資管理、媒體處理、分發(fā)播放等）的前提。本文描述媒體上傳需要關注的媒體格式、上傳方式、上傳相關設置以及上傳后的注意事項等。
媒體格式
視頻點播支持視頻、音頻、圖片、輔助媒資（水印、字幕、素材文件）等媒體文件上傳。文件可以是本地文件也可以是網(wǎng)絡文件（網(wǎng)絡文件采用URL拉取上傳）。各類型文件的詳細格式支持情況請參見下表。
上傳時需要包含文件擴展名，大小寫都支持，如MP4和mp4等同。
媒體類型 | 支持文件格式 |
視頻 |
|
音頻 | MP3、WMA、WAV、AAC、RA、M4A、FLAC、APE、AC3、AMR、CAF、ACM。 |
圖片 | PNG、JPG、JPEG、GIF、HEIC。 |
輔助媒資 |
|
上傳方式
視頻點播針對不同操作場景，提供工具上傳和開發(fā)上傳兩大類上傳方式。
工具上傳
為滿足部分用戶快速上傳或在較低門檻的運營場景下上傳大文件等需求，視頻點播提供界面化的上傳工具，包括視頻點播控制臺和PC端上傳工具。兩種工具的說明如下：
上傳方式 | 適用場景 | 使用說明 |
快速、便捷地將媒體資源上傳到點播的場景。 說明 控制臺由于安全策略，長時間上傳可能會登錄失效導致大文件上傳失敗，大文件建議使用PC客戶端工具上傳，能有效避免此問題。 |
| |
大文件、長時間上傳，以及低門檻的運營場景。 |
|
開發(fā)上傳
為滿足開發(fā)者用戶的上傳需求，視頻點播提供SDK或API的上傳方式，其基礎流程為：
在視頻點播服務內(nèi)獲取上傳憑證和上傳地址。
調(diào)用OSS上傳能力上傳媒體。
目前支持的開發(fā)者上傳方式包括：
上傳SDK（含服務端與客戶端）：上傳SDK封裝了獲取上傳憑證及地址的邏輯和OSS上傳的邏輯。開發(fā)者僅需要簡單配置就可以實現(xiàn)上傳功能，推薦使用。
URL批量拉取上傳：視頻點播提供一個封裝好的服務（URL批量拉取上傳接口），幫助開發(fā)者將媒體文件通過公網(wǎng)訪問的URL地址拉取并上傳到視頻點播的存儲地址。這種方式可以免去先將文件下載到本地服務器或終端再使用上傳SDK上傳到點播的過程。
說明URL拉取上傳是異步任務，非實時，不保證時效性，一般提交后會在數(shù)小時、甚至數(shù)天內(nèi)完成遷移上傳。如果對時效性要求較高，建議使用上傳SDK上傳。
基于OSS原生SDK：當上傳SDK無法滿足業(yè)務需求（如開發(fā)語言不匹配）時，開發(fā)者可以結(jié)合點播服務端SDK（獲取上傳憑證及地址）和OSS原生SDK（Base64解碼獲取到的上傳憑證及地址，然后調(diào)用OSS接口）完成上傳。
基于OSS服務端API（不推薦）：開發(fā)者也可以直接調(diào)用點播服務端接口獲取上傳地址和憑證，再調(diào)用OSS原生API完成上傳。考慮到上傳效率和出錯概率等因素，一般不推薦這種方式。
關于如何選擇上傳方式，請參見如何選擇上傳方式。
各開發(fā)者上傳工具的說明如下：
上傳方式 | 適用場景 | 使用說明 |
說明 推薦使用上傳SDK。如果上傳SDK支持的語言不滿足要求，還可以使用OSS原生SDK完成上傳。 |
| |
UGC（用戶生產(chǎn)內(nèi)容）、PGC（專業(yè)生產(chǎn)內(nèi)容）等場景。 |
| |
文件沒有存儲在本地服務器或終端，需要通過公網(wǎng)訪問的URL地址上傳的場景。 |
| |
|
| |
不推薦 |
|
|
存儲說明
存儲地域
視頻點播基于阿里云對象存儲OSS（Object Storage Service）提供媒體資源存儲服務。視頻點播的存儲節(jié)點遍布全球，每個存儲節(jié)點為一個存儲地域，每個存儲地域由點播系統(tǒng)分配一個存儲地址。
存儲地址
視頻點播默認同一賬號不同地域數(shù)據(jù)不互通，上傳文件前請確認您的上傳地域和實際業(yè)務地域一致，否則可能導致找不到文件。
存儲地址設置 | 說明 |
啟用點播系統(tǒng)存儲地址 | 開通視頻點播服務后，不同的服務地域會默認分配一個獨立的存儲Bucket（類型為點播系統(tǒng)Bucket），通過啟用該Bucket，無需其他配置即可進行上傳和媒體資源管理。詳情請參見啟用點播系統(tǒng)Bucket。 |
添加新地址 | 支持將自有的OSS Bucket添加到視頻點播服務中，以實現(xiàn)對存儲在OSS Bucket中的媒體文件進行轉(zhuǎn)碼、截圖、播放等操作。詳情請參見添加OSS自有Bucket。 |
修改默認地址 | 啟用多個存儲地域的存儲地址或添加多個存儲地址后，可修改默認存儲地址。上傳文件時可以指定存儲地址或不指定存儲地址，不指定時點播系統(tǒng)將選用默認存儲地址。詳情請參見設置默認存儲地址。 |
視頻點播支持的存儲地域及對應的存儲地域標識如下。
使用視頻點播控制臺或PC端上傳工具上傳時根據(jù)登錄（或選擇）的地域使用存儲地址。使用SDK或API上傳時，可通過參數(shù)（如URL拉取上傳接口的StorageLocation參數(shù)）指定存儲地址。
存儲地域 | 存儲地域標識 |
華東2（上海） | cn-shanghai |
華北2（北京） | cn-beijing |
華南1（深圳） | cn-shenzhen |
日本（東京） | ap-northeast-1 |
新加坡 | ap-southeast-1 |
印度尼西亞（雅加達） | ap-southeast-5 |
德國（法蘭克福） | eu-central-1 |
美國（硅谷） | us-west-1 |
存儲計費
上傳設置
視頻點播支持多種上傳時的功能設置，如媒資管理、音視頻轉(zhuǎn)碼、上傳事件通知、上傳控制等。
功能列表
各上傳方式支持上傳時功能設置的詳情如下：
分組 | 詳細功能 | |||||||
媒資管理 | 設置媒體標題 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 |
指定媒體分類 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 | |
設置媒體標簽 | 不支持 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 | |
設置視頻封面 | 不支持 | 不支持 | 支持 | 支持 | 支持 | 支持 | 支持 | |
音視頻轉(zhuǎn)碼 | 轉(zhuǎn)碼模板組 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 |
工作流 | 支持 | 不支持 | 支持 | 支持 | 支持 | 支持 | 支持 | |
不轉(zhuǎn)碼 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 | |
上傳控制 | 獲取上傳進度 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 |
斷點續(xù)傳 | 不支持 | 不支持 | 僅Java上傳SDK支持 | 支持 | 不支持 | 僅Java語言支持 | 不支持 | |
分片上傳 | 默認啟用 | 默認啟用 | 默認啟用 | 默認啟用 | 默認啟用 | 默認啟用 | 默認啟用 |
媒資管理（上傳時）
設置媒體標題：上傳時設置音視頻、圖片的標題。
指定媒體分類：創(chuàng)建好分類后，上傳時指定媒體文件屬于某個分類。
設置媒體標簽：上傳時設置媒體標簽。
設置視頻封面：上傳視頻時附帶一張圖片作為該視頻的封面。
音視頻轉(zhuǎn)碼
上傳音視頻文件時設置轉(zhuǎn)碼（通過指定轉(zhuǎn)碼模板組或指定工作流），上傳完成后自動觸發(fā)轉(zhuǎn)碼。也可以設置不轉(zhuǎn)碼，但需要注意的是目前僅以下格式支持不轉(zhuǎn)碼直接播放：MP4、FLV、M3U8、MP3、WEBM。
指定轉(zhuǎn)碼模板組轉(zhuǎn)碼：指定轉(zhuǎn)碼模板組是點播的默認處理方式，上傳時選擇轉(zhuǎn)碼模板組處理方式。上傳完成后點播系統(tǒng)會自動觸發(fā)轉(zhuǎn)碼。
指定工作流轉(zhuǎn)碼：創(chuàng)建好含轉(zhuǎn)碼任務的工作流后，上傳時選擇工作流處理方式。上傳完成后，點播系統(tǒng)會自動執(zhí)行指定的工作流完成轉(zhuǎn)碼任務。
不轉(zhuǎn)碼：如果上傳時不需要轉(zhuǎn)碼，可通過選擇轉(zhuǎn)碼模板組中的不轉(zhuǎn)碼模板實現(xiàn)。
上傳控制
分片上傳：將待上傳的文件分成多個碎片（Part）分別上傳，上傳完成之后將這些Part組合成一個Object。視頻點播上傳功能默認采用分片上傳的方式上傳文件。
說明使用分片上傳時，若上傳失敗則可能會產(chǎn)生碎片文件，一般7天后會自動清除。開發(fā)者用戶還可以調(diào)用刪除上傳中的碎片文件接口手動清除碎片文件。
獲取上傳進度或狀態(tài)。
斷點續(xù)傳：如果上傳過程中出現(xiàn)網(wǎng)絡錯誤導致上傳失敗，視頻點播支持從最后一塊成功上傳的碎片（Part）開始繼續(xù)上傳，從而實現(xiàn)斷點續(xù)傳效果。
說明上傳SDK（客戶端）內(nèi)部會完成斷點續(xù)傳的功能，用戶不需要關心任何斷點和片段恢復，因為異常情況導致的視頻上傳失敗重新上傳都會從斷點處開始上傳。
上傳事件通知
在媒體文件上傳完成后，可通過事先配置的回調(diào)地址及時獲取處理進展和狀態(tài)。視頻點播支持HTTP回調(diào)（兼容HTTPS）、MNS回調(diào)兩種方式獲取事件通知。了解回調(diào)配置請參見事件通知概述。完成回調(diào)配置請參見回調(diào)設置。所有上傳方式均支持上傳事件通知。上傳相關的事件如下表所示。
關于每個事件的內(nèi)容詳情，請參見事件詳情。
事件名稱 | 事件類型 | 說明 |
視頻上傳完成 | FileUploadComplete | 點播服務端接收完上傳的音視頻文件后，會產(chǎn)生FileUploadComplete事件。 說明 對于不轉(zhuǎn)碼的音視頻（或音頻）接收到視頻上傳完成事件通知后方可獲取播放地址播放。 如果上傳時設置了不轉(zhuǎn)碼，接收到視頻上傳完成事件通知后，還可再調(diào)用提交媒體轉(zhuǎn)碼作業(yè)接口轉(zhuǎn)碼。 |
圖片上傳完成 | ImageUploadComplete | 點播服務端接收完上傳的圖片文件上傳后，會產(chǎn)生ImageUploadComplete事件。 |
輔助媒資上傳完成 | AttachedMediaUploadComplete | 點播服務端接收完上傳的輔助媒資文件后，會產(chǎn)生AttachedMediaUploadComplete事件。 |
URL上傳視頻完成 | UploadByURLComplete | 調(diào)用URL批量拉取上傳任務后，云端拉取視頻上傳完成會產(chǎn)生UploadByURLComplete事件。 |
單個清晰度轉(zhuǎn)碼完成 | StreamTranscodeComplete | 視頻的某個清晰度、某種格式的流（如：標清的MP4格式）轉(zhuǎn)碼完成時會產(chǎn)生此事件。 說明 對于轉(zhuǎn)碼的音視頻，接收到單個清晰度轉(zhuǎn)碼完成事件通知后方可獲取播放地址播放。未收到回調(diào)前播放可能會導致播放失敗。 |
視頻轉(zhuǎn)碼完成 | TranscodeComplete | 視頻所有流轉(zhuǎn)碼完成會產(chǎn)生TranscodeComplete事件。 說明 若要確保播放前所有清晰度都能獲取到，可接收到視頻轉(zhuǎn)碼完成事件通知后再處理。未收到回調(diào)前播放可能會導致播放失敗。 |
上傳授權(quán)
在開發(fā)上傳場景下，通過上傳憑證和STS方式都能解決上傳中的授權(quán)和安全問題，防止媒體文件被惡意上傳和播放。
兩種方式的適用場景請參見憑證方式與STS方式對比。
具體使用請參見各開發(fā)者上傳方式的操作文檔。
自2024年01月31日起，視頻點播將不再支持通過OSS Header x-oss-object-acl的方式修改文件權(quán)限，可有效避免您直接上傳公共讀的文件從而導致您的媒體資源外泄或被惡意訪問導致費用激增等問題。在此之前，您可以通過下述權(quán)限管理的方法來限制上傳公共讀文件到點播的OSS自有Bucket中的行為，具體方法如下：
授權(quán)視頻點播服務訪問您的OSS等資源，可點擊云資源訪問授權(quán)頁面進行授權(quán)。
創(chuàng)建禁止上傳Object ACL權(quán)限為公共讀的文件到OSS自有Bucket中的自定義權(quán)限策略，具體操作及權(quán)限策略內(nèi)容請參見禁止上傳Object ACL權(quán)限為公共讀的文件到OSS自有Bucket中。
為AliyunVODDefaultRole角色授予上一步創(chuàng)建的禁止上傳Object ACL權(quán)限為公共讀的文件到OSS自有Bucket中的權(quán)限。
登錄RAM控制臺進行授權(quán)，具體操作請參見為RAM用戶授權(quán)。
上傳加速
功能說明
視頻點播服務提供上傳加速的功能，以提升遠距離文件傳輸和GB、TB級大文件的上傳性能。上傳加速適用于跨區(qū)域（如跨海情況）上傳，例如在中國內(nèi)地將視頻上傳到新加坡存儲地域的存儲地址。
開通方式
開通上傳加速功能需提交工單，您需要提供阿里云賬號UID和需要使用上傳加速的存儲地址。
計費說明
上傳加速是點播的增值功能，按使用情況收費。具體計費詳情，請參見存儲傳輸加速計費。
只開通不使用不收費。
使用限制及支持的上傳方式
上傳加速僅限于上傳視頻。各上傳方式的支持情況如下：
上傳方式 | 上傳加速 |
不支持 | |
支持 | |
支持 | |
支持 | |
支持 | |
支持 | |
支持 |
上傳之后
媒體資源上傳到視頻點播之后，根據(jù)業(yè)務處理的情況和階段不同，會處于不同的媒體狀態(tài)。處于不同媒體狀態(tài)的音視頻等媒體資源在視頻點播中可以執(zhí)行的操作不同，例如：處于上傳中、上傳失敗、屏蔽狀態(tài)的音視頻僅可以刪除，無法進行其他操作，即無法發(fā)起轉(zhuǎn)碼處理、視頻截圖、媒資審核等操作；而處于正常狀態(tài)的音視頻可以進行所有操作，包括發(fā)起轉(zhuǎn)碼處理、視頻截圖、媒資審核、播放等其他操作。有關媒體狀態(tài)的詳細信息，請參見Status：視頻狀態(tài)和Status：圖片狀態(tài)。
媒體上傳完成后可使用的視頻點播服務及后續(xù)分發(fā)播放的注意事項如下：
點播服務 | 描述 | 相關文檔 |
媒資管理（上傳后） | 上傳完成后，可使用點播服務管理媒體文件，如視頻源文件、轉(zhuǎn)碼后的流文件、圖片文件等。 | |
媒體處理 | 點播支持媒體文件上傳后的音視頻轉(zhuǎn)碼、智能審核、云剪輯、AI處理等。 說明 上傳到點播存儲的音視頻文件會默認提取Meta信息（如視頻分辨率、時長、碼率等），對視頻也會默認截取封面圖，且這部分預處理完全免費。 | |
音視頻播放 | 用戶上傳音視頻完成后，并不代表音視頻已準備就緒，還需點播服務端確認接收完成，可根據(jù)事件通知來確定上傳的音視頻何時能播放。
|