短视频SDK和License常见问题

如何申请试用短视频SDK？

您可以通过视频点播控制台SDK管理 > 我的授权申请，详细操作请参见获取短视频SDK License。

如何免费使用短视频SDK？

目前购买点播套餐即可免费使用短视频SDK，详细请参见获取短视频SDK License。

如何购买专业版短视频SDK？

专业版和其他版本的区别，请参见：功能列表。

提示License Failed，应该如何处理？

SDK 进行 License 校验时，会自动获取包名（iOS 为 BundleID，Android 为 PackageName），并根据您配置的 LicenseKey 请求线上证书验证服务，完成证书拉取，获取最新的证书信息。请结合上述校验机制，按以下内容排查：

1. 确保已购买、获赠或申请试用的短视频SDK License未到期，并已开通短视频SDK License授权。有关查询Licsense是否到期的方法，请参见获取短视频SDK License。

2. 确认申请试用的信息是否正确。

   • 如果是iOS端，请确保应用bundleID和申请开通的应用bundleID是一致的。

   • 如果是Android端，请确保包名和签名信息（MD5）获取是否一致。可以通过如下两种方式来获取包名和签名信息：

     • 方式一：使用签名获取工具，安装后按工具中的指导操作，来获取正确的包名和签名信息。

     • 方式二：下载SignatureUtils.java脚本到本地后，调用SignatureUtils#getSingInfo(Context context)方法获取包名和签名信息。

       说明

       GitHub属于第三方搭建的网站。访问该网站时，可能存在部分用户无法打开网站或访问延迟的问题。

提交License申请后如何查看审核进度或接收通知？

提交 License 申请后需要等待处理流程完成，您可以通过以下通知渠道查看审核进度：

• 审核通过后，系统会通过邮件通知您申请结果。

• 您也可以登录视频点播控制台，选择SDK管理 > 我的授权，查看对应应用的 License 是否已下发。

内网测试环境（IP或Hosts映射）下License域名如何填写？

SDK 初始化时必须填写申请 License 时注册的正式域名。在内网测试环境中，即使本地通过 hosts 映射或 IP 访问页面，License 校验仍要求页面域名与申请时填写的域名一致，或为该申请域名的子域名。

如果内网环境完全无法配置域名，建议申请一个测试域名，并将该测试域名绑定到内网 IP，以通过 License 校验。

AliPlayer License是否支持vscode-webview协议或正则表达式？

不支持。AliPlayer License 的域名配置仅支持纯主域名，例如 cloudlab.top，不支持泛域名、正则表达式、带协议头或带路径的写法。

VSCode Webview 的 window.location.hostname 为随机哈希，且每次运行都会变化，无法通过控制台配置与之匹配。因此在 vscode-webview 环境下，无法通过配置解决 License 校验失败的问题。

uni-app开发微信小程序使用VOD上传SDK报错‘文件加载失败’或‘找不到引用文件’如何排查？

使用 uni-app 开发微信小程序并集成 VOD 上传 SDK 时，如果出现“文件加载失败”或“找不到引用文件”报错，请按以下步骤排查：

1. 检查 SDK 文件路径：确保 SDK 文件存放在项目根目录的 utils/ 或 lib/ 目录下，不要放在 pages/ 页面目录下。

2. 统一导入方式：删除所有 import 语句，仅保留 const VODUploadModule = require('...')。

3. 调整初始化时机：将 SDK 初始化逻辑移至 onMounted 生命周期中，并使用 try-catch 捕获异常，避免异常阻断组件渲染。

4. 查看具体报错信息：将项目打包为微信小程序后，在微信开发者工具中运行项目，并查看控制台中具体的 JavaScript 报错信息。

绑定订单时提示订单号不对怎么办？

绑定订单时需要使用有效的订单号。如果提示订单号不对或订单号错误，请先完成购买，取得有效订单号后再执行绑定操作。购买时建议选择组合购买，以获得更优惠的价格。

提示License非法，应该如何处理？

请先确认您申请的License版本与实际使用的版本是否一致，若您申请开通的License版本为标准版，但实际使用了非授权的版本或功能，则会提示您License非法。请按实际申请开通的版本使用License。

升级到7.0.0之后，使用异常如何处理？

短视频7.0.0版本SDK不再区分基础版、标准版和专业版，具体功能的划分将通过License校验进行判定。因此，用户在升级至7.0.0版本后，需重新配置License文件，未做此操作可能会导致异常情况的发生。

人脸贴纸与人脸AR、动态贴纸的区别？

人脸贴纸属于视频录制中的功能，即通过人脸识别的功能，给识别到的人脸添加指定的贴纸，目前仅专业版本支持。 人脸AR属于美颜特效SDK中的功能，需要额外授权。 动态贴纸属于视频编辑中的功能，仅专业版本支持。