接入License

接入License

前提条件已申请License,并获取License文件和License Key。具体操作,请参见管理License。

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

项目

是否必须

说明

LicenseKey

用于请求更新License文件。

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

License文件

否,建议配置

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

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

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

Web端不需要配置License文件。

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

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

播放器SDK服务环境为了满足全球化合规要求,阿里云播放器SDK(6.14.0及以上版本)为您提供了多样化的环境选择,确保服务的本地化和合规性。根据您所选择的服务环境,播放器SDK的License鉴权以及播放器SDK所涉及的播放质量服务数据将由相应的服务中心提供支持。您可以根据自己的需求选择以下服务环境。

请注意,目前阿里云中国站用户支持使用中国内地及港澳台环境和全球(不包含中国内地及港澳台)环境(新加坡节点),您所使用的播放器SDK(6.14.0及以上)默认设置为中国站环境配置。

环境

说明

中国内地及港澳台

中国站环境(默认)。通过阿里云中国上海节点提供服务,确保中国内地及中国香港、中国澳门和中国台湾用户的接入和授权需求得到满足。

全球(不包含中国内地及港澳台)

国际站环境。专为国际站用户设计,通过新加坡节点提供服务,以满足特定区域的合规性和性能要求。

视频教程以播放器SDK接入License为例。

AndroidiOSFlutterHarmonyOSWeb端接入License从控制台获取License Key。

在初始化播放器时传入license字段,包含注册的域名和License Key:

var player = new Aliplayer({

license: {

domain: "example.com", // 申请 License 时填写的域名

key: "example-key" // 申请成功后,在控制台可以看到 License Key

}

});初始化播放器后,如果没有相关错误提示,则表示License配置成功。

说明 请确保播放器所在页面的域名和申请License时填写的域名保持一致,或者是填写域名的子域名,否则 License校验将会不通过。

Android端接入License配置License。

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

说明 您也可以将证书文件复制到设备中的其他位置,但要保证下一步中com.aliyun.alivc_license.licensefile(中国内地及港澳台)或com.aliyun.alivc_license.licensefile_SEA(全球(不包含中国内地及港澳台))对应的value的值和License的路径保持一致。

在AndroidManifest.xml文件中添加节点。

重要 若配置License后校验失败,您可以检查节点是否处于元素下面,且的name是否正确。若未能解决问题,您可以参考License相关常见问题进行排查。

针对国际站用户,若需使用播放器SDK,且播放器SDK为6.14.0及以上版本,请务必配置全球(不包含中国内地及港澳台)环境License;若不使用播放器SDK,可以仅配置中国内地及港澳台环境License。

您可以同时接入2套License(1套全球(不包含中国内地及港澳台)环境License,1套中国内地及港澳台环境License),后续在App每次启动后,通过配置播放器SDK的服务环境,来指定播放器的运行环境。播放器运行过程中,不支持切换环境。

//中国内地及港澳台配置License(默认中国站配置)

android:name="com.aliyun.alivc_license.licensekey"

android:value="foIVziMaUHaRqgDyhf6b6eb8fcf014af39535d0720a32****"/>

android:name="com.aliyun.alivc_license.licensefile"

android:value="assets/cert/release.crt"/>

// 全球(不包含中国内地及港澳台)配置License,手动在未端添加_SEA

android:name="com.aliyun.alivc_license.licensekey_SEA"

android:value="f6b6foIVziMaUHaRqgDyheb8fcf014af39535d0a32720****"/>

android:name="com.aliyun.alivc_license.licensefile_SEA"

android:value="assets/cert/release.crt"/> 配置播放器SDK的服务环境(使用全球(不包含中国内地及港澳台)环境必配)。

播放器SDK自6.14.0版本开始支持选择服务环境,6.14.0及以上版本的播放器SDK默认为中国内地及港澳台环境配置,如需使用全球(不包含中国内地及港澳台)环境(目前国际站用户仅支持使用全球(不包含中国内地及港澳台)环境),则需选择以下一种方式,将播放器SDK配置更新为国际站环境,否则播放器SDK的License会鉴权失败;其他版本及SDK的使用场景下,可忽略此步骤。

方式一:调用下述接口更新默认配置为国际站环境。

// 使用全球(不包含中国内地及港澳台)环境时,请确保在调用任何播放器API之前,已调用下述接口更新默认配置为国际站环境,以确保后续所有业务都是在国际站环境下运行

// 通过AlivcBase统一接口,设置国际站环境,运行期间不支持修改

AlivcBase.getEnvironmentManager().setGlobalEnvironment(AlivcEnv.GlobalEnv.ENV_SEA);方式二(推荐):V7.6.0及以上播放器版本进行配置时,可通过XML方法配置国际站环境。

在AndroidManifest.xml文件中添加节点。

android:name="com.aliyun.alivc_env"

android:value="SEA"/> 配置示例如下:

iOS端接入License配置License。

在Xcode工程里,将获取到的证书文件AliVideoCert-********.crt拷贝到Xcode的项目中,建议放到AppSupportFiles目录下,也可以放到沙箱或者其他路径。并在Target Membership中选中当前项目。

打开Info.plist,分别修改AlivcLicenseKey、AlivcLicenseFile(中国内地及港澳台环境)或AlivcLicenseKey_SEA、AlivcLicenseFile_SEA(全球(不包含中国内地及港澳台)环境)为管理License时获取的License Key和License文件路径。

重要 针对国际站用户,若需使用播放器SDK,且播放器SDK为6.14.0及以上版本,请务必配置全球(不包含中国内地及港澳台)环境License;若不使用播放器SDK,可以仅配置中国内地及港澳台环境License。

您可以同时接入2套License(1套全球(不包含中国内地及港澳台)环境License,1套中国内地及港澳台环境License),后续在每次App启动后,通过配置播放器的服务环境,来指定播放器的运行环境。播放器运行过程中,不支持切换环境。

//中国内地及港澳台配置License(默认配置)

AlivcLicenseFile

XXX

AlivcLicenseKey

foIVziMaUHaRqgDyhf6b6eb8fcf014af39535d0720a32****

// 全球(不包含中国内地及港澳台)配置License,手动在未端添加_SEA

AlivcLicenseFile_SEA

XXX

AlivcLicenseKey_SEA

f6b6efoIVziMaUHaRqgDyhb8fcf014af39535d0a32072****配置播放器SDK的服务环境(使用全球(不包含中国内地及港澳台)环境必配)。

播放器SDK自6.14.0版本开始支持选择服务环境,6.14.0及以上版本的播放器SDK默认为中国内地及港澳台环境配置。如需使用全球(不包含中国内地及港澳台)环境(目前国际站用户仅支持使用全球(不包含中国内地及港澳台)环境),则需选择以下一种方式,将播放器SDK配置更新为国际站环境,否则播放器SDK的License会鉴权失败;其他版本及SDK的使用场景下,可忽略此步骤。

方式一:调用下述接口更新默认配置为国际站环境。

// 使用全球(不包含中国内地及港澳台)环境时,请确保在调用任何播放器API之前,已调用下述接口更新默认配置为国际站环境,以确保后续所有业务都是在国际站环境下运行

// 通过AlivcBase统一接口,设置国际站环境,运行期间不支持修改

AlivcBase.EnvironmentManager.globalEnvironment = ENV_SEA;方式二(推荐):V7.6.0及以上播放器版本进行配置时,可通过Info.Plist方法配置国际站环境。

打开Info.plist文件,修改AlivcEnv为SEA。

//配置当前环境为国际站环境

AlivcEnv

SEA配置示例如下:

Flutter端接入LicenseFlutter是由Google开发的一套基于多平台的跨端解决方案。因此,Flutter端需要同时接入多端License,或者根据您的业务场景来接入对应的License。详情请参见Android端接入或iOS端接入。

HarmonyOS端接入License将获取到的License证书文件拷贝到DevEco Studio项目中,建议放到rawfile目录下。

在module.json5文件中添加如下字段。

key为com.aliyun.alivc_license.licensekey(全小写),value为LicenseKey的值。

key为com.aliyun.alivc_license.licensefile(全小写),value为步骤1中证书文件的放置路径,请根据实际情况填写。

"metadata": [

{

"name": "com.aliyun.alivc_license.licensekey",

"value": "********"

},

{

"name": "com.aliyun.alivc_license.licensefile",

"value": "license.crt"

},

]

相关推荐

重要时刻!泸州富贵48度酒多少钱,市场价格是多少,购买渠道有哪些选择
Sibyl, Sybil的英文名含义读音来源寓意介绍
bat365官方登录中文

Sibyl, Sybil的英文名含义读音来源寓意介绍

📅 12-11 👁️ 7138
夏天的百褶裙,这样穿才真的美
365体育竞彩足球

夏天的百褶裙,这样穿才真的美

📅 11-11 👁️ 9910