全部产品
Search
文档中心

视频点播:获取短视频SDK License

更新时间:May 09, 2025

短视频SDK使用License进行授权,本文为您介绍短视频SDK License的获取方式以及使用方式。

License升级说明

短视频SDK从3.29.0版本开始,接入一体化License服务即音视频终端SDK License,音视频终端SDK License包含直播推流、短视频、播放器、美颜特性等SDK的授权。License与应用绑定,每一个License最多可以绑定一款Android应用和iOS应用。服务升级的同时,短视频SDK的集成方式也有所变化。详情如下:

短视频SDK版本

集成方式

新接入

使用3.29.0及以上版本的新用户,按照官网帮助文档集成最新版本使用。

SDK版本升级

如果您已接入低于3.29.0版本,在License有效期内,可以继续使用老版本SDK。如果您想升级到3.29.0及以后版本,集成时需要调用注册接口把LicenseKey和LicenseFile集成到SDK内。

License授权

步骤一:创建应用

  1. 进入点播控制台我的授权,选择应用管理标签页,点击创建应用image

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

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

      Web域名填写注意事项

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

        重要

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

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

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

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

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

    2. 移动端:依次填入应用名称,并填入相对应的安卓包名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,找到对应App的Tasks > android > signingReport获取。通过此方式获取到的MD5值,需要将字母转换为小写且去掉分号。image.png

步骤二:购买License

说明

如果您已购买License,请直接通过步骤三:绑定License完成License绑定。

  1. 返回我的授权页面,选择订单实例标签页,点击License购买image

  2. 进入音视频终端SDK购买页,根据业务需求选择SDK和对应的功能模块(SDK权益无法组合购买),确认无误后进行购买。

    重要

    如图所示,SDK权益仅支持单独购买,例如可单独购买播放器SDK标准版。image

  3. 支付成功后返回订单实例标签页,您可以看到新购买的订单实例。

步骤三:绑定License

  1. 返回我的授权页面,选择License管理标签页,点击License绑定image

  2. 进入License绑定页面,选择您需要绑定的应用和对应的SDK License订单,确认信息无误后,单击绑定

    说明

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

    image

  3. 绑定成功后返回License管理标签页,您可以看到绑定成功的应用名称和对应的授权信息。

步骤四:获取授权信息

  1. License管理标签页,找到目标应用。image

  2. 确认授权信息无误后,单击下载证书,将License证书文件下载到本地,并保存License Key,在后续接入应用时使用。配置License文件的步骤请参见接入License

续费License

License过期判断

短视频SDK License有使用期限,以3.29.0版本为界,License过期的判断标准不同。详情如下:

  • 3.29.0以前版本:

    • 接口返回值为ALIVC_FRAMEWORK_LICENSE_FAILED(-10011001)

    • 日志显示以下任一信息:

      • 30天无网络,License已禁用,请续期或重新获取授权。

      • License已禁用,请续期或重新获取授权。

      • License非法(包名和签名/BundleID没有在短视频SDK官网注册),超过7天试用,已经禁用。

  • 3.29.0及以后版本:

    • 接口返回值为ALIVC_FRAMEWORK_LICENSE_FAILED(-10011001)

    • 日志显示以下任一信息:

      • License已过期,请续期或重新获取授权。

      • License未初始化,请参考初始化SDK(Android)初始化SDK(iOS)进行接入。

      • License非法(包名和签名/BundleID没有在短视频SDK官网注册),请重新获取授权。

      • 使用增值服务:xxx已过期,请续期或重新获取授权。(其中xxx指的是具体的增值服务。)

      • 使用增值服务:xxx非法,请获取相应增值服务的License授权后再使用。(其中xxx指的是具体的增值服务。)

License续费方式

方式一:License管理页面续费

  1. 进入点播控制台我的授权

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

    重要
    1. 如果实例ID为空或者续期时控制台出现报错,则需要通过方式二:新购License并绑定应用阿里云技术工单进行续费。

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

    image

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

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

方式二:新购License并绑定应用

如果您购买了SDK License且对应订单实例ID为空或者续期时控制台出现报错,需要在License授权过期之前在MediaBox音视频SDK下单购买,购买后进行步骤三:绑定License,避免线上应用无法正常调用SDK导致业务异常。