【AICon】探索RAG 技术在实际应用中遇到的挑战及应对策略!AICon精华内容已上线73%>>> 了解详情
写点什么

基于 Agora SDK 实现 Windows 端的一对一视频通话

  • 2020-02-25
  • 本文字数:3741 字

    阅读完需:约 12 分钟

基于 Agora SDK 实现 Windows 端的一对一视频通话

前提条件

  • Microsoft Visual Studio 2017 或以上版本

  • 支持 Windows 7 或以上版本的 Windows 设备

  • 有效的 Agora 账户(免费注册)


注:如果你的网络环境部署了防火墙,请根据声网文档中心的「应用企业防火墙限制」打开相关端口。

设置开发环境

本节介绍如何创建项目,并将 Agora SDK 集成至你的项目中。

创建 Windows 项目

参考以下步骤创建一个 Windows 项目。若已有 Windows 项目,直接查看集成 SDK。

创建 Windows 项目

1.打开 Microsoft Visual Studio 并点击新建项目。


2.进入新建项目窗口,选择项目类型为 MFC 应用程序,输入项目名称,选择项目存储路径,并点击确认。


3.进入 MFC 应用程序窗口,选择应用程序类型为基于对话框,并点击完成。

集成 SDK

参考以下步骤将 Agora SDK 集成到你的项目中。

1. 配置项目文件

  • 根据应用场景,从 官网获取最新 SDK,解压并打开。

  • 将下载包中的 sdk 文件夹复制到你的项目文件夹下。

2. 配置项目属性

在解决方案资源管理器窗口中,右击项目名称并点击属性进行以下配置,配置完成后点击确定。


  • 进入 C/C++ > 常规 > 附加包含目录菜单,点击编辑,并在弹出窗口中输入 $(SolutionDir)include。

  • 进入链接器 > 常规 > 附加库目录菜单,点击编辑,并在弹出窗口中输入 $(SolutionDir)。

  • 进入链接器 > 输入 > 附加依赖项菜单,点击编辑,并在弹出窗口中输入 agora_rtc_sdk.lib。

实现音视频通话

本节介绍如何实现音视频通话。视频通话的 API 调用时序见下图:


1. 创建用户界面

根据场景需要,为你的项目创建音视频通话的用户界面。若已有用户界面,可以直接初始化 IRtcEngine。


如果你想实现一个视频通话,我们推荐你添加如下 UI 元素:


  • 本地视频窗口

  • 远端视频窗口

  • 结束通话按钮


当你使用示例项目中的 UI 设计时,你将会看到如下界面:


2. 初始化 IRtcEngine

在调用其他 Agora API 前,需要创建并初始化 IRtcEngine 对象。


你需要在该步骤中填入项目的 App ID。请参考如下步骤在控制台(console.agora.io)创建 Agora 项目并获取 App ID:


1.登录控制台,点击左侧导航栏的项目管理图标 。


2.点击创建,按照屏幕提示设置项目名,选择一种鉴权机制,然后点击提交。


3.在项目管理页面,你可以获取该项目的 App ID。


调用 createAgoraRtcEngine 和 initialize 方法,传入获取到的 App ID,即可初始化 IRtcEngine。


你还可以根据场景需要,在初始化时注册想要监听的回调事件,如本地用户加入频道,及解码远端用户视频首帧等。


CAgoraObject *CAgoraObject::GetAgoraObject(LPCTSTR lpAppId){    if (m_lpAgoraObject == NULL)        m_lpAgoraObject = new CAgoraObject();    if (m_lpAgoraEngine == NULL)        // 创建实例。        m_lpAgoraEngine = (IRtcEngine *)createAgoraRtcEngine();    if (lpAppId == NULL)        return m_lpAgoraObject;    RtcEngineContext ctx;    // 添加注册回调和事件。    ctx.eventHandler = &m_EngineEventHandler;#ifdef UNICODE    char szAppId[128];    ::WideCharToMultiByte(CP_ACP, 0, lpAppId, -1, szAppId, 128, NULL, NULL);    // 输入你的 App ID。    ctx.appId = szAppId;#else    ctx.appId = lpAppId;#endif
// 初始化 IRtcEngine。 m_lpAgoraEngine->initialize(ctx); return m_lpAgoraObject;}// 继承 IRtcEngineEventHandler 类中的回调与事件。class CAGEngineEventHandler : public IRtcEngineEventHandler{public: CAGEngineEventHandler(void); ~CAGEngineEventHandler(void); void SetMsgReceiver(HWND hWnd = NULL); HWND GetMsgReceiver() {return m_hMainWnd;}; // 注册 onJoinChannelSuccess 回调。 // 本地用户成功加入频道时,会触发该回调。 virtual void onJoinChannelSuccess(const char* channel, uid_t uid, int elapsed); // 注册 onLeaveChannel 回调。 // 本地用户成功离开频道时,会触发该回调。 virtual void onLeaveChannel(const RtcStats& stat); // 注册 onFirstRemoteVideoDecoded 回调。 // SDK 接收到第一帧远端视频并成功解码时,会触发该回调。 // 可以在该回调中调用 setupRemoteVideo 方法设置远端视图。 virtual void onFirstRemoteVideoDecoded(uid_t uid, int width, int height, int elapsed); // 注册 onUserOffline 回调。 // 远端用户离开频道或掉线时,会触发该回调。 virtual void onUserOffline(uid_t uid, USER_OFFLINE_REASON_TYPE reason);private: HWND m_hMainWnd;};
复制代码

3. 设置本地视图

如果你想实现一个语音通话,可以直接跳过这一步,查看下一步「加入频道」。


成功初始化 IRtcEngine 对象后,需要在加入频道前设置本地视图,以便在通话中看到本地图像。参考以下步骤设置本地视图:


  • 调用 enableVideo 方法启用视频模块。

  • 调用 setupLocalVideo 方法设置本地视图。


// 启用视频模块。m_lpAgoraObject->GetEngine()->enableVideo();// 设置本地视图。VideoCanvas vc;vc.uid = 0;vc.view = m_wndLocal.GetSafeHwnd();vc.renderMode = RENDER_MODE_FIT;m_lpAgoraObject->GetEngine()->setupLocalVideo(vc);
复制代码

4. 加入频道

完成初始化和设置本地视图后(视频通话场景),你就可以调用 joinChannel 方法加入频道。你需要在该方法中传入如下参数:


  • channelName: 传入能标识频道的频道 ID。输入频道 ID 相同的用户会进入同一个频道。

  • token:传入能标识用户角色和权限的 Token。可设为如下一个值:


注:若项目已启用 App 证书,请使用 Token。


  • NULL

  • 临时 Token。临时 Token 服务有效期为 24 小时。你可以在控制台里生成一个临时 Token,详情请在文档中心搜索「获取临时 Token」。

  • 在你的服务器端生成的 Token。在安全要求高的场景下,我们推荐你使用此种方式生成的 Token。

  • uid: 本地用户的 ID。数据类型为整型,且频道内每个用户的 uid 必须是唯一的。若将 uid 设为 0,则 SDK 会自动分配一个 uid,并在 onJoinChannelSuccess 回调中报告。


更多的参数设置注意事项请参考声网文档中心 joinChannel 接口中的参数描述。


// 加入频道。BOOL CAgoraObject::JoinChannel(LPCTSTR lpChannelName, UINT nUID,LPCTSTR lpToken){    int nRet = 0;#ifdef UNICODE    CHAR szChannelName[128];    ::WideCharToMultiByte(CP_UTF8, 0, lpChannelName, -1, szChannelName, 128, NULL, NULL);    char szToken[128];    ::WideCharToMultiByte(CP_UTF8, 0, lpToken, -1, szToken, 128, NULL, NULL);    if(0 == _tcslen(lpToken))        nRet = m_lpAgoraEngine->joinChannel(NULL, szChannelName, NULL, nUID);    else        nRet = m_lpAgoraEngine->joinChannel(szToken, szChannelName, NULL, nUID);#else    if(0 == _tcslen(lpToken))        nRet = m_lpAgoraEngine->joinChannel(NULL, lpChannelName, NULL, nUID);    else        nRet = m_lpAgoraEngine->joinChannel(lpToken, lpChannelName, NULL, nUID);#endif    if (nRet == 0)        m_strChannelName = lpChannelName;    return nRet == 0 ? TRUE : FALSE;}
复制代码

5. 设置远端视图

视频通话中,通常你也需要看到其他用户。在加入频道后,可通过调用 setupRemoteVideo 方法设置远端用户的视图。


远端用户成功加入频道后,SDK 会触发 onFirstRemoteVideoDecoded 回调,该回调中会包含这个远端用户的 uid 信息。在该回调中调用 setupRemoteVideo 方法,传入获取到的 uid,设置远端用户的视图。


// SDK 接收到第一帧远端视频并成功解码时,会触发该回调。// 在该回调中调用 setupRemoteVideo 方法设置远端视图。LRESULT CAgoraTutorialDlg::OnFirstRemoteVideoDecoded(WPARAM wParam, LPARAM lParam){    LPAGE_FIRST_REMOTE_VIDEO_DECODED lpData = (LPAGE_FIRST_REMOTE_VIDEO_DECODED)wParam;    VideoCanvas vc;    vc.renderMode = RENDER_MODE_FIT;    vc.uid = lpData->uid;    vc.view = m_wndRemote.GetSafeHwnd();    // 设置远端视图。    m_lpAgoraObject->GetEngine()->setupRemoteVideo(vc);    delete lpData;    return 0;}
复制代码

6. 离开频道

根据场景需要,如结束通话、关闭 App 或 App 切换至后台时,调用 leaveChannel 离开当前通话频道。


BOOL CAgoraObject::LeaveChannel(){    m_lpAgoraEngine->stopPreview();    // 离开频道。    int nRet = m_lpAgoraEngine->leaveChannel();    return nRet == 0 ? TRUE : FALSE;} void CAgoraObject::CloseAgoraObject(){    if(m_lpAgoraEngine != NULL)        // 释放 IRtcEngine 对象。        m_lpAgoraEngine->release();    if(m_lpAgoraObject != NULL)        delete m_lpAgoraObject;    m_lpAgoraEngine = NULL;    m_lpAgoraObject = NULL;}
复制代码

示例代码

你可以在 Agora-Windows-Tutorial-1to1 示例项目的 AgoraTutorialDlg.cpp 文件中查看完整的源码和代码逻辑。


Github :https://github.com/AgoraIO/Basic-Video-Call/tree/master/One-to-One-Video/Agora-Windows-Tutorial-1to1

运行项目

你可以在 Windows 设备中运行此项目。当你成功开始视频通话时,你可以同时看到本地和远端的视图。


本文转载自声网 Agora 公众号。


原文链接:https://mp.weixin.qq.com/s/Nm06auw3qb5MMiJ-zn3Eog


2020-02-25 15:17598

评论

发布
暂无评论
发现更多内容

数据库事务的三个元问题

Zilliz

数据库 数据库设计

前端开发:npm run serve和npm run dev的区别

三掌柜

28天写作 21天挑战 12月日更

这套神奇的个人信息管理系统,带我一步步进入互联网大厂

博文视点Broadview

Android C++系列:Linux网络(三)协议格式

轻口味

c++ android 28天写作 12月日更

大厂面试算法题之数组

程序员学长

数据结构 算法 大厂面试

为啥你写的代码老有大串的if/else?

华为云开发者联盟

代码 if for循环 else

双 11 大促会场开发提效解析:前端智能化落地实践

凹凸实验室

机器学习 大前端 智能代码

CANN5.0黑科技解密 | 高并发图片视频处理,为出行保驾,为生活添彩!

华为云开发者联盟

高并发 图像预处理 CANN 昇腾 异构计算

前端性能优化 24 条建议

编程江湖

大前端

Java开发之环境搭建基础教程

@零度

Java 开发环境搭建

<<活法>>读后感

Tiger

28天写作

Java 程序员必须掌握的 10 款开源工具

编程江湖

java编程 java开发工具

从 0-15 套存储集群,YRCloudFile 助力 AI 训练效率“超线性增长”

焱融科技

人工智能 云计算 分布式 高性能 文件存储

进程崩溃/应用卡死,故障频频怎么办?|HDC2021技术分论坛

HarmonyOS开发者

HarmonyOS

高并发多方案秒杀架构

MetaThoughts

10年经验总结,华为fellow教你如何成为一名优秀的架构师?

华为云开发者联盟

架构设计 架构师 华为fellow 云服务运维

极光笔记|基于CMPP协议集成短信测试桩全流程实践分享

极光JIGUANG

前端开发之Vue 技术栈编写表单组件

@零度

Vue 前端开发

Linux运维,Linux系统学习

侠盗安全

Linux linux运维 运维工程师 云计算架构师

全链路数据血缘在满帮的实践

华为云开发者联盟

sql 图数据库 图计算 全链路数据血缘 数据血缘

DataPipeline与TiDB推出异构数据实时同步解决方案,共筑安全可信基础设施

DataPipeline数见科技

数据库 大数据 中间件 数据融合 数据管理

安全办公 |企业级IM即时通讯私有云解决方案

WorkPlus

MySQL性能测试之select&update【FunTester框架】

FunTester

MySQL 性能测试 测试框架 FunTester FunTester框架

Python enumerate():使用计数器简化循环

华为云开发者联盟

Python 变量 计数器 循环 enumerate

【干货分享】研效优化实践:AI算法助力深层BUG挖掘

WeTest

恒拓高科WorkPlus助力南兴装备移动数字化升级

WorkPlus

科创人·StreamNative翟佳:开源模式价值为王,基础软件的未来在国内社区

科创人

如期而至-用户购买时间预测(下)

索信达控股

模型 购买预测 购买行为 精准营销

一文读懂 Apache Pulsar

晓双

云原生 Apache Pulsar 消息系统 数据流 Apache Pulsar 社区

让工具成为双手的延伸

Zilliz

数据库 书籍推荐 程序 书籍

浅谈服务网关和联邦云

星环科技

联邦云 服务网关

基于 Agora SDK 实现 Windows 端的一对一视频通话_文化 & 方法_声网_InfoQ精选文章