视频点播通过 License 管理播放器 SDK 及其增值服务的使用权限和时间。每个 License 都有唯一的 License ID,需要与应用进行绑定。License 分为基础版、高级版和企业版,每个版本支持不同的功能。本文为您介绍如何在视频点播控制台获取 License 并将其与应用进行绑定。
前提条件
注意事项
- 若您同时开发 Android、iOS、Flutter、HarmonyOS NEXT 等多端项目,仅需购买一次 License。
- 自 2024 年 7 月 30 日起,购买 License 时不再支持选择 H.265 硬解优化、蒙版弹幕和外挂字幕增值服务。这些增值服务自播放器 SDK 1.36.1 版本起有以下调整:
- H.265 硬解优化功能由增值服务调整为:基础版支持标准 H.265 播放能力,高级版支持使用 H.265 的大数据机型黑名单和硬解优化。
- 蒙版弹幕和外挂字幕功能由单独的增值服务调整至高级版。
因此,若您先前购买的 License 包含这些增值服务,续期 License 时,增值服务的有效期也将延长,与 License 到期时间保持一致。若您先前没有购买过这些增值服务但当下有需求,请务必升级至播放器 SDK 1.36.1 或以上版本,并购买高级版即可。
申请免费测试 License
在项目测试阶段,您可以在视频点播控制台申请免费的测试 License。测试 License 有效期为 30 天。申请步骤如下:
登录视频点播控制台。
单击左侧导航栏 SDK 管理 > 播放器 License。
单击立即购买。
根据您自身业务需求选择应用类型、License 版本、类型和时长:

详细的参数说明如下表所示。
参数 | 说明 |
---|
应用类型 | 支持以下选项: - App:集成至 Android/iOS/HarmonyOS 项目中
- Web/H5:集成至 Web/H5 浏览器中
|
版本 | - 应用类型为 App 时,支持以下选项:
- 基础版:支持基础播放能力,适用于简单播放场景。
- 高级版:支持更丰富的播放能力,接入后可达到“零首帧”的播放效果。同时提供技术支持、质量优化等专家服务。您还可按需选择增值服务。
- 企业版:包含高级版全部功能,并支持客户端超分和自适应码率增值服务。
- 应用类型为 Web/H5 时,支持以下选项:
- 基础版:支持基础播放能力,适用于简单播放场景。
- 高级版:支持更丰富的播放能力,接入后可达到“零首帧”的播放效果。同时提供技术支持、质量优化等专家服务。您还可按需选择增值服务。
|
类型 | 选择测试版。 |
时长 | 测试 License 时长仅支持 1 个月。不支持续期和变更,到期后需重新申请。 |
单击提交订单。
确认订单信息后,再单击下一步。您可以看到如下界面,表示测试 License 已成功开通。

绑定 License 与应用
成功申请 License 后,您需要将其与应用进行绑定,步骤如下:
- 登录视频点播控制台。
- 单击左侧导航栏 SDK 管理 > 播放器 License。
- 找到目标 License,单击详情。
- 在绑定应用区域,单击页面下方的新增应用按钮。
说明
默认情况下,一个 License 包仅包含一个 License,仅支持绑定一个应用,覆盖 Android、iOS、Flutter 和 HarmonyOS NEXT 多端。如果您的公司开发多款 App,希望一个 License 包绑定多个应用,可联系商务咨询。
- 在抽屉框中选中应用,再单击应用。您可看到如下界面,表示 License 已与应用成功绑定。

- 绑定完成后,单击下载按钮,将 License 文件下载至本地。在后续集成 SDK 时您需要设置 License 文件的路径。
升级至正式 License
测试 License 的有效期为 30 天。您需要在测试 License 到期前升级至正式 License,步骤如下:
登录视频点播控制台。
单击左侧导航栏 SDK 管理 > 播放器 License。
找到目标 License,单击升级正式版按钮。

根据您自身业务需求选择 License 时长,支持购买 1 年、2 年或按月购买。
单击提交订单按钮。
说明
如果您的业务场景无法通过标准购买流程完成,可单击申请人工开通。
确认订单信息后,单击下一步,跳转到支付页面。

支付成功后,单击去控制台按钮,跳转至播放器 License 页面。License 列表的详细说明如下所示。
参数 | 说明 |
---|
License 包 ID | License 包的唯一 ID。 |
版本 | |
应用类型 | |
License 类型 | |
状态 | 审核状态: - 审核中:License 申请正在审核中。
- 审核通过:License 审核完成。
- 申请已撤回:撤回审核中的申请。
|
生效时间 | License 生效时间。 |
到期时间 | License 到期时间。 |
续期和变更正式 License
正式 License 支持续期或变更。
- 续期是指延长 License 的可用时间。您可以选择续期 1 年或 2 年。
- 变更是指升级 License 版本或购买增值服务。
- 如果当前为基础版,可变更为高级版,并勾选高级版下的增值服务。
- 如果当前为高级版,不支持变更为基础版,仅支持添加增值服务。
- 如果当前为企业版,不支持变更。
说明
新增增值服务的到期时间与其所属 License 保持一致。例如,License 有效时间为 1 月 1 日至 12 月 31 日,在 6 月 1 日购买客户端超分增值服务,则增值服务有效时间为 6 月 1 日 至 12 月 31 日。
您可参考以下步骤在视频点播控制台申请续期和变更 License:
- 登录视频点播控制台。
- 单击左侧导航栏 SDK 管理 > 播放器 License。
- 单击 License 操作列的续期/变更按钮。

- 在对话框中根据提示勾选后,单击提交订单,然后根据页面提示完成支付。

常见问题
License 变更后,应用是否需要发版 ?
- Android/iOS/HarmonyOS 应用:License 变更后,应用需要发版。License 续期或变更后,License 文件会发生变化,但 License ID 保持不变。您需要下载新的 License 文件,替换当前 App 版本中的旧 License 文件,然后根据最近的迭代计划发版。历史版本应用中的 License 会自动更新。当 License 续期后,播放器 SDK 会在检测到 License 文件有变化后自动更新 License 的有效时长。
- Web/H5 应用:如集成 Web 播放器 SDK 时已通过
license.mainUrl
参数设置了 License 文件的在线地址,则 License 升级或续期后,SDK 会自动更新至最新 License 版本,无需您手动更新。
替换 License 文件后是否需要更新播放器 SDK?
无需更新 SDK。
License 未及时续期,到期后会发生什么?
一般情况下,我们建议您至少提前一个月对 License 进行续期。
Android/iOS 播放器 SDK
License 过期对播放体验的影响视播放器 SDK 版本而定。
- 播放器 SDK 版本号 >= 1.36.1:
- 如果您当前使用的是高级版或企业版 License,到期后会降级至基础版,高级版 SDK 功能和增值服务(例如预渲染、超分)将无法使用。
- 如果您当前使用的是基础版 License,到期后会降级至系统播放器,会出现指标劣化等问题。如使用了 DRM 播放能力,降级到系统播放器会出现播放失败。
说明
1.36.1 版本对增值服务有以下调整:
- H.265 硬解功能由增值服务调整为:基础版支持标准 H.265 播放能力,高级版支持使用 H.265 的大数据机型黑名单和硬解优化。
- 蒙版弹幕和外挂字幕功能由增值服务调整至高级版。
- 1.36.1 > 播放器 SDK 版本号 >= 1.31.2:
- 如果您当前使用的是高级版或企业版 License,到期后会降级至基础版,高级版 SDK 功能和增值服务(例如预渲染、H.265 硬解)将无法使用。
- 如果您当前使用的是基础版 License,到期后会降级至系统播放器,会出现指标裂化等问题。如使用了 DRM 播放能力,降级到系统播放器会出现播放失败。
- 播放器 SDK 版本号 < 1.31.2:不区分使用的 SDK 版本,License 到期后均降级至系统播放器,可能会出现指标裂化等问题。如使用了 DRM 播放能力,降级到系统播放器会出现播放失败。
Web 播放器 SDK
License 过期后,Web 播放器 SDK 仍会支持基础播控能力,但会增加水印,显示火山引擎 logo。