接入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ò)閱讀本文，您可以了解如何在Web、Android、iOS和HarmonyOS端接入License。
前提條件
已申請(qǐng)License，并獲取License文件和License Key。具體操作，請(qǐng)參見(jiàn)申請(qǐng)License。
鑒權(quán)流程
如上圖所示，音視頻終端SDK的License鑒權(quán)流程依賴(lài)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ō)明
| |||||
如有特殊原因不希望內(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)致用戶(hù)首次使用應(yīng)用需要等待證書(shū)下載完成才能通過(guò)鑒權(quán)（耗時(shí)取決于用戶(hù)當(dāng)時(shí)的網(wǎng)絡(luò)情況）。
播放器SDK服務(wù)環(huán)境
為了滿(mǎn)足全球化合規(guī)要求，阿里云播放器SDK（6.14.0及以上版本）為您提供了多樣化的環(huán)境選擇，確保服務(wù)的本地化和合規(guī)性。根據(jù)您所選擇的服務(wù)環(huán)境，播放器SDK的License鑒權(quán)以及播放器SDK所涉及的播放質(zhì)量服務(wù)數(shù)據(jù)將由相應(yīng)的服務(wù)中心提供支持。您可以根據(jù)自己的需求選擇以下服務(wù)環(huán)境。
請(qǐng)注意，目前阿里云中國(guó)站用戶(hù)支持使用全球環(huán)境和國(guó)際站環(huán)境（新加坡節(jié)點(diǎn)），您所使用的播放器SDK（6.14.0及以上）默認(rèn)設(shè)置為全球環(huán)境配置。
環(huán)境 | 說(shuō)明 | 使用建議 |
全球環(huán)境（默認(rèn)） | 通過(guò)阿里云中國(guó)上海節(jié)點(diǎn)提供服務(wù)，確保全球用戶(hù)的接入和授權(quán)需求得到滿(mǎn)足。 | 適用于中國(guó)內(nèi)地業(yè)務(wù)。 |
國(guó)際站環(huán)境 | 專(zhuān)為國(guó)際站用戶(hù)設(shè)計(jì)，通過(guò)新加坡節(jié)點(diǎn)提供服務(wù)，以滿(mǎn)足特定區(qū)域的合規(guī)性和性能要求。 | 適用于中國(guó)香港、中國(guó)澳門(mén)、中國(guó)臺(tái)灣及海外業(yè)務(wù)。 |
Web端接入License
從控制臺(tái)獲取License Key。
在初始化播放器時(shí)傳入license字段，包含注冊(cè)的域名和License Key：
var player = new Aliplayer({ license: { domain: "example.com", // 申請(qǐng) License 時(shí)填寫(xiě)的域名 key: "example-key" // 申請(qǐng)成功后，在控制臺(tái)可以看到 License Key } });初始化播放器后，如果沒(méi)有相關(guān)錯(cuò)誤提示，則表示License配置成功。
說(shuō)明請(qǐng)確保播放器所在頁(yè)面的域名和申請(qǐng)License時(shí)填寫(xiě)的域名保持一致，或者是填寫(xiě)域名的子域名，否則 License校驗(yàn)將會(huì)不通過(guò)（localhost 不會(huì)校驗(yàn)）。
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" }, ]