更新记录

3.16.5（2024-11-12） 下载此版本

修复开始/停止本地录制接口调用异常

3.16.4（2024-09-30） 下载此版本

1. 新增媒体播放器新增设置视图模式
2. 修复停止本地声浪 [stopSoundLevelMonitor] 接口在Android上调用不生效

3.16.3（2024-09-19） 下载此版本

问题修复

1. 修复远端音量通知事件回调数据结构

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

3.16.1 及以上版本破坏性改动：

适配 uni_modules，开发者可以使用 uni_modules 依赖本插件，插件的导入路径发生变更，开发者需要主动进行适配； @/components/zego-ZegoExpressUniApp-JS -> @/uni_modules/zego-ZegoExpressUniApp-JS/components/zego-ZegoExpressUniApp-JS

ZegoExpressUniAppSDK

即构科技 (ZEGO) 极速音视频 uni-app SDK 是一个基于 ZegoExpressEngine 原生 Android / iOS SDK 的 uni-app Wrapper，提供视频直播以及实时音视频服务。仅需几行代码，30分钟即可轻松接入。

• Zego即构 自研音视频引擎，立即注册有机会每月免费赠送12000分钟。
• Zego即构 实现时延最低79ms，70%丢包下保持流畅的视频通话、直播等场景。
• 助力开发者/中小企业快速在应用中构建一对一，多对多音视频通话。详情低至1折，畅想实时互动

了解更多音视频解决方案：https://www.zego.im

问题反馈

• 官网在线客服
• 提交工单
• 电话咨询：400-1006-604转1

附录

1.官网

2.API文档

3.Demo体验

4.常见问题

使用方法

注意事项

1、本插件是 uniapp 原生插件，使用前需学习 uniapp 原生插件使用方法，官方教程 uni原生插件使用教程

2、使用视频功能时，页面必须使用.nvue文件构建，因为uniapp的.vue页面在原生端（iOS、android）是用 webview 构建的，不能支持component类型的插件。 详情可参考：https://nativesupport.dcloud.net.cn/NativePlugin/course/ios

申请 ZEGO AppID

登录 ZEGO 官网 注册账号，根据自身实际业务需求选择场景，获取 AppID 与 AppSign，用于初始化 SDK。

创建uniapp项目

使用uniapp官方IDE HBuilder，创建uni-app类型的项目

集成「ZegoExpressEngine」uniapp SDK 和 JS 封装插件

开发者需要同时引用以下两个插件，JS 插件主要是为了做代码提示，且包含一些 JS 的逻辑，便于开发者使用 Native 插件功能

Native 插件

JS 插件

基础使用

初始化引擎

import ZegoExpressEngine from '@/uni_modules/zego-ZegoExpressUniApp-JS/components/zego-ZegoExpressUniApp-JS/lib/ZegoExpressEngine';

//  使用从 ZEGO 控制台申请到的 appID 用于初始化
const profile = {
appID : xxx,
// AppSign 仅满足简单的鉴权需求，如果需要升级为更加安全的鉴权方式，请参考[如何从 AppSign 鉴权升级为 Token 鉴权](https://doc-zh.zego.im/faq/token_upgrade?product=ExpressVideo&platform=all)
// AppSign 可通过[控制台](https://console.zego.im/dashboard)获取，格式为 @"39011cbxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
appSign: '39011cbxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
scenario : 0
};

ZegoExpressEngine.createEngineWithProfile(profile)

登入房间

let roomConfig = {};
// 只有传入 “isUserStatusNotify” 参数取值为 “true” 的 ZegoRoomConfig，才能收到 onRoomUserUpdate 回调。
roomConfig.isUserStatusNotify = true;
// 登录房间
ZegoExpressEngine.instance().loginRoom('room1', {'userID': 'id1', 'userName': 'user1'}, roomConfig);

开启音视频通话

在成功登入房间后，可调用 startPreview 开启音视频：

<template>
  <zego-local-view></zego-local-view>
</template>

······

// 需要在登入房间之后才能开启音视频通话
ZegoExpressEngine.instance().startPreview();

将本地视频画面推向云服务

// 推入的streamID由用户设置
let publishStreamID = '123456'
ZegoExpressEngine.instance().startPublishingStream(publishStreamID);

拉取其他用户音视频

登入房间后主动监听 roomStreamUpdate，在收到其他用户推出的音视频流，即可拉取：

<template>
  <zego-remote-view :streamID="playStreamID" ></zego-remote-view>
</template>

······
// 监听 roomStreamUpdate
ZegoExpressEngine.instance().on('roomStreamUpdate', (roomID, updateType, streamList) => {
    this.playStreamID = streamList[0].streamID;
});

······
// 拉取StreamID的音视频
ZegoExpressEngine.instance().startPlayingStream(this.playStreamID); 

退出房间

// 退出房间
ZegoExpressEngine.instance().logoutRoom('room1');

销毁引擎

// 退出房间
ZegoExpressEngine.destroyEngine();

运行

本插件是 uniapp 原生插件，需要使用 uniapp 云打包制作自定义调试基座 ，才能保证正常跑通。 具体可参考 uniapp 官方教程 uni原生插件使用教程

更多功能

1、参考示例源码

2、参考 ZegoExpressUniAppSDK 官方使用文档 更多音视频功能

示例源码使用步骤

示例源码下载地址

ZegoExpressExample-UniApp

1. 将 Demo 导入 HBuilderX，修改 manifest.json 下的 AppID (uniapp的AppID)
2. 修改 Demo ./pages/KeyCenter.js 内的AppID、Token。从ZEGO官网获取的 控制台
3. 导入「ZegoExpressEngine」uniapp SDK
4. 使用 uniapp 本地打包/云打包，制定自定义基座
5. 运行