License報錯時，如何進(jìn)行自主排查

當(dāng)您接入License失敗或報錯時，可參考如下方法進(jìn)行自主排查：

• 檢查視頻點播或視頻直播控制臺上創(chuàng)建的License授權(quán)配置是否正確

  1. 登錄視頻直播或視頻點播控制臺。

  2. 在左側(cè)導(dǎo)航欄選擇SDK管理 > 我的授權(quán)。

  3. 點擊應(yīng)用管理標(biāo)簽頁找到目標(biāo)應(yīng)用，單擊詳情，展示應(yīng)用基礎(chǔ)信息和已綁定License。

  4. 檢查如下信息是否正確。

     • 應(yīng)用基礎(chǔ)信息：應(yīng)用標(biāo)識符（Package Name等）、包簽名（建議不綁定包簽名）

     • 已綁定License信息：SDK版本、授權(quán)類型、有效日期、狀態(tài)和增值服務(wù)

     

• 檢查接入到項目中的License配置是否正確，與控制臺上創(chuàng)建的License信息是否一致

  • Android：主要檢查AndroidManifest.xml配置

    • LicenseKey：com.aliyun.alivc_license.licensekey的值是否與您控制臺上展示的一致。

    • 證書文件：com.aliyun.alivc_license.licensefile的值是否與您證書文件存放的路徑一致。

    • 包ID：build.gradle的applicationId是否與您控制臺上的Package Name一致。

    • 包簽名：如果您在控制臺上創(chuàng)建License時已綁定了簽名，則需確保項目中配置的簽名與控制臺上綁定的簽名一致。您可以通過如下命令查詢您的包簽名：keytool -v -list -keystore your.keystore。

  • iOS：主要檢查Info.plist配置

    • BundleId：CFBundleIdentifier的值是否與您控制臺配置的Bundle ID一致。

    • LicenseKey：AlivcLicenseKey的值是否與您控制臺上展示的一致。

    • 證書文件：AlivcLicenseFile的值是否與您ipa包內(nèi)的證書文件路徑一致。

  • HarmonyOS：主要檢查module.json5配置

    • BundleId：app.json5的bundleName是否與您控制臺配置的鴻蒙BundleID一致。

    • LicenseKey：com.aliyun.alivc_license.licensekey的值是否與您控制臺上展示的一致。

    • 證書文件：com.aliyun.alivc_license.licensefile的值是否與您hap包內(nèi)的證書文件路徑一致。

報錯“無權(quán)限執(zhí)行該操作”或“您沒有權(quán)限操作此頁面”

使用RAM用戶登錄控制臺時，需要對控制臺指引，否則會產(chǎn)生以下報錯：

• 未授予任何權(quán)限，在訪問視頻直播或視頻點播控制臺時會產(chǎn)生如下錯誤：

• 未授予在費用中心（BSS）查看訂單、支付訂單及取消訂單的權(quán)限，會產(chǎn)生如下報錯：

如何申請贈送SDK License

如果您在視頻直播、視頻點播等產(chǎn)品消費達(dá)標(biāo)即可獲贈SDK License使用權(quán)1年，可提交表單申請。

新購買License并授權(quán)后是否需要更新License文件及Key

• License文件：推薦更新，續(xù)期后License文件的有效期會更新，因此集成更新后的License文件可以提高鑒權(quán)成功率；線上已發(fā)布App集成了歷史License文件一般不影響使用。

• License Key：保持不變，License Key與UID一一對應(yīng)。

如何修改應(yīng)用ID

如果您的應(yīng)用信息發(fā)生變化，可以在控制臺上修改應(yīng)用信息。

1. 登錄視頻直播或視頻點播控制臺。

2. 在左側(cè)導(dǎo)航欄選擇SDK管理 > 我的授權(quán)。

3. 點擊應(yīng)用管理標(biāo)簽頁找到目標(biāo)應(yīng)用，確認(rèn)無誤后單擊編輯。

4. 您可以修改應(yīng)用標(biāo)題、平臺、Android應(yīng)用簽名MD5值及應(yīng)用標(biāo)識符（Package Name等）信息。

5. 確認(rèn)無誤后單擊更改，完成License修改。

Android端應(yīng)用修改簽名MD5

集成方需謹(jǐn)慎修改簽名MD5，避免線上故障。集成方App使用MediaBox音視頻SDK需要配置License文件和Key，如果修改授權(quán)配置（例如簽名MD5），可能會造成已發(fā)布App版本搭載的SDK校驗授權(quán)不通過，導(dǎo)致功能異常。常見情況如下：

• 將Android端應(yīng)用的簽名MD5由A修改為B，會造成配置了“簽名MD5=A”的App功能異常。此時，推薦單獨創(chuàng)建一款應(yīng)用，采用相同包名+“簽名MD5=B”，用于新版本使用。

• 取消選中綁定簽名項目，會造成低版本的SDK無法通過授權(quán)校驗。如果集成方App曾經(jīng)使用以下SDK版本，則不建議取消綁定簽名：

  • MediaBox音視頻SDK：v1.6.0及以下版本

  • 播放器SDK：v5.5.1.0及以下版本

  • 推流SDK：v4.4.8及以下版本

  • 短視頻SDK：v3.35.0及其以下版本

如何修改授權(quán)模塊、版本及功能點

目前控制臺暫不支持變配，如果您有新增SDK模塊、修改原有SDK模塊版本或功能點的需求，請提交表單。

配置License后校驗失敗并報錯“l(fā)icense authorization failed”或“l(fā)icense is invalid”

配置License后，提示license authorization failed或license is invalid相關(guān)報錯信息時，您可以參考下述原因進(jìn)行排查：

• 檢查創(chuàng)建License時，所設(shè)置的包名及簽名（Android應(yīng)用）、Bundle ID（iOS應(yīng)用）等信息是否正確。

  其中，Android應(yīng)用的簽名可以通過如下方式獲取：

  • 通過命令獲取：執(zhí)行keytool -v -list -keystore your.keystore查看相應(yīng)簽名的MD5值。

  • 通過AndroidStudio獲取：單擊右側(cè)側(cè)邊欄的Gradle，找到對應(yīng)App的Tasks > android > signingReport獲取。通過此方式獲取到的MD5值，需要將字母轉(zhuǎn)換為小寫且去掉分號。

• 檢查獲取的License授權(quán)與實際需要使用的SDK功能及版本等是否匹配。

  例如：實際需要使用短視頻和播放器的功能，但卻僅申請了短視頻SDK的授權(quán)，未申請播放器SDK的授權(quán)；實際需要使用專業(yè)版短視頻SDK的功能，卻僅獲得了基礎(chǔ)版短視頻SDK的授權(quán)；實際需要使用播放器SDK的端側(cè)超分等增值功能，卻僅獲得了標(biāo)準(zhǔn)版播放器SDK的授權(quán)，未獲得增值功能的授權(quán)等。

• 檢查License的配置是否正確。

  其中，Android應(yīng)用的配置，請檢查meta-data信息配置是否正確。您可以檢查AndroidManifest.xml文件中添加的<meta-data>節(jié)點是否處于<application>元素下面，且<meta-data>的name是否正確。