网易云信音视频通话 2.0 产品为您提供开源的的示例项目，您可以参考本文档快速跑通示例项目，快速在本地运行示例 Demo，体验 NERTC SDK 的实时音视频通话的效果。

前提条件

在开始运行示例项目之前，请确保您已完成以下操作：

• 已创建应用并获取 App Key。
• 已开通音视频通话 2.0 服务。
• 集成 SDK。
• 联系技术支持进行初始化配置，例如开通调试模式等。

开发环境

在开始运行示例项目之前，请确保开发环境满足以下要求：

• 开发环境：
  • Microsoft Visual Studio 2017（推荐）或以上版本
  • Qt 5.14.0及以上版本
• 操作系统：Microsoft Windows 7 或以上版本
• 编译器：Microsoft Visual C++ 2017 或以上版本

注意事项

• 跑通示例项目时，建议维持 Demo 的 baseURL 设置，如果需要基于 Demo 开发自己的应用，需要将其改为您的 App Server 业务服务端地址。
• 示例项目默认使用安全模式。但是在跑通示例项目时，您需要使用调试模式，在 NERtcSample-MultipersonCall.pro 文件中打开 UNSAFE_APPKEY 宏。此时无需传入 Token 即可加入房间。但是出于安全考虑，在应用上线前请在控制台中将指定应用的鉴权方式改回安全模式，注释该宏。

示例项目结构

项目结构中的文件说明如下：

文件夹/文件	说明
NERtcSample-MultipersonCall.pro	工程配置文件，其中包含三方库等配置。
rtc	SDK 封装，其中包含了美颜管理器、设备管理器、事件处理器等模块。
http	http 封装，其中包含了 get、post 网络请求。
view	主要包含多人视频通话上层业务逻辑。

运行示例源码

在 Demo 体验页面 下载需要体验的示例项目或 Demo 源码工程。

1. 下载 Windows 端 SDK，拷贝 api/、dll/、lib/三个文件夹到 nertc_sdk 目录下。

2. 双击 NERtcSample-MultipersonCall.pro 打开工程。

3. 在 NERtcEngine.h 中输入 appkey。

   

4. （可选）如果需要体验应用美颜效果，则需要完成以下步骤：

   1. 在 NERtcSample-MultipersonCall.pro 文件中打开 USE_BEAUTY 宏。

      如果不需要美颜效果则注释该宏。

   2. 获取相芯科技的美颜证书，并拷贝到 /CNamaSDK/auth 目录。

   3. 下载相芯科技美颜 SDK，并拷贝到 CNamaSDK/api/、CNamaSDK/dll/ 和 CNamaSDK/lib/目录。

   4. 下载相芯科技资源文件 face_beautification_v2.bundle，并拷贝到 CNamaSDK/assert 目录。

      

5. 执行 build_win32.bat 脚本，将库拷贝至 bin 目录。

6. Qt creator 中单击编译、运行程序。

常见问题

报错“程序异常结束”，应如何处理？

运行示例项目时，如果上报“程序异常结束”或以下错误，请检查 NERTC SDK 的相关库是否已拷贝到指定目录。