1 多人语音聊天性能介绍
本文展现了如何应用 ZEGO Express SDK 结构多人音视频通话场景，即实现多对多实时音视频聊天互动。用户可在房间内与其余用户进行实时音视频通话，相互推拉流。该场景可用于多人实时音视频聊天、多人视频会议等。
2 Web端实现多人语音聊天筹备工作
在利用多人音视频通话场景之前，请确保：
- 已在我的项目中集成 ZEGO Express SDK，实现根本的实时音视频性能，详情请参考 疾速开始 - 集成 和 疾速开始 - 实现流程。
- 已在 ZEGO 控制台 创立我的项目，并申请无效的 AppID，详情请参考 控制台 - 项目管理 中的“我的项目信息”。
3 vue集成语音聊天示例源码下载
请参考 下载示例源码 获取源码。
相干源码请查看ZEGO Express SDK “src/Examples/Scenes/VideoForMultipleUsers” 目录下的文件。
4 ZEGO音视频SDK应用步骤
本节将介绍如何应用 ZEGO Express SDK 实现多人视频通话。
- 流程图如下：
- API 调用时序图如下:
ZEGO Express SDK 可反对多人视频通话，如上时序图以 2 名房间成员间的实时视频通话为例，倡议开发者参考上述流程设计本人的多人实时视频通话场景。
4.1 创立多人音视频聊天引擎实例
创立 ZegoExpressEngine 引擎实例，将申请到的 AppID 传入参数 “appID”，将接入服务器地址传入参数 “server”。
“server” 为接入服务器地址，获取形式如下：
- 登录 ZEGO 控制台。
- 在对应我的项目下单击“查看”。
- 进入“我的项目配置”界面，在“我的项目信息”页签的“配置信息”中，单击 “ServerSecret” 前面的小眼睛按钮即可获取对应的接入服务器地址。
const zg = new ZegoExpressEngine(appID, server);4.2 多人语音聊天开启房间内用户变动告诉
开发者需在每位用户调用 loginRoom 接口登录房间时，将 ZegoRoomConfig 中的 “userUpdate” 设置为 “true” ，用于接管其余用户进出房间的回调告诉（即 roomUserUpdate。
const isLogin = await zg.loginRoom( roomID, token, { userID }, { userUpdate: true } );4.3 监听回调事件
为实现多人视频通话性能，须要监听房间内用户和流的增减并做出相应解决，开发者可依据理论须要，实现 ZegoEvent（蕴含 ZegoRTCEvent 和 ZegoRTMEvent）中的某些办法，创立引擎后可通过调用 on) 接口设置回调。
4.3.1 监听房间内的用户变动
只有调用 loginRoom 登录房间时设置了关注用户变动，即 ZegoRoomConfig 中的 “userUpdate” 设置为 “true”（默认值为 “false”）时，能力监听 roomUserUpdate 回调。
为了监听房间内的用户变动，需注册 roomUserUpdate 回调，已登录房间内用户的新增和删除都会触发该回调，开发者能够依据理论须要在回调中实现本人的业务逻辑。
回调中 “updateType” 参数指明了房间内用户变动的类型，该参数取值如下：
| 用户变动类型 | 枚举值 | 阐明 |
|---|---|---|
| 用户新增 | ADD | 房间内用户减少（即退出房间），“userList” 为新增的用户列表。 |
| 用户缩小 | DELETE | 房间内用户缩小（即退出房间），“userList” 为缩小的用户列表。 |
用户首次登录房间时，若此房间内已存在其余用户，该新登录用户会通过此回调接管到新增类型的用户列表，即 “updateType” 为 “ADD” 的回调，该用户列表为房间内已存在的用户。
zg.on('roomUserUpdate', (roomID, updateType, userList) => { console.log('roomUserUpdate roomID ', roomID, streamList); if (updateType === 'ADD') { // update view } else if(updateType == 'DELETE') { // update view } });4.3.2 多人语音聊天监听房间内的流变动
当某条流被删除时，如果开发者正在调用 startPlayingStream 接口拉取该流，请调用 stopPlayingStream 接口进行拉流，否则 SDK 会报拉流谬误。
为监听房间内的流变动，需注册 roomStreamUpdate 回调，已登录房间内流的新增和删除都会触发该回调，开发者能够依据理论须要在回调中实现本人的业务逻辑。
回调中 “updateType” 参数指明了房间内流变动的类型，该参数取值如下：
| 流变动类型 | 枚举值 | 阐明 |
|---|---|---|
| 流新增 | ADD | 房间内流减少，“streamList” 为新增的流列表。 |
| 流缩小 | DELETE | 房间内流缩小，“streamList” 为缩小的流列表。 |
用户首次登录房间时，若此房间内存在其余用户正在推流，会接管到流新增列表，即 “updateType” 为 “ADD” 的回调。
zg.on('roomStreamUpdate', (roomID, updateType, streamList) => { console.log('roomStreamUpdate roomID ', roomID, streamList); if(updateType === 'ADD') { // update view } else if(updateType == 'DELETE') { // update view }});4.3 推流、拉流、登录房间其余操作
请参考 疾速开始 - 实现流程 顺次实现登录房间、推流和拉流相干操作。
5 API 参考列表
| 办法 | 形容 |
|---|---|
ZegoExpressEngine | 初始化 Engine |
roomStreamUpdate | 房间内流变动回调 |
roomUserUpdate | 房间内用户变动回调 |
loginRoom | 登录房间 |
createStream | 创立流 |
startPublishingStream | 开始推流 |
startPlayingStream | 开始拉流 |
stopPublishingStream | 进行推流 |
stopPlayingStream | 进行拉流 |
logoutRoom | 退出房间 |
5 获取音视频SDK更多帮忙
获取本文的Demo、开发文档、技术支持，拜访即构文档核心
近期有开发布局的开发者可上即构官网查看，恰逢即构七周年全线音视频产品1折的优惠，分割商务获取RTC产品优惠；