互联网发展至今，实时视频和语音通话越来越被大众所依赖。
今天，我们将会继续介绍如何基于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 应用程序”，输入项目名称，选择项目存储路径，并单击“确定”。
3.进入 MFC 应用程序窗口，选择“应用程序类型”为“基于对话框”，并单击“完成”。
[图片上传失败...(image-59d03e-1649385784146)]
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” 目录。
[图片上传失败...(image-af939-1649385784146)]
2.将 “lib” 目录加入到库搜索路径。
选择“配置属性 > 链接器 > 常规”菜单，在“附加库目录”中添加 “lib/x86” 或 “lib/x64” 目录。
[图片上传失败...(image-785606-1649385784146)]
3.指定链接库 “ZegoExpressEngine.lib”。
选择“配置属性 > 链接器 > 输入”菜单，在“附加依赖项”中添加 “ZegoExpressEngine.lib”。
[图片上传失败...(image-d6abe7-1649385784146)]
5 实现流程
如以下流程图，用户A与B通过 ZEGO Express SDK 进行视频通话，以用户 A 拉取用户 B 的流为例：
[图片上传失败...(image-addc56-1649385784146)]
为保证实时音视频的通话质量，推拉流关键流程需按照API的正确调用时序进行，完整时序如下图：
[图片上传失败...(image-378eb0-1649385784146)]
5.1 创建引擎
1. 创建界面
根据场景需要，为您的项目创建视频通话的用户界面。我们推荐您在项目中添加如下元素：
- 本地视频窗口
- 远端视频窗口
- 结束通话按钮
[图片上传失败...(image-24d10f-1649385784146)]
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的优惠活动、热门产品，👉点击联系商务；
注册即构ZEGO开发者帐号，快速开始...
网友评论