推流SDK License的擷取與整合方式 - ApsaraVideo Live

推流SDK升級到4.4.2及以上版本時，需要使用SDK License進行授權才可以使用。本文為您介紹推流SDK License的擷取以及整合方式。

注意事項

推流SDK 4.4.2以前的版本暫時無需License服務。當升級到4.4.2及以上版本，需要經License授權後才可以正常推流。
一體化License可為同一個阿里雲帳號下的所有APP提供視頻雲SDK的接入授權。推流SDK從4.4.2版本開始，接入一體化License服務。
當您同時申請ApsaraVideo for Live推流SDK License和視頻雲一體化License其他服務時（例如美顏特效SDK License），LicenseKey和LicenseFile（認證檔案）是相同的，只需配置一次即可（注意認證檔案需使用最新的一份）。
說明
如果您之前僅申請了視頻雲一體化License服務中的其他License（例如美顏特效SDK License），後續使用推流SDK時，可以將您需要的SDK許可權（即應用資訊）發送申請至建立應用並綁定License，訂正License的授權範圍。否則，推流SDK會校正失敗。
僅訂正License的授權範圍，LicenseKey和LicenseFile不變，您不需要重新設定License，但在使用推流功能前必須註冊推流SDK。

申請License授權

請單擊推流SDK授權申請，填寫對應資訊，申請推流SDK License授權。收到申請後，我們將於2個工作日之內處理完開通申請。

說明

推流SDK License免費提供。申請一次有效期間為1年，到期後需重新申請。
請確保申請資訊齊全、格式規範，後續若有需要更換包名、簽名檔案或BundleID任意一項，需重新申請。
如沒有阿里雲帳號，請提前註冊。註冊步驟請參見註冊阿里雲帳號。
Android平台應用程式套件名和簽名資訊（MD5）要求：
- 要求：MD5格式小寫、無冒號。
- 包名和簽名資訊（MD5）擷取：
  方法一：可使用簽名擷取工具來擷取包名和簽名資訊，安裝後按工具中的提示操作。
  方法二：可通過在SDK下載與發布記錄下載的4.4.2及以後版本Android Demo源碼中的SignatureUtils工具類，使用getSingInfo方法產生signature（即簽名資訊）。

配置License

申請License後，LicenseKey和LicenseFile會通過授權郵件發送給您，擷取推流SDK License檔案後，您需要按照以下操作配置License檔案。

Android端配置License

將擷取到的LicenseFile檔案預置到assets目錄下。

在AndroidManifest.xml中配置LicenseKey和LicenseFile，樣本如下，將設定檔中的Your licenseKey和Your licenseFile.crt替換成您實際擷取的值。

<application>

    <!-- android:name: 中繼資料項名字，固定取值 -->
    <!-- android:value: 中繼資料項指定值，請填入您郵件擷取到的LicenseKey -->
    <meta-data
        android:name="com.aliyun.alivc_license.licensekey"
        android:value="Your licenseKey" />

    <!-- android:name: 中繼資料項名字，固定取值 -->
    <!-- android:value: 中繼資料項指定值，請填入您郵件擷取到的LicenseFile所在的assets路徑 -->
    <meta-data
        android:name="com.aliyun.alivc_license.licensefile"
        android:value="assets/Your licenseFile.crt" />

</application>

重要

如配置License後校正失敗，您可以檢查上述<meta-data>節點是否處於<application>元素下面，且<meta-data>的name是否正確。

iOS端配置License

將擷取到的License檔案匯入到APP工程。
在Info.plist檔案中添加兩個key：
- 第一個key為AlivcLicenseKey，value為LicenseKey的值。
- 第二個key為AlivcLicenseFile，value為內建認證檔案（相對於mainBundle）的路徑。
key
value
AlivcLicenseKey
LicenseKey的值，取值樣本：MoCTfuQ391Z01mNqG8f8745e23c8a457a8ff8d5faedc1****。
AlivcLicenseFile
內建認證檔案（相對於mainBundle）的路徑。

註冊推流SDK

在使用推流功能前必須進行註冊，否則無法使用推流SDK功能。註冊SDK之前，需要先完成配置License操作。

Android端註冊SDK

請在較早的位置（使用推流SDK前）調用註冊License介面：

AlivcLiveBase.setListener(new AlivcLiveBaseListener() {
  @Override
  public void onLicenceCheck(AlivcLivePushConstants.AlivcLiveLicenseCheckResultCode result, String reason) {
    Log.e(TAG, "onLicenceCheck: " + result + ", " + reason);
  }
});
AlivcLiveBase.registerSDK();

通過AlivcLiveBase類，可以設定記錄層級、設定本地日誌路徑、擷取SDK版本等。

接入方需要調用AlivcLiveBase中的registerSDK方法，進行SDK License註冊；並監控AlivcLiveBaseListener中的onLicenceCheck方法，非同步接收License鑒權結果回調，確定提供的LicenseKey和LicenseFile是否校正通過。

說明

該回調僅在初始化pusher執行個體後觸發。

iOS端註冊SDK

請在較早的位置（使用推流SDK前）調用註冊License介面：

[AlivcLiveBase registerSDK];

通過AlivcLiveBase類，可以設定記錄層級、設定本地日誌路徑、擷取SDK版本等。

接入方需要監控License回調AlivcLiveBaseObserver中的onLicenceCheck方法，確定提供的LicenseKey和LicenseFile是否校正通過。

key	value
AlivcLicenseKey	LicenseKey的值，取值樣本：`MoCTfuQ391Z01mNqG8f8745e23c8a457a8ff8d5faedc1****`。
AlivcLicenseFile	內建認證檔案（相對於mainBundle）的路徑。