互联网发展至今,实时视频和语音通话越来越被大众所依赖。

今天,我们将会继续介绍如何基于ZEGO SDK实现音视频通话功能,前两篇文章分别介绍了Android,Flutter平台的实现方式,感兴趣的小伙伴可点击了解: AndroidFlutter

接下来,我们将会一起开发一个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的优惠活动、热门产品,👉点击联系商务

注册即构ZEGO开发者帐号,快速开始...