本文为您介绍了 macOS 端集成网易云信音视频通话 2.0 NERTC SDK 的操作步骤，帮助您快速集成 SDK 并实现实时音视频通话的基本功能。

准备工作

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

• Xcode 11 及以上版本。
• mac OS X 10.11 或以上版本的 Mac 设备。
• 项目已配置有效的开发者签名。

获取 SDK

网易云信音视频通话 2.0 NERTC SDK 提供了以下三种方式获取 SDK，版本更新内容请参考 更新日志：

• 方式一：您可以通过 CocoaPods 便捷获取 SDK。集成方式请参考下文 CocoaPods 集成。
• 方式二：您可以在 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 详细的动态库介绍如下表所示：

创建项目

本步骤是可选步骤，如果您需要集成到已有的项目，请忽略该步骤。单击展开查看创建 XCode 新项目的步骤。

1. 在 XCode 里，依次选择 Create a New XCode Project > Single View App > Next 新建工程。

   

2. 配置工程相关信息和合适的工程本地路径，单击 Next。

   

方式一：CocoaPods 集成

4.4.1 ~ 4.6.13 版本的 NERTC SDK，暂不支持 CocoaPods 集成，建议使用 方式二：手动集成。

1. 请确保您的 Mac 已经安装 Ruby 环境。

2. 安装 CocoaPods。安装 CocoaPods 的详细操作说明请参考 CocoaPods 官方文档。

   在终端窗口中输入如下命令可以安装 CocoaPods：

   sudo gem install cocoapods
   

3. 创建 Podfile 文件。

   从 Terminal 中进入您所创建项目所在路径，运行以下命令创建 Podfile 文件。

   pod init
   

4. 您可以按需选择直接使用 Podfile 集成 NERtcSDK，或在您的项目组件的 Podspec 中引入 NERtcSDK。

   方式一：编辑 Podfile 文件

   CocoaPods# platform :macos, '10.11'
   target '{YourApp}' do
   
       pod 'NERtcSDK-MacOS', '~> {version}'
   end
   

   参数	说明
   YourApp	您的 Target 名称。
   version	待集成的 NERTC SDK 版本号。具体的版本号，请参考上文 获取 SDK。

   方式二：编辑 Podspec 文件

   CocoaPodsPod::Spec.new do |{YourSpec}|
       {YourSpec}.dependency "NERtcSDK", "~> {version}"
   end
   

   参数	说明
   YourSpec	您的 Target 名称。
   version	待集成的 NERTC SDK 版本号。具体的版本号，请参考上文 获取 SDK。

   若您对包体积大小有要求，请集成 4.6.20 及之后版本的 NERTC SDK，实现以插件化的方式按需集成动态库。请参考以下代码实现：

   方式一：编辑 Podfile 文件

   CocoaPods//集成 SDK 但不使用任何插件
   # platform :macos, '10.11'
   target '{YourApp}' do
   
       pod 'NERtcSDK-MacOS', '~> {version}', :subspecs => ['RtcBasic']
   end
   

   CocoaPods//4.6.20~4.6.X 版本，集成 SDK 且使用部分插件，以美颜模块为例
   # platform :macos, '10.11'
   target '{YourApp}' do
   
       pod 'NERtcSDK-MacOS', '~> {version}', :subspecs => ['RtcBasic', 'Beauty', 'FaceDetect']
   end
   

   CocoaPods//5.3.0 及以上版本，集成 SDK 且使用部分插件，以美颜模块为例
   # platform :macos, '10.11'
   target '{YourApp}' do
   
       pod 'NERtcSDK-MacOS', '~> {version}', :subspecs => ['RtcBasic', 'Nenn', 'Beauty', 'FaceDetect']
   end
   

   CocoaPods//5.3.0 及以上版本，集成 SDK 且使用部分插件，以音频啸叫检测插件为例
   # platform :macos, '10.11'
   target '{YourApp}' do
   
       pod 'NERtcSDKAudio', '~> {version}', :subspecs => ['RtcBasic', 'Nenn', 'AiHowling']
   end
   

   以上代码中，subspecs 字段请填入待引入的动态库对应的值，取值说明请参考 SDK 动态库列表。

   方式二：编辑 Podspec 文件

   CocoaPods//集成 SDK 但不使用任何插件
   Pod::Spec.new do |{YourSpec}|
       {YourSpec}.dependency "NERtcSDK-MacOS/RtcBasic", "~> {version}"
   end
   

   CocoaPods//4.6.20~4.6.X 版本，集成 SDK 且使用部分插件，以美颜为例
   Pod::Spec.new do |{YourSpec}|
       {YourSpec}.dependency "NERtcSDK-MacOS/RtcBasic", "~> {version}"
       {YourSpec}.dependency "NERtcSDK-MacOS/Beauty", "~> {version}"
       {YourSpec}.dependency "NERtcSDK-MacOS/FaceDetect", "~> {version}"
   end
   

   CocoaPods//5.3.0 及以上版本，集成 SDK 且使用部分插件，以美颜为例
   Pod::Spec.new do |{YourSpec}|
       {YourSpec}.dependency "NERtcSDK-MacOS/RtcBasic", "~> {version}"
       {YourSpec}.dependency "NERtcSDK-MacOS/Nenn", "~> {version}"
       {YourSpec}.dependency "NERtcSDK-MacOS/Beauty", "~> {version}"
       {YourSpec}.dependency "NERtcSDK-MacOS/FaceDetect", "~> {version}"
   end
   

   CocoaPods//5.3.0 及以上版本，集成 SDK 且使用部分插件，以音频啸叫检测插件为例
   Pod::Spec.new do |{YourSpec}|
       {YourSpec}.dependency "NERtcSDKAudio/RtcBasic", "~> {version}"
       {YourSpec}.dependency "NERtcSDKAudio/Nenn", "~> {version}"
       {YourSpec}.dependency "NERtcSDKAudio/AiHowling", "~> {version}"
   end
   

   以上代码中，dependency 字段请填入待引入的动态库对应的值，取值说明请参考 SDK 动态库列表。

5. 执行以下命令查询本地库版本。

   pod search NERtcSDK-MacOS
   

6. 若不是最新版本，可以执行以下命令更新本地库版本。

   pod repo update
   

7. 执行以下命令安装 SDK。

   pod install
   

8. 设置签名和添加设备权限，具体请参考 设置签名并添加媒体设备权限。

方式二：手动集成

1. 前往 网易云信 SDK 下载中心 下载 SDK。

2. 将解压之后的 xcframework 后缀的文件加入到工程目录下。

   • 不同版本的动态库有差异，请以实际为准，具体请参考 SDK 目录。
   • 若您对包体积大小有要求，请集成 4.6.20 及之后版本的 NERTC SDK，您可以通过插件化的方式按需集成动态库。

3. 打开 Xcode，在左侧导航栏中选择目标 Target，单击 Build Phases 页签，在 Link Binary with Libraries 区域，单击 + 添加相应的 xcframework 动态库，待添加的动态库请参考上文 动态库。

4. 将 Embed 属性设置为 Embed & Sign，保证 SDK 动态库和应用签名保持一致。

   

5. 设置签名和添加设备权限，具体请参考 设置签名并添加媒体设备权限。

   在手动导入 SDK 的情况下，由于 SDK 包含模拟器版本，会导致打包失败。所以需要在打包之前将模拟器版本剥去，具体步骤参考 应用打包前剥离模拟器版本。

设置签名并添加媒体设备权限

1. 使用 SDK 提供的音视频功能，需要给 App 授权麦克风、摄像头和 Wi-Fi 的使用权限。

   在 info.plist 中添加以下三项：

   • Privacy - Microphone Usage Description，并填入麦克风使用目的提示语。

   • Privacy - Camera Usage Description，并填入摄像头使用目的提示语。

   • Application uses Wi-Fi，设置为 YES。

     

2. 设置签名。

   1. 在 Xcode 中，依次选择 TARGETS > Project Name，单击 Signing & Capabilities 页签，勾选 Automatically manage signing。

      

   2. 在 Team 中选择您的开发团队。

3. 如果 App 启用了 App Sandbox 或 Hardened Runtime，请在 Signing & Capabilities 页面的 App Sandbox 和 Hardened Runtime 区域，选择 Network、Camera 和 Audio Input 这几个选项。

   

下一步

实现音视频通话。