macOS
集成 SDK（纯音频）
更新时间： 2025/06/11 16:45:39
本文为您介绍了 macOS 端集成网易云信音视频通话 2.0 NERTC SDK 的操作步骤，帮助您快速集成 SDK 并实现实时音频通话的基本功能。
准备工作
在开始运行工程之前，请您准备以下开发环境：
- Xcode 11 及以上版本。
- mac OS X 10.11 或以上版本的 Mac 设备。
- 项目已配置有效的开发者签名。
获取 SDK
网易云信音视频通话 2.0 NERTC SDK 提供了以下两种方式获取纯音频 SDK，版本更新内容请参考 更新日志：
- 方式一：您可以在 SDK 下载中心 获取最新的 NERTC SDK 并查看版本号。集成方式请参考下文 手动集成。
- 方式二：若要使用其他版本，例如特殊版本或者定制版本，请 提交工单 联系网易云信技术支持工程师获取对应的版本号。
若您对包体积大小有要求，推荐您集成 4.6.20 及之后版本的 NERTC SDK，实现以插件化的方式按需集成动态库。
动态库
SDK 目录中的每一个 xcframework 都代表着动态库，包括基础库和特色库。以插件化的方式按需集成动态库，有助于您减轻包体积。例如：
- 您只集成音视频能力可以只接入
nertc_sdk_Mac.xcframework。 - 您要实现美颜功能则可以只接入
nertc_sdk_Mac.xcframework、NERtcBeauty.xcframework、NERtcFaceDetect.xcframework、NERtcnn.xcframework。
NERTC SDK 详细的动态库介绍如下表所示：
.framework 文件后缀名修改为 .xcframework。如果您采用 手动集成 方式集成 NERTC SDK，并从低版本升级至 5.6.50 及以上，请重新添加 XCFramework 依赖。
| 文件/文件夹名称 | subspecs 值 |
功能/插件名 | 必选？ |
版本变化 |
|---|---|---|---|---|
| nertc_sdk_Mac.xcframework | RtcBasic |
音视频库（必选基础库） | ✔️ | 一直提供 |
| NERtcnn.xcframework | Nenn |
神经网络库
|
- | 4.6.20 起提供 |
| NERtcAiDenoise.xcframework | AiDenoise |
音频 AI 降噪库，需搭配 NERtcnn.xcframework 使用 |
- | 4.6.40 起提供 |
| NERtcAiHowling.xcframework | AiHowling |
AI 啸叫检测库，需搭配 NERtcnn.xcframework 使用，M1 芯片的 Mac 设备暂不支持此功能 |
- | 4.6.40 起提供 |
| NERtcAudio3D.xcframework | SpatialSound |
空间音效插件 | - | 5.4.0 起提供 |
| 文件/文件夹名称 | subspecs 值 |
功能/插件名 | 必选？ |
版本变化 |
|---|---|---|---|---|
| nertc_sdk_Mac.framework | RtcBasic |
音视频库（必选基础库） | ✔️ | 一直提供 |
| NERtcnn.framework | Nenn |
神经网络库
|
- | 4.6.20 起提供 |
| NERtcAiDenoise.framework | AiDenoise |
音频 AI 降噪库，需搭配 NERtcnn.framework 使用 |
- | 4.6.40 起提供 |
| NERtcAiHowling.framework | AiHowling |
AI 啸叫检测库，需搭配 NERtcnn.framework 使用，M1 芯片的 Mac 设备暂不支持此功能 |
- | 4.6.40 起提供 |
| NERtcAudio3D.framework | SpatialSound |
空间音效插件 | - | 5.4.0 起提供 |
创建项目
本步骤是可选步骤，如果您需要集成到已有的项目，请忽略该步骤。单击展开查看创建 XCode 新项目的步骤。
-
在 XCode 里，依次选择 Create a New XCode Project > Single View App > Next 新建工程。
-
配置工程相关信息和合适的工程本地路径，单击 Next。
手动集成
-
前往 网易云信 SDK 下载中心 下载 SDK。
-
将解压之后的
xx.xcframework后缀的文件加入到工程目录下。- 不同版本的动态库有差异，请以实际为准，具体请参考 SDK 目录。
- 若您对包体积大小有要求，请集成 4.6.20 及之后版本的 NERTC SDK，您可以通过插件化的方式按需集成动态库。
- 若您集成的 NERTC SDK 为 V4.6.20 之前的版本，请直接将解压之后的
NEFundation_Mac.xcframework和nertc_sdk_Mac.xcframework文件加入到工程路径下。
-
打开 Xcode，在左侧导航栏中选择目标 Target，单击 Build Phases 页签，在 Link Binary with Libraries 区域，单击 + 添加相应的 xcframework 动态库，待添加的动态库请参考上文 动态库。
-
将 Embed 属性设置为 Embed & Sign，保证 SDK 动态库和应用签名保持一致。
-
设置签名和添加设备权限，具体请参考 设置签名并添加媒体设备权限。
在手动导入 SDK 的情况下，由于 SDK 包含模拟器版本，会导致打包失败。所以需要在打包之前将模拟器版本剥去，具体步骤参考 应用打包前剥离模拟器版本。
设置签名并添加媒体设备权限
-
使用 SDK 提供的音视频功能，需要给 App 授权麦克风、摄像头和 Wi-Fi 的使用权限。
在
info.plist中添加以下三项：-
Privacy - Microphone Usage Description，并填入麦克风使用目的提示语。
-
Application uses Wi-Fi，设置为 YES。
-
-
设置签名。
-
在 Xcode 中，依次选择 TARGETS > Project Name，单击 Signing & Capabilities 页签，勾选 Automatically manage signing。
-
在 Team 中选择您的开发团队。
-
-
如果 App 启用了 App Sandbox 或 Hardened Runtime，请在 Signing & Capabilities 页面的 App Sandbox 和 Hardened Runtime 区域，选择 Network 和 Audio Input 这几个选项。
