實時音視頻通話涉及到的技術堆疊、人力成本、硬體成本非常大，一般個人開發者基本無法獨立完成一個功能健全并且穩定的實時音視頻應用，本文介紹一天之內，無任何實時音視頻低層技術的android開發者完成實時相親房APP，效果如下：
影片6.gif

筆者從搜索引擎上搜了一些第三方庫，綜合對比了一下，最終選擇了即構)，因為一方面他們提供了非常全的音視頻通話能力，視頻通話SDK使用起來也非常簡單；另一方面他們每個月提供了10000分鐘的免費額度，對于個人開發者來說足夠用了，如果超過了免費額度，說明應用有一定的流量了，到那時候花點錢擴一下容量就好，

詳細開發檔案請參考https://doc-zh.zego.im/article/7627)

1 需要用到的多人實時音視頻通話能力

實作Android端多人實時視頻通話，可以簡單地抽象成如下幾個模塊：

獲取本地視頻流，并推送到服務器，

拉取各個用戶視頻流，并在終端展示，

房間管理，管理當前多人房間的用戶連接狀態、觀眾登錄登出等，

接下來我們介紹基于即構音視頻通話SDK來實作上述模塊功能，

1.1 音視頻SDK準備作業

1.1.1 集成音視頻SDK

音視頻通話SDK集成方式請直接參考官方檔案https://doc-zh.zego.im/article/195), 這里不過多描述，

1.1.2 音視頻通話sdk初始化引擎

有了即構的實時音視頻庫后，接下來需要初始化庫，得到一個ZegoExpressEngine引擎物件，這個物件比較重要，因為接下來我們的一切對音視頻流的控制都是通過此物件實作，

ZegoEngineProfile profile = new ZegoEngineProfile();
profile.appID = KeyCenter.APPID; 
profile.scenario = ZegoScenario.GENERAL;  // 通用場景接入
profile.application = app;
ZegoExpressEngine engine = = ZegoExpressEngine.createEngine(profile, null);

需要注意的是，這里第二行有APPID引數，這兩個引數需要前往https://console.zego.im)創建一個專案，即可獲取當前專案對應的APPID，

另外，ZegoExpressEngine.createEngine函式還有一個handler引數，這個引數物件用于監聽當前房間的一些資訊，如相親房用戶登錄登出，用戶發送實時訊息等，這里我們先挖個坑，在后面詳細描述這個物件，

1.2 相親房的房間登錄登出

房間是用來承載多人音視頻通話的空間，一切實時音視頻都是發生在房間，因此，首先要登錄房間：

ZegoUser user = new ZegoUser(userID, userName);
ZegoRoomConfig config = new ZegoRoomConfig();
config.token = token; // 請求開發者服務端獲取
config.isUserStatusNotify = true;
engine.loginRoom(roomId, user, config);

注意，需要保證userID唯一，roomID也要唯一，如果當前roomID已存在，那么加入此房間，如果不存在，則創建房間，

退出房間比較簡單：執行engine.logoutRoom();即可退出，

注意到此函式需要傳入token引數，token引數是采用對稱演算法生成，其大致原理如下：

生成一個亂數，并將有效時長等其他相關引數，按照固定格式排列得到未加密版的token，

使用密鑰（在即構官方控制臺中獲取，每個APPID對應一個密鑰）并使用對稱加密演算法加密，得到加密版的token，這個token是給客戶端登錄時使用的，

具體的代碼實作操作請參考文末提供的原始碼，這里不再過多描述，

1.3 相親房實時視頻推流

如果希望別人能拉取到自己的實時視頻畫面，需要先將自己的視頻流推送出去，

engine.startPublishingStream(streamID);

注意，這里的streamID用于標識用戶的視頻流，因此需要保證唯一，因為其他用戶在拉取視頻流時，是根據這個標識來區分的，

1.4 相親房實時視頻畫面顯示

1.4.1 預覽本地視頻

ZegoCanvas canvas = new ZegoCanvas(textureView);
//設定顯示影像填充比例方式
canvas.viewMode = ASPECT_FILL; 
engine.startPreview(canvas);

textureView是個TextureView物件，可以在布局檔案中提前布局，

1.4.2 預覽遠程視頻

ZegoCanvas canvas = new ZegoCanvas(textureView);
//設定顯示影像填充比例方式
canvas.viewMode = ASPECT_FILL;  
engine.startPlayingStream(streamID, canvas);

預覽遠程用戶與本地畫面預覽類似，需要差別是需要提供遠程用戶推流的streamID，

2 無后臺開發

用戶唯一性、視頻流唯一性、房間號的唯一性等需要我們自己準備一臺服務器來管理，如果讀者有個人服務器，實作起來也非常簡單，

考慮到大部分讀者沒有個人服務器，同時也為了方便本文提供的代碼可以直接在任何網路環境下運行，接下來我們實作無后臺的方案：

我們假設每個用戶都是社會主義三好青年，不會去破解APP冒充房主，創建房間的房主就是管理員，管理員向房間內各個用戶發送實時訊息，房間內各個成員去執行管理員的指令，實作房間管理的能力，

這就需要用到即構實時音視頻SDK的房間內實時發送訊息能力，

2.1 房間發送實時訊息

廣播訊息：

public void sendBroadcastMessage(String roomID,
								 String msg,
								 IZegoIMSendBroadcastMessageCallback callback);

roomID和message就不需要再解釋，callback物件是回呼叫戶，用于獲取訊息發送是否成功，

一對多發送訊息：

public void sendCustomCommand(String roomID,
							  String msg,
							  ArrayList<ZegoUser> toUserList,
							  IZegoIMSendCustomCommandCallback callback);

ZegoUser型別在前面登錄房間時我們已經介紹過，其他引數含義同上，

2.2 相親房內接收實時訊息

前面在介紹創建ZegoExpressEngine引擎時，需要提供一個handler引數，這里派上用場了，它是抽象類IZegoEventHandler的子類物件，用于執行回呼事件，例如接收廣播訊息：

@Override
public void onIMRecvBroadcastMessage(String roomID, 
	ArrayList<ZegoBroadcastMessageInfo> messageList) {
        // 收到廣播訊息
        Log.d(TAG, "收到廣播訊息");
}

接收到一對多訊息：

@Override
public void onIMRecvCustomCommand(String roomID,
								  ZegoUser fromUser,
								  String command) {
        Log.d(TAG, "收到一對多訊息");
}

2.3 IZegoEventHandler其他需要用到的回呼函式

房間內用戶登錄、登出回呼，在用戶登錄時，可以將房間資訊如房間名稱，房主ID等發送給登錄的用戶：

@Override
public void onRoomUserUpdate(String roomID,
					         ZegoUpdateType updateType,
							 ArrayList<ZegoUser> userList) {
     super.onRoomUserUpdate(roomID, updateType, userList); 
     if (updateType == ZegoUpdateType.ADD) {
          Log.d(TAG, "用戶登錄");
     } else if (updateType == ZegoUpdateType.DELETE) {
         Log.d(TAG, "用戶登出");
     }

}

獲取音量大小，用于顯示每個連麥的用戶的說話音量：

@Override
// soundLevel取值為0~100
public void onCapturedSoundLevelUpdate(float soundLevel) {
    Log.d(TAG, "收到自己音浪訊息...");
}
@Override
public void onRemoteSoundLevelUpdate(HashMap<String, Float> soundLevels) {
    Log.d(TAG, "收到遠程音浪訊息...");
}

與房間連接狀態回呼，用于判斷當前登錄狀態，

@Override
public void onRoomStateUpdate(String roomID,
							ZegoRoomState state,
							int errorCode,
							JSONObject extendedData) {
   super.onRoomStateUpdate(roomID, state, errorCode, extendedData);
   if (state == ZegoRoomState.CONNECTED) {
        Log.d(TAG, "房間連接成功...");
   } else if (state == ZegoRoomState.CONNECTING) {
        Log.d(TAG, "房間連接中...");
   } else if (state == ZegoRoomState.DISCONNECTED) {
        Log.d(TAG, "房間連接斷開...");
   }
}

3 正式開發相親房APP

有了前面的音視頻能力的基礎鋪墊后，我們接下來進入正式的相親房APP開發.

3.1 創建房間/進入房間界面功能與實作

相親房的圖片.jpg

對于創建房間按鈕，需要判斷房間是否已存在，可以通過獲取指定的房間ID里面人數是否為0來判斷房間是否已存在，同理，對于進入房間的用戶來說，需要判斷房間內用戶數量是否大于0來判斷房間是否存在，

例如，查詢房間號為123和456房間的用戶數量:

https://rtc-api.zego.im/?Action=DescribeUserNum
&RoomId[]=123
&RoomId[]=456
&<公共請求引數>

注意，呼叫頻率限制（同一個 AppID 下所有房間）：10 次/秒（測驗環境：1 次/秒）

具體使用方法參考這里https://doc-zh.zego.im/article/8780)

3.2 相親場景的月老

我們把創建房間的房主稱為月老，月老創建房間后：

監聽用戶進入房間，當有用戶進入房間時，向其發送當前房間的房間名稱、月老的UserID、當前正在連麥的用戶資訊及其視頻流StreamID，
監聽用戶訊息，接收房間內用戶發送的訊息，訊息分為幾類：請求上麥、下麥、用戶已靜音等連麥相關訊息，
當有連麥用戶有變動，將連麥用戶資訊廣播給各個用戶，

3.3 相親場景的用戶

普通用戶進入房間后：

第一時間得到月老發送的房間資訊，包括房間名稱，月老UserID、正在連麥用戶資訊及其視頻流StreamID
得到連麥用戶資訊后，自動拉取連麥用戶的StreamID對應的視頻流，并在界面展示，
請求連麥，向月老發送請求連麥資訊，
每次收到月老發送的同步房間資訊時，自動將拉取正在連麥的用戶視頻流，并取消下麥視頻流的展示，

3.4 實時視頻播放預覽畫面

在整個相親房APP中，核心是拉取遠程視頻流和播放本地預覽，前面提到，播放預覽畫面分為本地預覽和拉取視頻流預覽，為了便于呼叫，將兩種方式封裝為一個函式playStream:

private void playStream(ZegoExpressEngine engine, String streamId, TextureView tv) {
    if (streamId == null) return;
    if (streamId.equals(controller.mUserInfo.uid)) {
        Log.e(TAG, "預覽自己");
        engine.startPublishingStream(streamId);//上傳視頻流
        Zego.playPreview(engine, tv, null);
    } else {
        Log.e(TAG, "拉取視頻流");
        engine.stopPlayingStream(streamId);
        Zego.playPreview(engine, tv, streamId);
    }
}

playStream函式指定要拉取的streamID和用于顯示的TextureView，在函式里面判斷當前streamID是否屬于自己，如果屬于自己則直接預覽本地即可，否則拉取遠程視頻流，其中Zero.playPreview如下：

public static void playPreview(ZegoExpressEngine engine, TextureView tv, String streamId) {
    ZegoCanvas canvas = new ZegoCanvas(tv);
    canvas.viewMode = ASPECT_FILL;
    if (streamId == null) {//本地預覽
        engine.startPreview(canvas);
    } else {//拉取視頻流
        engine.startPlayingStream(streamId, canvas);
    }
}

根據傳入的streamID是否為null來判斷是拉取遠程視頻還是播放本地預覽，

4 相親房demo的代碼分享

無后臺版相親房APP原始碼下載：（https://github.com/KaleTom/xiangqingfang）

轉載請註明出處，本文鏈接：https://www.uj5u.com/qita/501270.html

標籤：其他

上一篇：手把手教你uniapp接入聊天IM即時通訊功能-原始碼分享

下一篇：測驗計劃

從零實作在線云相親APP｜程式員脫單神器（內附原始碼Demo)