集成SDK
更新时间: 2024/08/05 15:02:55
本文为您介绍 Windows 端集成 SDK 的操作步骤,帮助您快速集成 SDK,可以使用互动直播的基本功能。
前提条件
在开始运行工程之前,请您准备以下开发环境:
- 开发环境:Microsoft Visual Studio 2017(推荐)或以上版本
- 操作系统:Microsoft Windows 7 或以上版本
- 编译器:Microsoft Visual C++ 2017 或以上版本
SDK 目录
目录 | 文件/文件夹名称 | 是否必选 | 说明 |
---|---|---|---|
dll | nertc_sdk.dll | 是 | 音视频通话基础模块。 |
protoopp.dll |
|
网络通信模块。 |
|
NERtcnn.dll |
|
机器学习模块(自 V4.6.20 起提供)。
|
|
libfreetype-6.dll | 否(纯音频包非必选) | 视频相关模块。 | |
libjpeg-9.dll | |||
libpng16-16.dll | |||
libtiff-5.dll | |||
libwebp-7.dll | |||
SDL2.dll | |||
SDL2_image.dll | |||
SDL2_ttf.dll | |||
video_render.fxo | |||
NERtcBeauty.dll | 否 | 美颜插件(自 V4.6.20 起提供)。 | |
NERtcFaceDetect.dll | 否 | 人脸检测插件(自 V4.6.20 起提供)。 | |
NERtcPersonSegment.dll | 否 | 虚拟背景插件(自 V4.6.20 起提供)。 | |
NERtcAiDenoise.dll | 否 | AI 降噪插件(自 V4.6.40 起提供。) | |
NERtcAiHowling.dll | 否 | AI 啸叫检测插件(自 V4.6.40 起提供。) | |
NERtcFaceEnhance.dll | 否 | 人脸增强插件(自 V5.3.0 起提供。) | |
NERtcVideoDenoise.dll | 否 | 视频降噪插件(自 V5.3.0 起提供。) | |
NERtcSuperResolution.dll | 否 | 视频 AI 超分插件(自 V5.3.0 起提供。) | |
NERtcScreenShareEnhance.dll | 否 | AI 啸叫检测插件(自 V5.3.0 起提供。) | |
lib | nertc_sdk.lib | 否(使用动态加载的方式运行程序的情况下只需要 dll) | 包含了函数所在的 DLL 文件和文件中函数位置的信息。 |
api | 以实际目录中的头文件为准 | 否 | API 头文件,导入后可以方便查看 API 注释 |
集成 NERtc SDK
步骤1 (可选)新建项目
介绍如何新建项目,如果集成到已有的项目,请忽略该步骤。
-
打开 Microsoft Visual Studio,单击创建新项目 ,新建一个类型为 MFC 应用的项目。
-
在 MFC 应用程序页面,选择应用程序类型为基于对话框,单击完成。
不同版本的 Microsoft Visual Studio,界面存在差异,本文以Visual Studio 2022版本为例,其他版本的操作请以实际界面为准。
步骤2 导入 SDK
-
在云信 SDK 下载中心获取当前最新版本的 NERTC SDK。
若要使用其他版本,请联系网易云信技术支持获取对应的版本号。
-
将解压后的 NERTC SDK 文件夹(本文以 nertc_sdk 为例)拷贝至 NERTC.vcxproj 所在目录,路径类似如下图所示。
步骤3 修改工程配置
-
在 Microsoft Visual Studio 右侧的解决方案字样管理器区域,右键单击目标项目名称,选择属性。
-
将 api 文件夹添加到工程项目的 INCLUDE 目录下。
在左侧导航栏中选择配置属性 > C/C++ > 常规,在附加包含目录中,添加 api 文件的相对路径,例如:
$(ProjectDir)\nertc_sdk\api
。路径中的
nertc_sdk
请替换为实际的 NERTC SDK 文件夹名称。 -
将 lib 文件夹添加到工程项目的 LIB 目录下。
在左侧导航栏中选择配置属性 > 链接器 > 常规,在附加库目录中,添加 lib\x86 或 lib\x64 的相对路径,例如:
$(ProjectDir)\nertc_sdk\lib\x64
。 -
指定 nertc_sdk.lib 到项目的链接。
在左侧导航栏中选择配置属性 > 链接器 > 输入,在附加依赖项中,输入 nertc_sdk.lib。
-
将 dll 文件夹下的文件复制到工程可执行文件所在的目录下。
在左侧导航栏中选择生成事件 > 生成后事件 > 命令行,添加拷贝命令
copy /y $(ProjectDir)\nertc_sdk\dll\x64\* $(OutDir)
或copy /y $(ProjectDir)\nertc_sdk\dll\x86\* $(OutDir)
。在编译完成后,自动将 SDK dll 文件夹下的所有文件拷贝到程序的运行目录下。- 自 V4.6.20 版本起,
/dll
目录下的动态库包括美颜等可选库,如果您的业务对包体积大小有要求,请按需拷贝到对应的动态库,具体请参考 SDK 目录。 - 修改工程配置中的步骤需要分别设置 Debug 和 Release 模式下的配置。请在配置菜单中分别选择活动(Debug)和发布(Release),重复以上配置。
- 自 V4.6.20 版本起,
步骤4 执行编译
右键单击项目名称,选择生成。