接入License
音視頻終端SDK License通過(guò)與應(yīng)用標(biāo)識(shí)一一綁定,以實(shí)現(xiàn)對(duì)該應(yīng)用調(diào)用SDK進(jìn)行授權(quán)。獲取SDK License后,需要在對(duì)應(yīng)的直播推流SDK、短視頻SDK、播放器SDK、美顏特效SDK中接入License以完成SDK的授權(quán)流程。通過(guò)閱讀本文,您可以了解如何在Android和iOS端接入License。
前提條件
已申請(qǐng)License,并獲取License文件和License Key。具體操作,請(qǐng)參見(jiàn)申請(qǐng)License。
鑒權(quán)流程
如上圖所示,音視頻終端SDK的License鑒權(quán)流程依賴LicenseKey與License文件,配置要求如下:
項(xiàng)目 | 是否必須 | 說(shuō)明 | |||||
LicenseKey | 是 | 用于請(qǐng)求更新License文件。 SDK初始化時(shí)會(huì)檢查更新證書(shū)文件,在程序運(yùn)行時(shí)也會(huì)每隔15分鐘檢查更新證書(shū)文件。 | |||||
License文件 | 否,建議配置 | 用于當(dāng)未能從服務(wù)端成功請(qǐng)求到證書(shū)時(shí)鑒權(quán)使用的證書(shū)文件,例如由于網(wǎng)絡(luò)問(wèn)題導(dǎo)致無(wú)法下載證書(shū)等極端場(chǎng)景。 證書(shū)文件內(nèi)容包含了開(kāi)通的權(quán)限以及有效期。因此,為了在弱網(wǎng)絡(luò)環(huán)境下提高鑒權(quán)通過(guò)率,建議在權(quán)限發(fā)生變化時(shí)主動(dòng)更新內(nèi)置證書(shū)文件。 說(shuō)明 權(quán)限發(fā)生變化一般指新開(kāi)通業(yè)務(wù)、新開(kāi)通增值服務(wù)、續(xù)費(fèi)等。 |
如有特殊原因不希望內(nèi)置License文件時(shí),不填寫(xiě)LicenseFile相關(guān)配置即可(具體參考下文)。
不配置內(nèi)置證書(shū)文件意味著鑒權(quán)依據(jù)全部來(lái)源于服務(wù)端,這樣可能會(huì)因?yàn)榫W(wǎng)絡(luò)不穩(wěn)定而導(dǎo)致鑒權(quán)不穩(wěn)定;也可能導(dǎo)致用戶首次使用應(yīng)用需要等待證書(shū)下載完成才能通過(guò)鑒權(quán)(耗時(shí)取決于用戶當(dāng)時(shí)的網(wǎng)絡(luò)情況)。
Android端接入License
(推薦)將證書(shū)文件拷貝到Android Studio項(xiàng)目中的assets目錄下。
說(shuō)明您也可以將證書(shū)文件復(fù)制到設(shè)備中的其他位置,但要保證第2步中
com.aliyun.alivc_license.licensefile
對(duì)應(yīng)的value的值和License的路徑保持一致。在AndroidManifest.xml文件中添加<meta-data>節(jié)點(diǎn)。
重要若配置License后校驗(yàn)失敗,您可以檢查<meta-data>節(jié)點(diǎn)是否處于<application>元素下面,且<meta-data>的name是否正確。若未能解決問(wèn)題,您可以參考License相關(guān)常見(jiàn)問(wèn)題進(jìn)行排查。
<meta-data android:name="com.aliyun.alivc_license.licensekey" android:value="foIVziMaUHaRqgDyhf6b6eb8fcf014af39535d0720a32****"/> <!-- TODO:請(qǐng)?jiān)O(shè)置您的 LicenseKey值--> <meta-data android:name="com.aliyun.alivc_license.licensefile" android:value="assets/cert/release.crt"/> <!-- TODO:請(qǐng)?jiān)O(shè)置您的 LicenseFile文件路徑-->
iOS端接入License
將License文件復(fù)制到Xcode項(xiàng)目中指定目錄,并在Target Membership中選中當(dāng)前項(xiàng)目。
打開(kāi)Info.plist,分別修改AlivcLicenseKey和AlivcLicenseFile為申請(qǐng)License時(shí)獲取的License Key和License文件路徑。
HarmonyOS端接入License
將獲取到的License證書(shū)文件拷貝到DevEco Studio項(xiàng)目中,建議放到rawfile目錄下。
在module.json5文件中添加如下字段。
key為
com.aliyun.alivc_license.licensekey
(全小寫(xiě)),value為L(zhǎng)icenseKey的值。key為
com.aliyun.alivc_license.licensefile
(全小寫(xiě)),value為步驟1中證書(shū)文件的放置路徑,請(qǐng)根據(jù)實(shí)際情況填寫(xiě)。"metadata": [ { "name": "com.aliyun.alivc_license.licensekey", "value": "********" }, { "name": "com.aliyun.alivc_license.licensefile", "value": "license.crt" }, ]