You need to enable JavaScript to run this app.
导航

Windows

最近更新时间2023.12.13 16:13:02

首次发布时间2021.10.12 20:00:32

快速开始 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 工程文件
操作步骤

步骤 1: 配置环境变量

配置 QT 环境变量 Qt32PathQt64Path

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

image

步骤 2: 获取 AppId 和临时 Token

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

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

步骤 3: 配置 Demo 工程文件

  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 内部版本号和发布日期

alt

  1. 进入 QuickStart_WindowsDemo.build_win 目录,使用 Visual Studio 打开工程文件 QuickStart.sln

image

  1. 修改 AppID。
    使用在控制台获取的 AppId 覆盖 sources 文件夹下 Constants.hAPP_ID 的值。
  2. 修改 TOKEN。
    使用在控制台获取的临时 Token 覆盖 sources 文件夹下 Constants.hTOKEN 的值。

image

步骤 4: 编译运行

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

image

运行开始界面如下:

image

演示视频
常见问题
  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
  1. 点击调试后,提示找不到 all_build
    Visual Studio 默认 all_build 项目为启动项,需将 Quickstart 设为启动项。

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

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