音视频通话 2.0
Windows
新手接入指南
产品简介
产品介绍
功能特性
产品优势
应用场景
基本概念
使用限制
产品计费
按量计费
资源包
更新日志
体验 Demo
下载 SDK 和 示例代码
快速开始
接入流程
创建应用
开通服务
快速跑通 Sample Code
集成 SDK
实现音视频通话
Token 鉴权
高级 Token 鉴权
基础功能
设置音频属性
设置视频属性
设置通话音量
屏幕共享
音频共享
通话前网络质量探测
监测发言者音量
通话中质量监测
进阶功能
音频管理
客户端音频录制
原始音频数据
美声变声与混响
耳返
自定义音频采集与渲染
音效与伴音
设置音频订阅优先级
音频裸流传输
媒体补充增强信息
视频管理
视频截图
水印
云信美颜
相芯美颜
自定义视频采集
虚拟背景
视频裸流传输
加入多房间
媒体流管理
媒体流加密
视频流回退
跨房间媒体流转发
云端录制
使用云代理
AI 融合功能
AI 降噪
AI 超分
AI 虚拟背景
最佳实践
房间连接状态管理
实现音视频安全检测
音视频参数配置推荐
API 参考
Windows API 参考
服务端 API
错误码
控制台指南
常见问题处理
FAQ
错题集
获取音频 Dump 文件
音频常见问题排查
视频常见问题排查
服务协议

集成 SDK

更新时间: 2023/02/21 14:04:05

本文为您介绍 Windows 端集成 SDK 的操作步骤,帮助您快速集成 SDK,可以使用音视频通话的基本功能。

前提条件

在开始运行工程之前,请您准备以下开发环境:

  • 开发环境:Microsoft Visual Studio 2017(推荐)或以上版本
  • 操作系统:Microsoft Windows 7 或以上版本
  • 编译器:Microsoft Visual C++ 2017 或以上版本

SDK 目录

目录 文件/文件夹名称 是否必选 说明
dll nertc_sdk.dll 音视频通话基础模块。
NERtcnn.dll 机器学习模块(自 V4.6.20 起提供)。
protoopp.dll 网络通信模块。
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 起提供。)
lib nertc_sdk.lib 否(使用动态加载的方式运行程序的情况下只需要 dll) 包含了函数所在的 DLL 文件和文件中函数位置的信息。
api 以实际目录中的头文件为准 API 头文件,导入后可以方便查看 API 注释

集成 NERtc SDK

步骤1 (可选)新建项目

介绍如何新建项目,如果集成到已有的项目,请忽略该步骤。
  1. 打开 Microsoft Visual Studio,单击创建新项目 ,新建一个类型为 MFC 应用的项目。

    新建MFC应用.png

  2. MFC 应用程序页面,选择应用程序类型基于对话框,单击完成

    MFC应用程序类型.png

    不同版本的 Microsoft Visual Studio,界面存在差异,本文以Visual Studio 2022版本为例,其他版本的操作请以实际界面为准。

步骤2 导入 SDK

  1. 云信 SDK 下载中心获取当前最新版本的 NERTC SDK。

    若要使用其他版本,请联系网易云信技术支持获取对应的版本号。

  2. 将解压后的 NERTC SDK 文件夹(本文以 nertc_sdk 为例)拷贝至 NERTC.vcxproj 所在目录,路径类似如下图所示。

    拷贝文件夹_windows.png

步骤3 修改工程配置

  1. 在 Microsoft Visual Studio 右侧的解决方案字样管理器区域,右键单击目标项目名称,选择属性

  2. api 文件夹添加到工程项目的 INCLUDE 目录下。

    在左侧导航栏中选择配置属性 > C/C++ > 常规,在附加包含目录中,添加 api 文件的相对路径,例如:$(ProjectDir)\nertc_sdk\api

    路径中的 nertc_sdk 请替换为实际的 NERTC SDK 文件夹名称。

    附加包含目录.png

  3. lib 文件夹添加到工程项目的 LIB 目录下。

    在左侧导航栏中选择配置属性 > 链接器 > 常规,在附加库目录中,添加 lib\x86 或 lib\x64 的相对路径,例如:$(ProjectDir)\nertc_sdk\lib\x64

    附加库目录.png

  4. 指定 nertc_sdk.lib 到项目的链接。

    在左侧导航栏中选择配置属性 > 链接器 > 输入,在附加依赖项中,输入 nertc_sdk.lib

    附加依赖项.png

  5. dll 文件夹下的文件复制到工程可执行文件所在的目录下。

    在左侧导航栏中选择生成事件 > 生成后事件 > 命令行,添加拷贝命令 copy /y $(ProjectDir)\nertc_sdk\dll\x64\* $(OutDir)copy /y $(ProjectDir)\nertc_sdk\dll\x86\* $(OutDir)。在编译完成后,自动将 SDK dll 文件夹下的所有文件拷贝到程序的运行目录下。

    copy命令.png

  • 自 V4.6.20 版本起,/dll 目录下的动态库包括美颜等可选库,如果您的业务对包体积大小有要求,请按需拷贝到对应的动态库,具体请参考 SDK 目录
  • 修改工程配置中的步骤需要分别设置 Debug 和 Release 模式下的配置。请在配置菜单中分别选择活动(Debug)发布(Release),重复以上配置。

步骤4 执行编译

右键单击项目名称,选择生成

后续步骤

实现音视频通话

此文档是否对你有帮助?
有帮助
我要吐槽
  • 前提条件
  • SDK 目录
  • 集成 NERtc SDK
  • 步骤1 (可选)新建项目
  • 步骤2 导入 SDK
  • 步骤3 修改工程配置
  • 步骤4 执行编译
  • 后续步骤