返回

轻松掌握 Agora SDK 集成,打造流畅的一对一视频通话应用程序

前端

创建应用程序需要一个可执行的项目,项目中需要集成 Agora SDK。本文将以 Windows 为例,一步一步指导你创建项目并集成 SDK,助你轻松实现一对一视频通话功能。

准备工作

在开始之前,你需要准备以下工具和资源:

  • Visual Studio 2017 或更高版本
  • Agora SDK for Windows
  • 文本编辑器
  • 开发环境

项目创建

  1. 打开 Visual Studio,选择“文件”菜单,然后点击“新建” > “项目”。
  2. 在“新建项目”对话框中,选择“Windows 桌面”模板,然后输入项目名称和位置。
  3. 选择“确定”创建项目。

Agora SDK 集成

  1. 下载 Agora SDK for Windows。
  2. 将 Agora SDK 复制到你的项目文件夹中。
  3. 在 Visual Studio 中,右键单击项目,然后选择“添加” > “现有项”。
  4. 导航到 Agora SDK 文件夹,选择“agora-sdk-3.6.2-full.dll”和“agora-sdk-3.6.2-full.lib”文件,然后选择“添加”。
  5. 在 Visual Studio 中,打开项目文件(.vcxproj)。
  6. 找到 <PropertyGroup> 节点,并在其中添加以下内容:
<AdditionalLibraryDirectories>$(ProjectDir)Agora SDK\libs</AdditionalLibraryDirectories>
  1. 找到 <ItemGroup> 节点,并在其中添加以下内容:
<Reference Include="agora-sdk-3.6.2-full">
  <HintPath>$(ProjectDir)Agora SDK\libs\agora-sdk-3.6.2-full.dll</HintPath>
</Reference>
  1. 保存项目文件。

代码编写

接下来,你需要在项目中编写代码来使用 Agora SDK。具体步骤如下:

  1. 在 Visual Studio 中,创建一个新的源文件(.cpp文件)。
  2. 在源文件中,添加以下代码:
#include <agora/IAgoraRtcEngine.h>
#include <stdio.h>

// Agora SDK 对象
IAgoraRtcEngine* rtcEngine = NULL;

// 频道名
const char* channelName = "YourChannelName";

// 频道密钥
const char* channelKey = "YourChannelKey";

// 用户 ID
const int uid = 0;

// 加入频道
int joinChannel() {
  // 创建 Agora SDK 对象
  rtcEngine = createAgoraRtcEngine();

  // 初始化 Agora SDK
  rtcEngine->initialize("YourAgoraAppId");

  // 加入频道
  rtcEngine->joinChannel(channelKey, channelName, uid, NULL);

  return 0;
}

// 离开频道
int leaveChannel() {
  // 离开频道
  rtcEngine->leaveChannel();

  // 销毁 Agora SDK 对象
  rtcEngine->release();

  return 0;
}

int main() {
  // 加入频道
  joinChannel();

  // 等待一段时间
  Sleep(10000);

  // 离开频道
  leaveChannel();

  return 0;
}
  1. 保存源文件。

运行应用程序

  1. 在 Visual Studio 中,选择“生成” > “生成解决方案”。
  2. 生成完成后,找到可执行文件(.exe文件),并双击运行。

结语

通过本文,你已经学会了如何在 Windows 中集成 Agora SDK,并创建了一对一视频通话应用程序。Agora SDK 还有许多其他功能,你可以进一步探索和使用,打造更加丰富的应用程序。