跑通示例项目

声网在 GitHub 上提供开源的视频通话示例项目。本文介绍如何快速跑通多人视频通话的两个示例项目 OpenVideoCall-Windows-MFC（基于 MFC） 和 OpenVideoCall-Windows（基于 Qt），体验声网视频互动直播。

获取 App ID 和 Token

1. 创建声网项目

参考以下步骤创建一个声网项目：

1. 进入声网控制台的项目管理页面。
2. 在项目管理页面，点击创建按钮。
3. 在弹出的对话框内输入项目名称、使用场景，依次选择场景标签和鉴权机制。其中鉴权机制推荐选择安全模式，调试模式的安全性较低。
4. 点击提交按钮。新建的项目会显示在项目管理页中。

2. 获取声网项目的 App ID

声网会给每个项目自动分配一个 App ID 作为项目唯一标识。

在声网控制台的项目管理页面，找到你的项目，点击 App ID 右侧的 图标，即可获取项目的 App ID。

3. 生成临时 Token

为提高项目的安全性，声网推荐使用 Token 对即将加入频道的用户进行鉴权。

为了方便测试，声网控制台提供生成 RTC 临时 Token 的功能。参考以下步骤获取 RTC 临时 Token：

1. 在控制台的项目管理页面，找到你的项目，点击配置。
   
2. 在主要证书下面，点击生成临时音视频 token。
   
3. 输入一个频道名，例如 testroom，然后点击生成。后续调用 API 加入频道时，请确保填入的频道名与这里的频道名一致。
   
4. 点击复制图标，即可复制生成的临时 token。

跑通基于 Qt 的示例项目

前提条件

• 操作系统：Windows 7 或更高版本
• IDE：基于 Qt 5.6 或更高版本的 Qt Creator

集成 SDK

1. 将 Basic-Video-Call 仓库拉取到本地。进入 Group-Video\OpenVideoCall-Windows 目录。

2. 下载最新版本的视频 SDK，解压后进行以下操作：

   1. 在 OpenVideoCall-Windows 下创建一个 文件夹 sdk，在 sdk 文件夹下创建两个文件夹：include和 lib。
   2. 把 libs\include 中的所有 .h 文件复制到 OpenVideoCall-Windows\sdk\include 目录下。
   3. 把 libs\x86或 libs\x86_64 目录及所有文件复制到 OpenVideoCall-Windows\sdk\lib 目录下。

操作步骤

1. 在 OpenVideoCall-Windows 下，使用 Qt creator 打开 OpenVideoCall-Windows 下的 OpenVideoCall.pro 文件。
2. 点击 Projects，在 Build&Run 下选择构建工具。例如 x86-windows-msvc0217-pe-64bit 或 x86-windows-msvc0217-pe-32bit。
3. 点击 Edit，打开 Headers/agoraobject.h，将 APP_ID 和 APP_TOKEN 的值替换为你的 App ID 和 Token。
4. 选择 Release 作为构建选项，点击构建 按钮进行构建。
5. 构建完成后，点击运行 按钮运行项目。 在 OpenVideoCall 界面上输入频道名并选择角色，点击 joinChannel 即可加入频道。

示例项目结构

下表列出示例项目在 Qt Creator 中的代码结构，你可以参考示例项目的代码，根据自己的需求进行调整。

跑通基于 MFC 的示例项目

前提条件

• 操作系统：Windows 7 或更高版本
• IDE：Visual Studio 2017 或更高版本

集成 SDK

1. 将 Basic-Video-Call 仓库拉取到本地。在 Group-Video\OpenVideoCall-Windows-MFC 下创建一个 文件夹 sdk，在 sdk 文件夹下创建三个文件夹：include，dll，和 lib。

2. 下载最新版本的视频 SDK，解压后进行以下操作：

   1. 把 libs\include 中的所有 .h 文件复制到 OpenVideoCall-Windows-MFC\sdk\include 目录下。
   2. 把 libs\x86\agora_rtc_sdk.dll 或 libs\x86_64\agora_rtc_sdk.dll 复制到 OpenVideoCall-Windows-MFC\sdk\dll 目录下。
   3. 把 libs\x86\agora_rtc_sdk.lib 或 libs\x86_64\agora_rtc_sdk.lib 复制到 OpenVideoCall-Windows-MFC\sdk\lib 目录下。

操作步骤

1. 在 OpenVideoCall-Windows-MFC 目录下，使用 Visual Studio 中打开 OpenVideoCall.sln。
2. 在解决方案资源管理器中，选择 OpenVideoCall >> AgoraObject >> AgoraObject.h。将 APP_ID_T 和 APP_TOKEN 的值替换为你的 App ID 和 Token。
3. 在解决方案资源管理器中，鼠标右键点击解决方案名称，选择生成解决方案。
4. 编译完成后，按 <F5> 运行程序。在 OpenVideoCall 界面上输入频道名并选择角色，点击 Join 即可加入频道。

示例项目结构

下表列出示例项目在 Visual Studio 解决方案管理器中的代码结构，你可以参考示例项目的代码，根据自己的需求进行调整。