全部產品
Search
文件中心

Apsara Video SDK:快速入門

更新時間:Nov 26, 2025

通過閱讀本文,您可以瞭解如何快速接入MediaBox音視頻SDK。

步驟一:瞭解MediaBox音視頻SDK功能

MediaBox音視頻SDK目前提供四個情境的一體化SDK:基礎直播SDK、互動直播SDK、短視頻情境SDK、標準一體化SDK。

功能

播放器SDK

直播推流SDK

ARTC SDK

短視頻SDK

美顏特效SDK

主播開播

支援

  • 主播-觀眾連麥

  • 主播跨房間PK

支援

(互動版)

支援

音視訊通話

支援

視頻錄製

支援

視頻編輯

支援

視頻上傳

支援

直播播放

支援

點播播放

支援

美顏特效

支援

手勢識別

支援

智能摳圖

支援

(可選)步驟二:體驗MediaBox音視頻SDK Demo

掃描以下二維碼,下載並安裝MediaBox音視頻SDK App進行體驗。

image.png

Demo源碼及更多資訊請參見Demo

步驟四:申請License

步驟一:建立應用

  1. 進入點播控制台我的授權,選擇應用管理標籤頁,點擊建立應用image

  2. 編輯應用資訊,應用按端類型分為Web端和移動端。

    1. Web端:依次填入應用程式名稱和對應的Web網域名稱,完成應用建立。image

      Web網域名稱填寫注意事項

      • 標準填寫樣本:aliyun.com。

        重要

        當需要同時覆蓋多個子網域名稱時(例如pc.aliyun.com和mobile.aliyun.com),只需填寫主網域名稱“aliyun.com”即可。

      • 錯誤填寫樣本(請勿填寫以下形式)

        • 包含協議頭:http://aliyun.com或 https://aliyun.com。

        • 包含路徑或子頁面:aliyun.com/index或aliyun.com/login。

        • 使用泛網域名稱:*.aliyun.com或.aliyun.com。

    2. 移動端:依次填入應用程式名稱,並填入相對應的安卓包名、iOS BundleIDHarmonyOS BundleID,完成應用建立。

      image

      綁定Android應用簽名

      說明
      • 如果平台類型選擇了Android,且勾選了綁定簽名,則此項必填。

      • 綁定簽名後會提高安全性,可以避免License被同Package Name的應用盜用。

      • 新版本SDK支援免綁定簽名,包含:MediaBox音視頻SDK v1.7.0及以上版本、播放器SDK v5.5.2及以上版本、直播推流SDK v4.4.9及以上版本、短視頻SDK v3.36.0及以上版本。

      擷取Android應用簽名MD5值,您可以通過以下兩種方式:

      • 通過命令擷取:執行keytool -v -list -keystore your.keystore查看相應簽名的MD5值。

      • 通過AndroidStudio擷取:單擊右側側邊欄的Gradle,找到對應App的Tasks > android > signingReport擷取。通過此方式擷取到的MD5值,需要將字母轉換為小寫且去掉分號。image.png

步驟二:購買License

說明

如果您已購買License,請直接通過步驟三:綁定License完成License綁定。

  1. 返回我的授權頁面,選擇訂單一實例標籤頁,點擊License購買image

  2. 進入音視頻終端SDK購買頁,根據業務需求選擇SDK和對應的功能模組(SDK權益無法組合購買),確認無誤後進行購買。

    重要

    如圖所示,SDK權益僅支援單獨購買,例如可單獨購買播放器SDK標準版。image

  3. 支付成功後返回訂單一實例標籤頁,您可以看到新購買的訂單一實例。

步驟三:綁定License

  1. 返回我的授權頁面,選擇License管理標籤頁,點擊License綁定image

  2. 進入License綁定頁面,選擇您需要綁定的應用和對應的SDK License訂單,確認資訊無誤後,單擊綁定

    說明

    每個License訂單最多綁定一款應用,覆蓋Web端或者移動端。

    image

  3. 綁定成功後返回License管理標籤頁,您可以看到綁定成功的應用程式名稱和對應的授權資訊。

步驟四:擷取授權資訊

  1. License管理標籤頁,找到目標應用。image

  2. 確認授權資訊無誤後,單擊下載認證,將License認證檔案下載到本地,並儲存License Key,在後續接入應用時使用。配置License檔案的步驟請參見接入License

步驟五:整合MediaBox音視頻SDK並配置License授權

具體操作,請參見一體化SDK整合

步驟六:根據實際需求實現商務邏輯

更多資訊,請參見按模組整合