多人呼叫
多人呼叫与点对点呼叫区别在于多人呼叫是一次呼叫1个以上的人,中途也可以再呼叫邀请别人加入通话。 整个呼叫的流程跟点对点呼叫类似,但也有些区别,需要添加额外的 API 逻辑来实现功能。下面我们分主叫被叫两种角色来分析。
主叫
发起呼叫
创建多个LocalInvitation 对象
val callArray = arrayOf("1234","5678","8888")
callArray.forEach {
val localInvitation = rtmCallManager.createLocalInvitation(it)
localInvitation.setContent("自定义的消息体")
//通常我们都会选择发送json格式字符串,例如
"mediaType":0 //0视频 1 音频
"isMeeting":0 //0 多人模式 1 p2p
"rtcChannelId":"10000"//⚠️这个参数尤为重要,这个参数通常都由主叫生成,在呼叫的时候带给被叫。该参数的作用是告诉对方我们这次呼叫将进入哪个 RTC 的频道,两个人进入同一个 RTC 频道时,音视频才会通。
"callUsers":callArray
//发送呼叫
rtmCallManager.sendLocalInvitation(localInvitation, null)
}
多人呼叫跟和点对点呼叫一样,先创建 LocalInvitation
,并且设置好必要的参数,只不过多人是需要创建多个,在这里我在自定义消息体里多加了一个 callUsers
,将所有呼叫的人userId
都带过去。这个可以让收到呼叫的人知道有哪几个人参与本次通话,并且可以根据这个数据提前加载好占位的View 并展示Loading动画,接通后并且通过接收该视频第一针回调后取消Loading动画。
这里需要注意的是要将创建好的所有 LocalInvitation
放集合中保存,后面取消呼叫,中途邀请人都需要用。
加入RTM频道
这一步尤为重要,先说下加入 RTM 频道的作用。
主叫在发起多人呼叫后,紧接着应该加入频道,并且收到呼叫的人应该也第一时间加入RTM频道。之所以要这么做,是因为我们可以通过RTM 频道几个相当实用的回调,实现人员的添加移除管理。
//频道内总人数更新
void onMemberCountUpdated(int var1);
//有人加入频道
void onMemberJoined(RtmChannelMember var1);
//有人离开频道
void onMemberLeft(RtmChannelMember var1);
onMemberLeft:前面我们已经知道,被叫收到呼叫,不论同意与否,都会会第一时间加入频道。如果被叫拒绝的话,不仅需要调用 rejectRemoteInvitation
还需要调用RTM channel的 Leave方法。调了 Leave ,所有加入 RTM 频道的成员都能知道这个用户离开了,不在需要额外的消息通知。
onMemberJoined:人员加入频道的回调,这个适用于如果中途邀请了别人加入通话,频道内的其他人同样会收到该用户加入 RTM 频道的回调,这时候就判断该用户是否有本地画面,如果没有可以在该回调添加这个人的视图。
onMemberCountUpdated:当RTM频道仅剩1个人的时候,这个时候就可以看作本次通话已经结束,执行相应的逻辑即可。
挂断
- 如果还有未接听的人员,主叫挂断需遍历 LocalInvitation 集合,再调用
cancelLocalInvitation
取消每一个呼叫对象。已接听的记得在LocalInvitation 集合中移除。如果业务逻辑是不区分主叫被叫,那么就不需要调用cancelLocalInvitation
,即使发起人挂断,其他人还在的话,仍可以选择同意或拒绝加入通话。 - 调用 RTM 频道的 Leave ,其他人会收到
onMemberLeft
,移除对应的视图。
异常处理
-
有人不在线
可以过滤不在线的用户,通过
queryPeersOnlineStatus
查询对方状态。 -
接听超时
被叫迟迟不接听,会回调
onLocalInvitationFailure
方法,在这里将其移除。 -
有人异常断线
被叫接听后异常断线,前面可知,收到呼叫就会加入 RTM 频道,如果异常断线后,其他人会收到
onMemberLeft
回调,可在这里将其移除。
被叫
收到呼叫
在收到呼叫回调 onRemoteInvitationReceived
后,首先要做的是 加入 RTM 频道,这样可以方便其他人处理逻辑,其次,主叫在创建 LocalInvitation
对象的时候,加入了callUsers 字端,里面包含本次呼叫的所有人员信息。所以我们可以在此解析,并且保存下来,用于后面页面展示等其他业务逻辑。
同意
调用rtmCallManager.acceptRemoteInvitation(it, remoteInvitation)
同意后,直接遍历 callUsers 在页面上展示每个人的Loading视图,再加入 RTC频道,等收到其他人加入 RTC后取消Loading即可。
拒绝
调用rtmCallManager.refuseRemoteInvitation(it, remoteInvitation)
的同时,也需要离开加入的 RTM 频道。
挂断
- 未接听的情况下,先拒绝
refuseRemoteInvitation
本次呼叫邀请。 - 多人呼叫挂断无需再发送信令通知其他人,只需要离开之前加入的 RTM 频道,其他人即可 通过
onMemberLeft
知道这个人挂断离开。
其他人离开
任何人离开都会先退出 RTM 频道,所以在 onMemberLeft
里移除对应人员即可。
异常处理
其他用户一直未接听:
在 RTM SDK中,一个呼叫邀请的有效时间是60秒,所以,在展示其他人视图的时候,为其设置一个倒计时。期间,如果他 加入了RTC频道(意味着他同意了呼叫),就取消倒计时,隐藏Loading,展示他的视频即可。
如果倒计时结束还未收到他加入RTC的回调,直接移除。
总结
以上就是多人呼叫的大概流程,其中需要注意的地方就是,收到呼叫或者发起呼叫都要先加入 RTM 频道,
RTM频道的ID由主叫创建,被叫在 RemoteInvitation 中解析。挂断需离开RTM频道。
基于上述流程,开发者可以根据该流程并参考DEMO快速实现多人音视频呼叫通话。