如何通過控制台和API、SDK擷取媒資資訊 - ApsaraVideo VOD

媒體檔案上傳完成或完成ApsaraVideo for Media Processing後，就可以通過控制台或者API擷取到相應媒資資訊。本文為您介紹通過控制台和API/SDK擷取媒資資訊的方法。

情境一：通過API擷取/更新

媒資資訊是描述一個媒體檔案的結構化資料集合。為了滿足不同業務情境的需求，ApsaraVideo for VOD將媒資資訊劃分為以下幾種類型，可以通過不同的API獨立擷取和更新：

資訊類型	擷取資訊API	更新資訊API	使用情境
基礎資訊	擷取單個音視頻資訊批量擷取音視頻資訊擷取單個圖片資訊	修改單個音視頻資訊批量修改音視頻資訊批次更新圖片資訊	擷取媒資基礎資訊（標題/時間長度/狀態）用於應用展示，更新媒資屬性（標題/描述/封面圖/分類ID/標籤）完善內容管理。
源檔案資訊	擷取源檔案資訊	源檔案資訊是從檔案本身提取的Meta資訊，不支援更新。	擷取上傳的原始檔案地址和參數，常用於存檔、二次處理或問題排查。
播放資訊	擷取音視頻播放地址	播放資訊不支援更新。但可通過轉碼，轉出新的音視頻流。提交媒體轉碼作業	擷取用於播放的地址（含鑒權），是視頻播放功能的核心。

說明

推薦使用服務端SDK調用API來擷取和更新媒資資訊，詳情請參見VOD SDK使用說明。

控制台提供了直觀的介面來查看和管理單個媒資的詳細資料，適合營運人員日常管理或開發階段快速驗證。

以音/視頻管理為例：

可以在基礎資訊頁簽查看或修改音/視頻的標題、描述、分類、標籤、封面等資訊。資訊編輯完成後，單擊保存完成配置。

基礎資訊

參數和說明如下表所示。

參數	說明
封面	您可以通過上傳一張圖片或選中某個視頻截圖，將其設定為預設的視頻封面。說明可以上傳自訂封面，僅支援JPG或PNG格式，最大1MB，解析度不超過1920*1080。
名称	音/視頻的名稱，播放時在播放器視窗中可見，支援的長度範圍為1~128個位元組。
描述	音/視頻的詳細描述資訊，支援的長度範圍為0~1024個位元組。
分类	可以在分類管理中，配置視頻分類，詳情請參見媒資分類。
标签	可以對每個音/視頻添加多個標籤，僅支援中文、英文、數字及底線，輸入逗號、分號，或按斷行符號鍵完成單個標籤輸入。

可以查看當前視頻的原始檔案、所有轉碼格式和所有清晰度的詳細地址，以及相應的解析度和碼率資訊。

功能和說明如下表所示。

功能	說明
复制地址	複製當前清晰度的播放地址到瀏覽器或播放器中預覽播放。
预览	在控制台中直接預覽當前清晰度的視頻。
删除	刪除對應清晰度視頻。
一键清除	清除全部轉碼後的檔案（不含原始檔案），清除後無法恢複，請謹慎使用。

開發人員可以根據需要，針對每個視頻使用HTML代碼或JavaScript代碼。此外，還可以通過使用播放器參數（包括播放器尺寸、是否自動播放）的快捷組態工具，快速修改程式碼片段中的相應參數，提高工作效率。

說明

web播放器