音视频终端SDK License通过与应用标识一一绑定,以实现对该应用调用SDK进行授权。获取SDK License后,需要在对应的直播推流SDK、短视频SDK、播放器SDK、美颜特效SDK中接入License以完成SDK的授权流程。通过阅读本文,您可以了解如何在Android和iOS端接入License。
前提条件
已申请License,并获取License文件和License Key。具体操作,请参见申请License。
鉴权流程
如上图所示,音视频终端SDK的License鉴权流程依赖LicenseKey与License文件,配置要求如下:
项目 | 是否必须 | 说明 | |||||
LicenseKey | 是 | 用于请求更新License文件。 SDK初始化时会检查更新证书文件,在程序运行时也会每隔15分钟检查更新证书文件。 | |||||
License文件 | 否,建议配置 | 用于当未能从服务端成功请求到证书时鉴权使用的证书文件,例如由于网络问题导致无法下载证书等极端场景。 证书文件内容包含了开通的权限以及有效期。因此,为了在弱网络环境下提高鉴权通过率,建议在权限发生变化时主动更新内置证书文件。 说明 权限发生变化一般指新开通业务、新开通增值服务、续费等。 |
如有特殊原因不希望内置License文件时,不填写LicenseFile相关配置即可(具体参考下文)。
不配置内置证书文件意味着鉴权依据全部来源于服务端,这样可能会因为网络不稳定而导致鉴权不稳定;也可能导致用户首次使用应用需要等待证书下载完成才能通过鉴权(耗时取决于用户当时的网络情况)。
Android端接入License
(推荐)将证书文件拷贝到Android Studio项目中的assets目录下。
说明您也可以将证书文件复制到设备中的其他位置,但要保证第2步中
com.aliyun.alivc_license.licensefile
对应的value的值和License的路径保持一致。在AndroidManifest.xml文件中添加<meta-data>节点。
重要若配置License后校验失败,您可以检查<meta-data>节点是否处于<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文件路径。
- 本页导读 (1)