文档

接入License

更新时间:

音视频终端SDK License通过与应用标识一一绑定,以实现对该应用调用SDK进行授权。获取SDK License后,需要在对应的直播推流SDK、短视频SDK、播放器SDK、美颜特效SDK中接入License以完成SDK的授权流程。通过阅读本文,您可以了解如何在Android和iOS端接入License。

前提条件

已申请License,并获取License文件和License Key。具体操作,请参见申请License

鉴权流程

image

如上图所示,音视频终端SDK的License鉴权流程依赖LicenseKey与License文件,配置要求如下:

项目

是否必须

说明

LicenseKey

用于请求更新License文件。

SDK初始化时会检查更新证书文件,在程序运行时也会每隔15分钟检查更新证书文件。

License文件

否,建议配置

用于当未能从服务端成功请求到证书时鉴权使用的证书文件,例如由于网络问题导致无法下载证书等极端场景。

证书文件内容包含了开通的权限以及有效期。因此,为了在弱网络环境下提高鉴权通过率,建议在权限发生变化时主动更新内置证书文件。

说明

权限发生变化一般指新开通业务、新开通增值服务、续费等。

如有特殊原因不希望内置License文件时,不填写LicenseFile相关配置即可(具体参考下文)。

说明

不配置内置证书文件意味着鉴权依据全部来源于服务端,这样可能会因为网络不稳定而导致鉴权不稳定;也可能导致用户首次使用应用需要等待证书下载完成才能通过鉴权(耗时取决于用户当时的网络情况)。

Android端接入License

  1. (推荐)将证书文件拷贝到Android Studio项目中的assets目录下。

    说明

    您也可以将证书文件复制到设备中的其他位置,但要保证第2步中com.aliyun.alivc_license.licensefile对应的value的值和License的路径保持一致。

  2. 在AndroidManifest.xml文件中添加<meta-data>节点。

    重要

    若配置License后校验失败,您可以检查<meta-data>节点是否处于<application>元素下面,且<meta-data>的name是否正确。

    image.png

    <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

  1. 将License文件复制到Xcode项目中指定目录,并在Target Membership中选中当前项目。

    image.png

  2. 打开Info.plist,分别修改AlivcLicenseKeyAlivcLicenseFile申请License时获取的License Key和License文件路径。

  • 本页导读 (1)
文档反馈