通過閱讀本文,您可以瞭解申請、續約、使用或修改License綁定應用資訊等過程中的常見問題及解決方案。
Web端播放器License報錯
問題現象:使用Web端播放器時,出現License報錯。
解決方案:Web播放器SDK2.28.0及之後版本的整合使用需要接入License服務,且新購License訂單不相容舊版Web播放器SDK。為了不影響您的使用請接入2.29.1及以上版本,如果您尚未購買Web播放器SDK License,請通過MediaBox音視頻SDK新購License訂單,購買後重新進行License綁定。
移動端播放器License報錯
問題現象:使用7.0.0及之後版本的移動端播放器時,出現如下類似“License verify premium func:abr”報錯。

解決方案:移動端播放器SDK7.0.0及之後版本對播放器功能進行了劃分,如需要使用進階ABR策略等專業版功能,請購買專業版License並綁定,詳情請參見擷取播放器SDK License。
如何查看License到期時間並續約
一:查看License有效日期
登入ApsaraVideo for VOD控制台。
在左側導覽列選擇。
選擇License管理標籤頁,找到對應應用下綁定的License訂單,並在有效日期欄查看License到期時間。

二:License續期
License續期的詳細資料請參見License續期。
如果您收到簡訊通知的License到期時間與控制台有效日期不符,是由於歷史原因後台曾手動延長了有效期間。請以控制台有效日期為準,忽略費用與成本中資源續訂裡的到期提示,並建議關閉自動續訂功能。
如果您的歷史License訂單為多個SDK功能組合套餐,續期時需要對整體License訂單進行續期,無法單獨進行續約。續期有兩種方式:
如果License訂單存在執行個體ID,則可以點擊操作欄的續期按鈕進行續期。

如果License訂單一實例ID為空白,則無法通過續期按鈕進行續期。您需要通過MediaBox音視頻SDK新購License訂單,購買後重新進行License綁定。
License報錯時,如何進行自主排查
當您接入License失敗或報錯時,可參考如下方法進行自主排查:
檢查ApsaraVideo for VOD或ApsaraVideo for Live控制台上建立的License授權配置是否正確
登入ApsaraVideo for VOD控制台。
在左側導覽列選擇。
點擊應用管理標籤頁找到目標應用,單擊詳情,展示應用基礎資訊和已綁定License。
檢查如下資訊是否正確。
應用基礎資訊:應用標識符(Package Name等)、包簽名(建議不綁定包簽名)
已綁定License資訊:SDK版本、授與類型、有效日期、狀態和增值服務

檢查接入到專案中的License配置是否正確,與控制台上建立的License資訊是否一致
Web:主要檢查初始化播放器時的
license欄位配置domain:您播放器所在頁面的網域名稱是否與申請License時填寫的網域名稱一致,或者是填寫網域名稱的子網域名稱。
key:License Key的值是否與您控制台上展示的一致。
Android:主要檢查
AndroidManifest.xml配置LicenseKey:
com.aliyun.alivc_license.licensekey的值是否與您控制台上展示的一致。認證檔案:
com.aliyun.alivc_license.licensefile的值是否與您認證檔案存放的路徑一致。包ID:
build.gradle的applicationId是否與您控制台上的Package Name一致。包簽名:如果您在控制台上建立License時已綁定了簽名,則需確保專案中配置的簽名與控制台上綁定的簽名一致。您可以通過如下命令查詢您的包簽名:
keytool -v -list -keystore your.keystore。
iOS:主要檢查
Info.plist配置BundleId:
CFBundleIdentifier的值是否與您控制台配置的Bundle ID一致。LicenseKey:
AlivcLicenseKey的值是否與您控制台上展示的一致。認證檔案:
AlivcLicenseFile的值是否與您ipa包內的認證檔案路徑一致。
HarmonyOS:主要檢查
module.json5配置BundleId:
app.json5的bundleName是否與您控制台配置的鴻蒙BundleID一致。LicenseKey:
com.aliyun.alivc_license.licensekey的值是否與您控制台上展示的一致。認證檔案:
com.aliyun.alivc_license.licensefile的值是否與您hap包內的認證檔案路徑一致。
新購買License並授權後是否需要更新License檔案及Key
License檔案:推薦更新,續期後License檔案的有效期間會更新,因此整合更新後的License檔案可以提高鑒權成功率;線上發行App整合了歷史License檔案一般不影響使用。
License Key:保持不變,License Key與UID一一對應。
如何修改應用ID
如果您的應用資訊發生變化,可以在控制台上修改應用資訊。
修改應用的標識符(Package Name等)將導致原有標識符對應的應用鑒權失敗,需要重新下載License檔案認證進行替換,請謹慎操作。
登入ApsaraVideo for VOD控制台。
在左側導覽列選擇。
點擊應用管理標籤頁找到目標應用,確認無誤後單擊編輯。
您可以修改應用程式名稱、平台、Android應用簽名MD5值及應用標識符(Package Name等)資訊。
確認無誤後單擊修改,完成License修改。
Android端應用修改簽名MD5
整合方需謹慎修改簽名MD5,避免線上故障。整合方App使用MediaBox音視頻SDK需要配置License檔案和Key,如果修改授權配置(例如簽名MD5),可能會造成發行App版本搭載的SDK校正授權不通過,導致功能異常。常見情況如下:
將Android端應用的簽名MD5由A修改為B,會造成配置了“簽名MD5=A”的App功能異常。此時,推薦單獨建立一款應用,採用相同包名+“簽名MD5=B”,用於新版本使用。
取消選中綁定簽名專案,會造成低版本的SDK無法通過授權校正。如果整合方App曾經使用以下SDK版本,則不建議取消綁定簽名:
MediaBox音視頻SDK:v1.6.0及以下版本
播放器SDK:v5.5.1.0及以下版本
推流SDK:v4.4.8及以下版本
短視頻SDK:v3.35.0及其以下版本
如何修改授權模組、版本及功能點
目前控制台暫不支援變更配置,如果您有新增SDK模組、修改原有SDK模組版本或功能點的需求,請提交工單。