管理License

MediaBox音视频SDK整合直播推流、短视频、播放器、美颜特效、端侧智能功能模块提供统一的授权管理服务,覆盖Android、iOS、HarmonyOSWeb多端的License管理,可有效降低集成SDK门槛。通过阅读本文,您可以了解如何申请、绑定License或修改License绑定应用信息。

改版说明

新版本对License下单流程进行了解耦,将应用程序的创建与SDK License订单购买流程独立开来 ,方便用户根据业务需要对应用相关的SDK权限进行灵活管理。

重要

2024121日起,阿里云Web播放器SDK(2.28.0版本开始)的集成使用需要接入License服务。如果您使用的是2.28.0之前的版本,虽然不受此次变更影响,但我们建议您升级到最新版,以享受更全面的服务和支持。

绑定License流程

image

申请License

  1. 登录视频点播控制台。

  2. 在左侧导航栏选择SDK管理 > 我的授权

  3. 选择应用管理标签页,点击创建应用

  4. 编辑应用信息,应用按平台类型分为Web端和移动端。

    • Web端:依次填入应用名称和对应的Web域名,完成应用创建。image

      Web域名填写注意事项

      • 标准填写示例:aliyun.com。

        重要

        当需要同时覆盖多个子域名时(例如pc.aliyun.commobile.aliyun.com),只需填写主域名“aliyun.com”即可。

      • 错误填写示例(请勿填写以下形式)

        • 包含协议头:http://aliyun.com或 https://aliyun.com。

        • 包含路径或子页面:aliyun.com/indexaliyun.com/login。

        • 使用泛域名:*.aliyun.com或.aliyun.com。

    • 移动端:依次填入应用名称,并填入相对应的安卓包名iOS BundleIDHarmonyOS BundleID,完成应用创建。

      image

      绑定Android应用签名

      说明
      • 如果平台选择了Android,且勾选了绑定签名,则此项必填。

      • 绑定签名后会提高安全性,可以避免License被同Package Name的应用盗用。

      • 新版本SDK支持免绑定签名,包含:MediaBox音视频SDK v1.7.0及以上版本、播放器SDK v5.5.2及以上版本、直播推流SDK v4.4.9及以上版本、短视频SDK v3.36.0及以上版本。

      获取Android应用签名MD5值,您可以通过以下两种方式:

      • 通过命令获取:执行keytool -v -list -keystore your.keystore查看相应签名的MD5值。

      • 通过AndroidStudio获取:单击右侧侧边栏的Gradle,找到对应AppTasks > android > signingReport获取。通过此方式获取到的MD5值,需要将字母转换为小写且去掉分号。image.png

  5. 选择License管理标签页,单击License核销image

    根据是否已有SDK License订单分为:

    • 已有订单:在下拉框中选择已有的License订单。

    • 未有订单:如果没有可用的License订单,在下拉框中点击新建SDK License订单

    您也可以先通过音视频终端SDK购买页,根据业务需求选择SDK和对应的功能模块,购买后再进行核销。功能详情请参见功能特性

  6. 确认您的应用信息和SDK License订单功能模块匹配无误后,单击绑定

    说明

    每个License订单最多绑定一款应用,覆盖Web端或者移动端。

    image

  7. 下载License文件。

    绑定完成后,您可以返回License管理标签页,找到目标应用,确认无误后单击下载证书,将License证书文件下载到本地,并保存License Key,在后续接入应用时使用。配置License文件的步骤请参见接入License

    image

License如何续期

方式一:License管理页面续费

  1. 登录视频点播控制台

  2. 在左侧导航栏选择SDK管理 > 我的授权

  3. 选择License管理标签页,找到对应应用下绑定的实例ID,点击操作栏的续期按钮。

    重要
    1. 如果实例ID为空,则需要通过方式三:提交表单续期阿里云技术工单进行续费。

    2. 续费针对License订单,如果您的License订单中包含多个SDK权益,续费将会对所有SDK进行整体续费,暂不支持变配。如有疑问,请提交阿里云技术工单咨询。

    image

  4. 进入续费管理界面,点击操作栏的续费按钮。image

  5. 进入音视频终端SDK续费页面。确认您的当前配置和购买时长无误后,点击立即购买完成续费(建议您勾选到期自动续费,以避免过期)。image

方式二:资源包买赠

如果您消费或者购买指定订阅包达到一定金额,获赠了相应License授权。需要在已有License授权使用过期之前,将获赠的License授权进行License核销,避免线上应用无法正常调用SDK导致业务异常。

方式三:提交表单续期

如果您购买了播放器SDK对应订单实例ID为空时,需要在License授权过期之前在音视频终端SDK购买页下单购买,购买后进行License核销或者将订单号填入宜搭表单申请表内提交进行续费,避免线上应用无法正常调用SDK导致业务异常。

如何申请试用版License

如果您想试用播放器SDK,您可以通过播放器SDK试用版进行申请。试用其他功能您可以通过提交宜搭表单申请试用版License,试用版的开通将在12个工作日内处理完成,开通后授权请参见License核销image

修改License绑定应用信息

如果您的应用信息发生变化,可以在控制台上修改应用信息。

重要
  • 修改应用的标识符(Package Name等)将导致原有标识符对应的应用鉴权失败,需要重新下载License文件证书进行替换,请谨慎操作。

  1. 登录视频直播视频点播控制台。

  2. 在左侧导航栏选择SDK管理 > 我的授权

  3. 点击应用管理标签页找到目标应用,确认无误后单击编辑

  4. 您可以修改应用名称、平台、Android应用签名MD5值及应用标识符(Package Name等)信息。

  5. 确认无误后单击更改,完成License修改。

常见问题排查

License相关常见问题