uni-app 拉流 SDK 是基于 Android 和 iOS 拉流 SDK 的统一封装解决方案,旨在为开发者提供跨平台的拉流能力。本文介绍如何集成 uni-app 拉流 SDK。
开发环境要求
- Android 端:
- Android 4.3 及以上系统
- armv7a、arm64 架构
- iOS & macOS 端开发:
- iOS 11.0 以上的 iPhone 或者 iPad 真机
- Xcode 14.0 以上版本
前提条件
- 已搭建 uni-app 开发环境。具体步骤如下:
- 下载 HBuilderX 编辑器。
说明
推荐使用最新版本。如果您此前已下载过 HBuilderX,为保证开发环境统一,请更新到最新版本。
- 在 DCloud 开发者中心注册后,登录 HBuilderX 编辑器。
- 已创建应用并获取 License 文件。详见创建应用和获取 License。
视频直播通过 License 管理 SDK 及其增值服务的使用权限和时间。在创建应用期间,按需选择 License 版本。例如,在项目测试阶段,您可以选择免费的试用版 License。说明
试用版 License 仅限项目测试阶段使用,不可续期。到期后会导致鉴权失败,进而影响业务的正常使用。因此请在项目上线前,升级至正式版 License。详见转正式版 License。
集成步骤
步骤一:集成 uni-app 原生插件
- 将以下
volcengine-live-player 原生插件下载至本地。

volcengine-live-player.zip
69.74MB
- 将文件解压至 uni-app 项目的
nativeplugins 目录下。 - 通过 HBuilder 打开 uni-app 项目。
- 在项目根目录下
manifest.json 文件的 安卓/iOS 原生插件配置项下单击选择本地插件。在列表中选择需要打包生效的插件,如下图所示。

说明
- 更多有关 uni-app 原生插件的信息,详见 uni-app 原生插件使用教程。
- 请使用自定义基座打包项目进行测试。但请注意,自定义基座并非正式版本,因此在正式发布应用时,您需要重新打包。此外,使用自定义基座的应用无法正常升级或替换 APK。
步骤二:集成 uni-app JS 封装层 SDK
- 将以下
volcengine-live-player JS 封装层 SDK 下载至本地。

volcengine-live-player_1.0.0.zip
未知大小
- 将文件解压至 uni-app 项目
uni_modules 目录下。
步骤三:添加 License 文件
获取 License 文件后,将其作为原生资源文件,放入 uni-app 项目的 nativeResources 文件夹下(如无该文件夹,则自行创建),如下图所示。后续在初始化 SDK 时,您需要传入 License 文件路径。

后续操作
至此,您已完成 uni-app 拉流 SDK 的集成。后续可初始化 uni-app 拉流 SDK。详见初始化 uni-app。