推流SDK需要SDK License授權才可以正常推流。本文為您介紹推流SDK License的獲取以及集成方式。
注意事項
一體化License可為同一個阿里云賬號下的所有APP提供視頻云SDK的接入授權。目前推流SDK已接入一體化License服務。
當您同時申請視頻直播推流SDK License和視頻云一體化License其他服務時(例如美顏特效SDK License),LicenseKey和LicenseFile(證書文件)是相同的,只需配置一次即可(注意證書文件需使用最新的一份)。
說明如果您之前僅申請了視頻云一體化License服務中的其他License(例如美顏特效SDK License),后續(xù)使用推流SDK時,可以將您需要的SDK權限(即應用信息)發(fā)送申請至創(chuàng)建應用并綁定License,訂正License的授權范圍。否則,推流SDK會校驗失敗。
僅訂正License的授權范圍,LicenseKey和LicenseFile不變,您不需要重新配置License,但在使用推流功能前必須注冊推流SDK。
申請License授權
視頻直播服務提供直播推流SDK、美顏特效SDK、播放器SDK的License統(tǒng)一授權管理,您可以在視頻直播控制臺創(chuàng)建應用并綁定License授權,授權成功后,您可以獲取到License和License Key文件。具體操作,請參見我的授權。
配置License
在視頻直播控制臺創(chuàng)建應用并綁定License授權成功后,可以獲取到License和License Key文件。您需要按照以下操作配置License。
Android端配置License
(推薦)將License文件復制到Android Studio項目中的assets目錄下。
說明您也可以將License文件復制到其他位置,但須確保步驟2中
com.aliyun.alivc_license.licensefile
對應的value值和License文件的路徑一致。在AndroidManifest.xml文件中添加<meta-data>節(jié)點。
重要若配置License后校驗失敗,您可以檢查<meta-data>節(jié)點是否處于<application>元素下面,且<meta-data>的name是否正確。
<meta-data android:name="com.aliyun.alivc_license.licensekey" android:value="foIVziMaUHaRqgDyhf6b6eb8fcf014af39535d0720a32****"/> <!-- TODO:請設置您的 LicenseKey值--> <meta-data android:name="com.aliyun.alivc_license.licensefile" android:value="assets/cert/release.crt"/> <!-- TODO:請設置您的 LicenseFile文件路徑-->
iOS端配置License
將License文件復制到Xcode項目中指定目錄,并在Target Membership中選中當前項目。
打開Info.plist,分別修改AlivcLicenseKey和AlivcLicenseFile為申請License時獲取的License Key和License文件路徑。
注冊推流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注冊。
在AlivcLiveBase#setListener接口的onLicenceCheck方法,異步判斷License是否配置成功。
該回調僅在初始化pusher實例后觸發(fā)。
iOS端注冊SDK
請在較早的位置(使用推流SDK前)調用注冊License接口
[AlivcLiveBase registerSDK];
通過AlivcLiveBase類,可以設置日志級別、設置本地日志路徑、獲取SDK版本等。
在AlivcLiveBase#setObserver接口的onLicenceCheck方法,異步判斷Licence是否配置成功。