如何基於 ZEGO SDK 實現 Windows 一對一音視頻聊天應用

互聯網發展至今，實時視頻和語音通話越來越被大眾所依賴。今天，我們將會繼續介紹如何基於ZEGO SDK實現音視頻通話功能，前兩篇文章分別介紹了Android，Flutter平臺的實現方式，感興趣的小伙伴可點擊瞭解: [Android](https://zegoguanwang.datasink.s... ...

互聯網發展至今，實時視頻和語音通話越來越被大眾所依賴。

今天，我們將會繼續介紹如何基於ZEGO SDK實現音視頻通話功能，前兩篇文章分別介紹了Android，Flutter平臺的實現方式，感興趣的小伙伴可點擊瞭解: Android，Flutter。

接下來，我們將會一起開發一個RTC場景的Windows應用。

1 準備環境

在開始集成 ZEGO Express SDK 前，請確保開發環境滿足以下要求：
Visual Studio 2015 或以上版本。
Windows 7 或以上版本。
麥克風、攝像頭等支持音視頻功能的外部設備。

2 項目準備

2.1 創建項目

進入即構官網，在【ZEGO控制台】創建項目，並申請有效的 AppID，這一步很關鍵，appid為應用的唯一標識，如身份證號，是應用的身份證明，用於明確你的項目及組織身份。zego提供的服務也是基於APP ID；

App ID的獲取方式很簡單，只需3～5分鐘，在即構官網-我的項目-創建即可。創建的項目信息可用於SDK的集成和配置；

2.2 Token 鑒權

登錄房間時必須使用 Token 鑒權，可參考 Token 鑒權教程
為了方便開發階段的調試，開發者可直接在 ZEGO 控制台獲取臨時 Token（有效期為 24 小時）來使用，詳情請參考控制台（新版） - 項目管理中的 “項目信息”。

3 集成

3.1 項目設置

1.打開 Microsoft Visual Studio，選擇“文件 > 新建 > 項目”菜單。
在這裡插入圖片描述

2.在新建項目視窗，選擇項目類型為“MFC 應用程式”，輸入項目名稱，選擇項目存儲路徑，並單擊“確定”。
圖片: https://uploader.shimo.im/f/oMfNQRz84XOtr3YF.png!thumbnail?accessToken=eyJhbGciOiJIUzI1NiIsImtpZCI6ImRlZmF1bHQiLCJ0eXAiOiJKV1QifQ.eyJhdWQiOiJhY2Nlc3NfcmVzb3VyY2UiLCJleHAiOjE2NDkzNDY4NTMsImciOiIyWG8zTzdOTHhqa09pN3NVIiwiaWF0IjoxNjQ5MzQ2NTUzLCJ1c2VySWQiOjc1NzgyMTAwfQ.7oOKh_-TmLIg9_EWLDjmNZwbTsHdfDl53CZLChp1W7E

3.進入 MFC 應用程式視窗，選擇“應用程式類型”為“基於對話框”，並單擊“完成”。
在這裡插入圖片描述

3.2 導入 SDK

1.下載 SDK。

請從下載 SDK 包下載 SDK。

2.解壓 SDK，並拷貝到項目目錄下。

SDK 包含 “include” 和 “lib” 兩個目錄，每個目錄包含的文件說明如下。

include    --------------- 包含SDK頭文件
lib        --------------- 包含SDK的.lib和.dll文件
| x86   --------------- 32位版本
| x64   --------------- 64位版本

4 設置項目屬性

在解決方案資源管理器視窗中，右擊項目名稱，單擊“屬性”，進入項目屬性頁。在項目屬性頁面內進行以下配置，配置完成後單擊“確定”。
1.將 “include” 目錄加入到頭文件搜索路徑。
選擇“配置屬性 > C/C++ > 常規”菜單，在“附加包含目錄”中添加 “include” 目錄。
在這裡插入圖片描述

2.將 “lib” 目錄加入到庫搜索路徑。
選擇“配置屬性 > 鏈接器 > 常規”菜單，在“附加庫目錄”中添加 “lib/x86” 或 “lib/x64” 目錄。
在這裡插入圖片描述

3.指定鏈接庫 “ZegoExpressEngine.lib”。
選擇“配置屬性 > 鏈接器 > 輸入”菜單，在“附加依賴項”中添加 “ZegoExpressEngine.lib”。
在這裡插入圖片描述

5 實現流程

如以下流程圖，用戶A與B通過 ZEGO Express SDK 進行視頻通話，以用戶 A 拉取用戶 B 的流為例：
在這裡插入圖片描述

為保證實時音視頻的通話質量，推拉流關鍵流程需按照API的正確調用時序進行，完整時序如下圖：
在這裡插入圖片描述

5.1 創建引擎

1. 創建界面

根據場景需要，為您的項目創建視頻通話的用戶界面。我們推薦您在項目中添加如下元素：

本地視頻視窗
遠端視頻視窗
結束通話按鈕

在這裡插入圖片描述

2. 引入頭文件

在項目中引入 ZegoExpressEngine 頭文件。

// 引入 ZegoExpressEngine.h 頭文件
#include "ZegoExpressSDK.h"

3. 創建引擎

調用 createEngine 介面，將申請到的 AppID 傳入參數 “appID” 和，創建引擎單例對象。
註冊回調，可將實現了 ZegoEventHandler 的對象（例如 “self”）傳入參數 “eventHandler”。

ZegoEngineProfile profile;
// AppID 由 ZEGO 分配給各 App
profile.appID = appID;
profile.scenario = ZegoScenario::ZEGO_SCENARIO_GENERAL;
// 創建引擎實例
auto engine = ZegoExpressSDK::createEngine(profile, nullptr);

5.2 登錄房間

傳入用戶 ID 參數 “userID” 創建 ZegoUser 用戶對象後，調用 loginRoom 介面，傳入房間 ID 參數 “roomID” 和用戶參數 “user”，登錄房間。
roomID 和 user 的參數由您本地生成，但是需要滿足以下條件：

同一個 AppID 內，需保證 “roomID” 全局唯一。
同一個 AppID 內，需保證 “userID”
全局唯一，建議開發者將其設置成一個有意義的值，可將 “userID” 與自己業務賬號系統進行關聯。

// 創建用戶對象
ZegoUser user("user1", "user1");
// 只有傳入 “isUserStatusNotify” 參數取值為 “true” 的 ZegoRoomConfig，才能收到 onRoomUserUpdate 回調。
ZegoRoomConfig roomConfig;
//token 由用戶自己的服務端生成，為了更快跑通流程，也可以通過即構控制台獲取臨時的音視頻 token
roomConfig.token = "xxxx";
roomConfig.isUserStatusNotify = true;
// 登錄房間
engine->loginRoom(roomID, user, roomConfig);

調用登錄房間介面之後，您可通過監聽 onRoomStateUpdate 回調實時監控自己在本房間內的連接狀態。
只有當房間狀態是連接成功時，推流（startPublishingStream）、拉流（startPlayingStream）才能正常收發音視頻。

void VideoTalk::onRoomStateUpdate(const std::string &roomID, ZegoRoomState state, int errorCode, const std::string &extendData) {
    if (errorCode != 0) {
        // 房間狀態出錯
    }

    if (state == ZegoRoomState::ZEGO_ROOM_STATE_CONNECTED) {
        //只有當房間狀態是連接成功時，推流（startPublishingStream）、拉流（startPlayingStream）才能正常收發音視頻
        //將自己的音視頻流推送到 ZEGO 音視頻雲
    } else if (state == ZegoRoomState::ZEGO_ROOM_STATE_CONNECTING) {
        // 房間連接中
    } else if (state == ZegoRoomState::ZEGO_ROOM_STATE_DISCONNECTED) {
        // 房間連接斷開
    }
}

5.3 預覽自己的畫面，並推送到 ZEGO 音視頻雲

1. 預覽自己的畫面

設置預覽視圖並啟動本地預覽。
如果希望看到本端的畫面，可調用 startPreview 介面設置預覽視圖，並啟動本地預覽。

// 設置本地預覽視圖並啟動預覽，視圖模式採用 SDK 預設的模式，等比縮放填充整個 View
ZegoCanvas canvas((void*)view);
engine->startPreview(&canvas);

2. 將自己的音視頻流推送到 ZEGO 音視頻雲

在用戶調用 loginRoom 介面後，可以直接調用 startPublishingStream 介面，傳入 streamID，將自己的音視頻流推送到 ZEGO 音視頻雲。您可通過監聽 onPublisherStateUpdate 回調知曉推流是否成功。
streamID 由您本地生成，但是需要保證：同一個 AppID 下，“streamID” 全局唯一。如果同一個 AppID 下，不同用戶各推了一條 “streamID” 相同的流，會導致後推流的用戶推流失敗。
此處示例在調用 loginRoom 介面後立即進行推流。在實現具體業務時，您可選擇其他時機進行推流，只要保證先調用 loginRoom 即可。

// 用戶調用 loginRoom 之後再調用此介面進行推流
// 在同一個 AppID 下，開發者需要保證“streamID” 全局唯一，如果不同用戶各推了一條 “streamID” 相同的流，後推流的用戶會推流失敗。
engine->startPublishingStream("stream1");

5.4 拉取其他用戶的音視頻

進行視頻通話時，我們需要拉取到其他用戶的音視頻。
onRoomStreamUpdate：在同一房間內的其他用戶將音視頻流推送到 ZEGO 音視頻雲時，我們會在此回調中收到音視頻流新增的通知。
我們可以在該回調中，調用 startPlayingStream，傳入 “streamID” 拉取播放該用戶的音視頻。

// 房間內其他用戶推流/停止推流時，我們會在這裡收到相應流增減的通知
void VideoTalk::onRoomStreamUpdate(const std::string &roomID, ZegoUpdateType updateType, const std::vector<ZegoStream> &streamList, const std::string &extendData) {
    //當 updateType 為 ZEGO_UPDATE_TYPE_ADD 時，代表有音視頻流新增，此時我們可以調用 startPlayingStream 介面拉取播放該音視頻流
    if (updateType == ZEGO_UPDATE_TYPE_ADD) {
        // 開始拉流，設置遠端拉流渲染視圖，視圖模式採用 SDK 預設的模式，等比縮放填充整個 View
        // 如下 playView 為 UI 視窗句柄
        std::string streamID = streamList[0].streamID;
        ZegoCanvas canvas((void*)playView);
        engine->startPlayingStream(streamID , &canvas);
    }
}

恭喜，你又get一種實現音視頻通話的新技能。
ZEGO SDK助你快速搭建音視頻通話能力，10多種開發語言，4行代碼，30分鐘，玩轉多端實時通訊。同時即構每月贈送10000分鐘免費時長，可實現秀場直播、語聊房、K歌房等多種音視頻通話場景；

獲取Demo、開發文檔、技術支持，訪問即構文檔中心
SDK的優惠活動、熱門產品，