本文分享即构uniapp音视频SDK接入指南。即构 uni-app SDK 是一个基于 ZegoExpressEngine 原生 Android 及 iOS SDK 的 uni-app Wrapper,如需使用 uni-app 开发 Web 或小程序,请下载对应的 SDK 集成使用:下载 Web SDK 和 下载小程序 SDK。
准备环境
在开始接入 ZEGO Express SDK 前,请确保开发环境满足以下要求:
- HBuilderX 3.0.0 或以上版本。
- App:
- 准备 iOS 及 Android 设备,版本要求如下:
- iOS 11.0 或以上版本且支持音视频的 iOS 设备。
- Android 4.4 或以上版本且支持音视频的 Android 设备。
- iOS 及 Android 设备已经连接到 Internet。
- 准备 iOS 及 Android 设备,版本要求如下:
- Web:
- 准备一台可以连接到互联网的 Windows 或 macOS 计算机。
- 使用最新版本的 Chrome 浏览器。
接入 SDK
创建项目(可选)
如果是集成到已有项目,可忽略此步。
- 启动 HBuilderX,选择“文件 > 新建 > 项目”菜单。
- 在出现的表单中,选择 “uni-app” 平台,并填写项目名称,单击“创建”,即可创建项目。
集成 SDK
方式 1:在 ZEGO 官网下载 SDK
- 下载 Express-Video SDK 到本地,解压缩 “zego-ZegoExpressUniAppSDK” 文件。
- 将解压缩后的文件夹,直接复制到项目工程根目录下的 “nativeplugins” 文件夹中,如果没有该目录,请手动创建。
方式 2:通过 uni-app 插件市场获取 Express-Video SDK。
- 在 uni-app 插件市场任选一种方式导入:
- 方式 1:单击 “购买(0元) for 云打包”,选择相应的项目导入。
- 方式 2:单击 “下载 for 离线打包”,离线导入。 下载 SDK 到本地,解压缩 “zego-ZegoExpressUniAppSDK” 文件。
- 将解压缩后的文件夹,直接复制到项目工程根目录下的 “nativeplugins” 文件夹中,如果没有该目录,请手动创建。
在 uni-app 项目中导入插件
1 单击项目目录的 “manifest.json” 文件后,单击 “App 原生插件配置” 中的“选择本地插件”或“选择云端插件”。
2 在弹出的选择框中,选择 “ZegoExpress 音视频 SDK” 后,单击“确认”,即添加成功。
自定义调试基座
制作自定义调试基座
1 选择“运行 > 运行到手机或模拟器 > 制作自定义调试基座”菜单。
2 在弹出的界面中,按照 uni-app 教程,填写相关信息,并单击“打包”进行云打包。
3 打包成功后,控制台会收到 uni-app 的相关提示。
切换运行基座为自定义调试基座
自定义调试基座选择“运行 > 运行到手机或模拟器 > 运行基座选择 > 自定义调试基座”菜单。
集成 JS 封装层
导入 JS 封装层。
在插件市场的 ZegoExpressEngine 音视频插件(JS) 界面,单击右侧的“使用 HBuilderX 导入插件”。
导入的 JS 封装层将存储在 “components” 目录中。
导入后,可以在业务代码中引入 JS 封装层,并调用 Express 相关接口,示例如下:
import ZegoExpressEngine from '@/components/zego-ZegoExpressUniApp-JS/lib/ZegoExpressEngine';
相关阅读:
uniapp音视频通话示例源码运行指引(uniapp音视频开发系列1)
本文为原创稿件,版权归作者所有,如需转载,请注明出处:https://www.nxrte.com/jishu/yinshipin/25039.html