快速开始 Demo 是 RTC 提供的基本音视频通话功能的开源示例工程文件。获取该工程文件后，你可以快速构建应用，感受 RTC 的通话效果；也能通过阅读代码，了解基本音视频通话的最佳实践。

使用该工程文件构建应用后，你可以使用该应用实现基本音视频通话功能。

你和你的同事必须使用同一 Appid 且加入同一个房间，才能成功进行音视频通话。

• Windows 7+，建议 Windows 10 系统
• Visual Studio 2017+
• Qt 5.9+
• Visual Studio 版本对应 Qt 运行环境（如 Visual Studio 2017 对应 msvc 2017）
• cmake 3.14+
• 使用 C++ 作为开发语言，支持 C++ 11 版本
• 已获取 RTC 快速开始 Demo 工程文件

配置 QT 环境变量 Qt32Path、Qt64Path。

Qt32Path、Qt64Path 变量的值为你 QT 安装路径下对应的 cmake 文件夹路径。

关于在控制台获取 AppId 和临时 Token，参看获取 Appid。

临时 Token 生成时填写的房间 ID 和用户 ID 与 Demo 登陆页的房间 ID 和用户 ID 一致，若输入的房间 ID 或用户 ID 不一致，将无法进入正确房间与其他用户进行音视频通话。。
临时 Token 仅用于测试或跑通 Demo，你可以通过阅读密钥说明了解更多 Token 相关。

1. 打开 cmd 窗口下，进入 QuickStart_WindowsDemo 目录，执行 cmake -G "Visual Studio 17" -Bbuild_win -A "Win32"（32 位）或cmake -G "Visual Studio 17" -Bbuild_win -A "x64"（64位）命令，在 build_win 目录下生成工程。

命令 cmake -G "Visual Studio 17" -Bbuild_win中的 17 对应 Visual Studio 2022 版本。使用 Visual Studio 2019 时，该值为 16，使用 Visual Studio 2017 时，该值为 15。Visual Studio 各版本对应版本号可参考：Visual Studio 内部版本号和发布日期。

2. 进入 QuickStart_WindowsDemo.build_win 目录，使用 Visual Studio 打开工程文件 QuickStart.sln。

3. 修改 AppID。
   使用在控制台获取的 AppId 覆盖 sources 文件夹下 Constants.h 里 APP_ID 的值。
4. 修改 TOKEN。
   使用在控制台获取的临时 Token 覆盖 sources 文件夹下 Constants.h 里 TOKEN 的值。

点击上方菜单栏【调试】-> 【开始调试】运行。

运行开始界面如下：

1. 生成工程失败，提示

CMake Warning at CMakeLists.txt:14 (FIND_PACKAGE):
By not providing "FindQt5Widgets.cmake" in CMAKE_MODULE_PATH this project
has asked CMake to find a package configuration file provided by
"Qt5Widgets", but CMake did not find one.

• 检查环境变量是否正确填写
• 确认 QT 版本为 5.9+。如果你的 QT 版本为 6+，请将 QuickStart_WindowsDemo\CMakeLists.txt 中的 Qt5 替换为 Qt6

2. 点击调试后，提示找不到 all_build。
   Visual Studio 默认 all_build 项目为启动项，需将 Quickstart 设为启动项。

3. Demo 运行后，出现错误弹窗。
   SDK 内部遇到不可恢复的错误。错误码详情，请参看：错误码。

4. 快速开始 Demo 跑通后，两个测试设备距离较近会产生啸叫。
   通信两端的设备在同一房间内，且处于公放状态，连环增益大于 1 时会产生近场啸叫，与 demo 本身无关。请将各测试设备保持一定距离。