Android技术分享| 视频通话开发流程(二)

多人呼叫

多人呼叫与点对点呼叫区别在于多人呼叫是一次呼叫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个人的时候,这个时候就可以看作本次通话已经结束,执行相应的逻辑即可。

挂断
  1. 如果还有未接听的人员,主叫挂断需遍历 LocalInvitation 集合,再调用 cancelLocalInvitation 取消每一个呼叫对象。已接听的记得在LocalInvitation 集合中移除。如果业务逻辑是不区分主叫被叫,那么就不需要调用cancelLocalInvitation,即使发起人挂断,其他人还在的话,仍可以选择同意或拒绝加入通话。
  2. 调用 RTM 频道的 Leave ,其他人会收到 onMemberLeft,移除对应的视图。
异常处理
  1. 有人不在线

    可以过滤不在线的用户,通过 queryPeersOnlineStatus查询对方状态。

  2. 接听超时

    被叫迟迟不接听,会回调 onLocalInvitationFailure方法,在这里将其移除。

  3. 有人异常断线

    被叫接听后异常断线,前面可知,收到呼叫就会加入 RTM 频道,如果异常断线后,其他人会收到 onMemberLeft回调,可在这里将其移除。

被叫

收到呼叫

在收到呼叫回调 onRemoteInvitationReceived后,首先要做的是 加入 RTM 频道,这样可以方便其他人处理逻辑,其次,主叫在创建 LocalInvitation对象的时候,加入了callUsers 字端,里面包含本次呼叫的所有人员信息。所以我们可以在此解析,并且保存下来,用于后面页面展示等其他业务逻辑。

同意

调用rtmCallManager.acceptRemoteInvitation(it, remoteInvitation)同意后,直接遍历 callUsers 在页面上展示每个人的Loading视图,再加入 RTC频道,等收到其他人加入 RTC后取消Loading即可。

拒绝

调用rtmCallManager.refuseRemoteInvitation(it, remoteInvitation)的同时,也需要离开加入的 RTM 频道

挂断
  1. 未接听的情况下,先拒绝 refuseRemoteInvitation 本次呼叫邀请。
  2. 多人呼叫挂断无需再发送信令通知其他人,只需要离开之前加入的 RTM 频道,其他人即可 通过 onMemberLeft知道这个人挂断离开。
其他人离开

任何人离开都会先退出 RTM 频道,所以在 onMemberLeft里移除对应人员即可。

异常处理

其他用户一直未接听:

在 RTM SDK中,一个呼叫邀请的有效时间是60秒,所以,在展示其他人视图的时候,为其设置一个倒计时。期间,如果他 加入了RTC频道(意味着他同意了呼叫),就取消倒计时,隐藏Loading,展示他的视频即可。

如果倒计时结束还未收到他加入RTC的回调,直接移除。

总结

以上就是多人呼叫的大概流程,其中需要注意的地方就是,收到呼叫或者发起呼叫都要先加入 RTM 频道,

RTM频道的ID由主叫创建,被叫在 RemoteInvitation 中解析。挂断需离开RTM频道。

基于上述流程,开发者可以根据该流程并参考DEMO快速实现多人音视频呼叫通话。

在这里插入图片描述

posted @ 2022-09-07 11:43  anyRTC  阅读(102)  评论(0编辑  收藏  举报