目录

语音连麦聊天室集成介绍

前言：本文将简要分享几个语音聊天室的应用场景，并讲述基于环信 SDK ，实现语音连麦聊天室的步骤。

注：环信语聊解决方案是基于环信 SDK 3.6.0 及以上实现，开发者如需实现，需将 SDK 更新到支持版本。

语音聊天基本是社交软件必备的功能，语音相比文字图片更丰富，比视频又更简便，是天然的社交工具。除了单纯的1对1语音或视频聊天，在实时音视频技术支持下，很多 APP 已经延伸出非常多的玩法。

目前比较火的语聊房又分为语音电台、语音游戏、私人聊天房、多人语聊房、KTV 语聊房等细分的场景，延伸出去还有更多的形态，目前比较火的音遇 APP ，就是语聊房的最新形态。

语音电台是目前很多社交APP的玩法。主播可以在直播间中给听众讲故事、脱口秀、唱歌，内容形式不胜枚举，观众也可以申请上麦与主播聊天互动（一般需要打赏或者付费后）。主要实现的功能就是语音连麦。在聊的基础上，加上了背景伴奏音以及通过消息系统来实现的文字消息功能。看似简单，但是这种模式用户的活跃度较高，付费意愿也更高，一些优质的语音社交平台能达到很高的流水。

语音游戏，它也是语音聊天室的常见应用场景。从去年大热的狼人杀、剧本杀，再到王者荣耀、吃鸡等游戏中的语音开黑，越来越多的游戏开始为玩家创建实时互动的场景，同时实时的音视频对话也成为了部分游戏类型的主要功能。功能上与语音直播相似，只是在这个频道中，上麦下麦的玩法逻辑有所不同。

Demo

Demo 体验

扫码体验，详情请查看《TC-语音连麦聊天室使用指南》

版本：V1.0

DEMO开发者名称：北京易掌云峰科技有限公司 隐私协议 用户权限

Demo 源码

我们在 Github 已经提供了一套完整的 Demo，大家可以在 Github 地上获取。

在 Demo 的基础上，开发者只需要不到1周的时间，对 UI 和功能做简单修改即可准备测试上线。

如何实现语音聊天室

以上只是包含了语音聊天的部分场景而已，综上来看，语音聊天室需要满足的主要功能包括：

要实现一个具备以上功能的语音聊天室，大致可以分为三步：实现语音连麦、支持本地混音，多种连麦模式的设计。

首先是实现语音连麦。如果要通过自研的方法实现，难度会比较大：

总体来讲，就是需要解决设备端、网络中的语音连麦稳定低延时问题与可用性问题。

而以上这些问题，环信早已为开发者解决。环信语聊解决方案，基于环信音视频云，针对上述多人语音连麦的难点逐一解决，并将相关接口封装于 SDK 中，让开发者可以简单快速调用集成。 接下来，我们来看一下基于环信音视频 SDK ，实现语音聊天室的步骤吧。 下图为语音聊天室场景化方案的架构图与实现思路：

SDK 的集成步骤比较简单，对于有开发基础的开发者，应该无需手把手教了。

实现语音连麦

通常，观众上麦请求、主播通过上麦申请等一系列操作都是通过消息服务来完成的。任意模式下，进入房间后可以允许听众上麦，用户发出上麦申请，房主同意后，听众可上麦，角色由听众变为了主播。主播要遵循房间模式来实现自己的功能。

会议属性：在语音聊天室 Demo 中，抢麦、主持、自由麦等模式均是通过会议属性实现的，包括各个模式中的上麦者，也是会议属性实现的。当会议属性发生更改时，会广播给房间内所有人。

创建语聊房间

首先创建者通过 AppServer 创建并加入语聊房间，IM 聊天室。在房主通过 AppServer 创建并进入房间后，通过音视频提供的会议属性接口修改房间的会议属性，从而自定义一些房间的属性。

我们可以通过一张图，来了解创建语聊房间接口的调用逻辑：

上图中每步涉及到的 iOS/Android 接口如下，其中部分调用到了 AppServer 的接口，开发者需要自己实现 AppServer 功能。

步骤 iOS API Android API
1.创建语聊房间 AppServer API
2. 创建conference AppServer API http://a1.easemob.com/{orgname}/{appname}/conferences POST
3.创建 chatroom AppServer API http://a1.easemob.com/{orgname}/{appname}/chatrooms POST
4.创建成功返回conference ID,chatroom IDAppServer API
5.加入 conference EMClient.sharedClient.conferenceManager joinConferenceWithConfId: password: completion:EMClient.getInstance().conferenceManager().joinConference(conferenceId, password, callback);
6.加入 chatroom EMClient.sharedClient.roomManager joinChatroom: completion:EMClient.getInstance().chatroomManager().joinChatRoom(chatRoomId, callback);
7.设置会议属性 EMClient.sharedClient.conferenceManager setConferenceAttribute: value: completion:EMClient.getInstance().conferenceManager().setConferenceAttribute(key, value, callback);

加入语聊房间

当房主创建语聊房间后，其他人通过 AppServer 看到有房间被创建，可以输入房间密码加入到房间中。当加入房间后，就会收到会议属性变更的通知，从而得到会议属性。

我们可以通过一张图，来了解观众进入语聊房间接口的调用逻辑：

上图中每步涉及到的 iOS/Android 接口如下，其中部分调用到了 AppServer 的接口，开发者需要自己实现 AppServer 功能。

步骤iOS APIAndroid API
1.获取语聊房间列表AppServer API
2.加入 conference EMClient.sharedClient.conferenceManager joinConferenceWithConfId: password: completion:EMClient.getInstance().conferenceManager().joinConference(conferenceId, password, callback);
3.加入 chatroom EMClient.sharedClient.roomManager joinChatroom: completion:EMClient.getInstance().chatroomManager().joinChatRoom(chatRoomId, callback);
4.同步会议属性EMConferenceManagerDelegate#-conferenceAttributeUpdated:attributes: EMConferenceListener#onAttributesUpdated(attributes);

上麦

已在语聊房间的观众通过 IMServer 发送 message 向房主发起上麦请求，房主同意后，通过 MediaServer 改变会议属性，将观众上麦成为主播，成为主播后就能说话进行推流。房间内其他的人都能收到推流通知并进行订阅。

我们可以通过一张图，来了解观众上麦接口的调用逻辑：

上图中每步涉及到的 iOS/Android 接口如下：

步骤 iOS API Android API
1.请求上麦 EMClient.sharedClient.chatManager sendMessage: progress: completion:EMClient.getInstance().chatManager().sendMessage(msg);
2.改变角色属性EMClient.sharedClient.conferenceManager changeMemberRoleWithConfId: memberNames: role: completion:EMClient.getInstance().conferenceManager().grantRole(targetRole);
3.上麦成为主播EMConferenceManagerDelegate#-roleDidChanged:EMConferenceListener#onRoleChanged(role);
4.推流 EMClient.sharedClient.conferenceManager publishConference: streamParam: completion:EMClient.getInstance().conferenceManager().publish(param,callback);
5.收到推流通知EMConferenceManagerDelegate#-streamDidUpdate: addStream:EMConferenceListener#onStreamAdded(stream);
6.订阅 EMClient.sharedClient.conferenceManager subscribeConference: streamId: remoteVideoView: completion:EMClient.getInstance().conferenceManager().subscribe(stream,surface,callback);

下麦、销毁房间

当主播在麦上时，如果想要下麦，同样通过 IMServer 向房主发送 message 发起下麦请求，这里无需房主同意，默认直接下麦。若房主主动将主播下麦，则没有之前这步，房主直接通过 MediaServer 改变会议属性，将主播下麦成为观众，主播成为观众后就停止推流。房主调用 AppServer 销毁房间，进而销毁conference、chatroom。

我们可以通过一张图，来了解主播下麦、房主销毁语聊房间接口的调用逻辑：

上图中每步涉及到的 iOS/Android 接口如下，其中部分调用到了 AppServer 的接口，开发者需要自己实现 AppServer 功能

步骤iOS APIAndroid API
1.请求下麦EMClient.sharedClient.chatManager sendMessage: progress: completion:EMClient.getInstance().chatManager().sendMessage(msg);
2.改变角色属性EMClient.sharedClient.conferenceManager changeMemberRoleWithConfId: memberNames: role: completion:EMClient.getInstance().conferenceManager().grantRole(targetRole);
3.下麦成为观众EMConferenceManagerDelegate#-roleDidChanged:EMConferenceListener#onRoleChanged(role);
4.停止推流EMClient.sharedClient.conferenceManager unpublishConference: streamId: completion: EMClient.getInstance().conferenceManager().unpublish(publishId,callback);
5.销毁语聊房间AppServer API
6.销毁conferenceAppServer API http://a1-hsb.easemob.com/{orgname}/{appname}/conferences/{confrId} DELETE
7.销毁chatroomAppServer API http://a1.easemob.com/{orgname}/{appname}/chatrooms/{groupid} DELETE

本地混音

本地混音是指将几种不同的声音在发送端混在一起。例如常见的K歌场景，就需要将人唱歌的声音和歌曲的背景音乐进行混音处理。所以，在实现了基本的连麦功能后，我们还需要增加背景音乐的混音、播放控制。

在这里，主播可以在自己的客户端上选择要播放的音乐，然后通过 SDK 的 startAudioMixing 接口在本地与主播语音混音后播放给连麦听众和普通听众。并且连麦语音与背景音乐播放互不干扰，帮助用户活跃房间内的气氛。在默认情况下，背景音乐是循环播放的。

有些开发者希望以语音社交切入泛娱乐市场，也有一些市场上的视频社交玩家，希望加入语音聊天室，来进一步拓展市场版图。由于该场景方案是基于环信音视频 SDK 实现，可以同时满足以上两种需求。

多种连麦模式

在语音聊天室 Demo 中，提供了三种模式，自由麦模式、主持模式、抢麦模式（开发者还可以基于此扩展更多模式玩法）。这三种模式就是通过会议属性区分的，当用户进入房间后，就可以知道当前的房间属于哪种模式。

自由麦模式：主播用户可以自由打开和关闭发言，实现起来较为简单，就不介绍了。

这里主要介绍一下，主持模式和抢麦模式的实现逻辑：