### 多人呼叫

多人呼叫與點對點呼叫區別在於多人呼叫是一次呼叫1個以上的人，中途也可以再呼叫邀請別人加入通話。 整個呼叫的流程跟點對點呼叫類似，但也有些區別，需要新增額外的 API 邏輯來實現功能。下面我們分主叫被叫兩種角色來分析。

#### 主叫

##### 發起呼叫

建立多個LocalInvitation 物件

```kotlin
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 頻道幾個相當實用的回撥，實現人員的新增移除管理。

```java
//頻道內總人數更新
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](https://github.com/anyRTC-UseCase/ARCall/blob/master/Call-Android/app/src/main/java/org/ar/call/vm/GlobalVM.kt)快速實現多人音影片呼叫通話。

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/d42467f6cfbb412481bfb3f99d1b795f.jpeg#pic_center)

Android技術分享| 視訊通話開發流程(二)

相關文章