集成 SDK(纯音频)
更新时间: 2024/09/18 16:26:13
本文为您介绍 macOS 端集成 SDK 的操作步骤,帮助您快速集成 SDK,开始使用音频通话的基本功能。
开发环境要求
在开始运行工程之前,请您准备以下开发环境:
- Xcode 11 及以上版本。
- mac OS X 10.11 或以上版本的 Mac 设备。
- 项目已配置有效的开发者签名。
SDK 目录
文件/文件夹名称 | 是否必选 | 说明 |
---|---|---|
nertc_sdk_Mac.framework | 是 | 音频通话基础模块。 |
NERtcnn.framework | 否 | 机器学习(自 V4.6.20 起提供)。 |
NERtcAiDenoise.framework | 否 | AI 降噪插件(自 V4.6.40 起提供)。 |
NERtcAiHowling.framework | 否 | AI 啸叫检测插件(自 V4.6.40 起提供,M1 芯片的 Mac 设备暂不支持此功能)。 |
NERtcAudio3D.framework | 否 | 空间音效插件(自 V5.4.0 起提供)。 |
步骤1 集成 SDK
纯音频 SDK 暂时只支持手动集成。
-
前往网易云信 SDK 下载中心获取当前最新版本 SDK,或联系网易云信技术支持获取对应版本的 SDK 安装包。
-
解压 SDK 安装包,根据您需要集成的能力,选择对应的
XX.framework
文件加入到工程路径下,具体如下表所示。功能/插件 framework
动态库所有能力 所有 framework
动态库音频 nertc_sdk_Mac.framework
NEFundation_Mac.framework
:V5.3.0 及之后版本去掉了该库文件。NERtcnn.framework
:- V4.6.20 ~V4.6.X 版本:该动态库必选。
- V5.3.0 及之后版本,只有集成音频啸叫检测插件时,才需要集成该库文件。基础音视频不需要集成该库文件。
音频 AI 降噪 AI 降噪库: NERtcAiDenoise.framework
AI 啸叫检测 - AI 啸叫检测库:
NERtcAiHowling.framework
- 机器学习库:
NERtcnn.framework
空间音效 空间音效库: NERtcAudio3D.framework
- V4.6.20 及之后版本支持插件化方式按需引入动态库。
- 若您集成的 NERTC SDK 为 V4.6.20 之前的版本,请直接将解压之后的
NEFundation_Mac.framework
和nertc_sdk_Mac.framework
文件加入到工程路径下。
-
打开 Xcode ,在左侧导航栏中选择目标Target,单击 Build Phases页签,在 Link Binary with Libraries 区域,单击 + 添加相应的 framework 动态库,待添加的动态库如上表所示。
不同版本的动态库有差异,请以实际为准,具体请参见SDK 目录。
-
将 Embed 属性设置为 Embed & Sign,保证 SDK 动态库和应用签名保持一致。
步骤2 设置签名并添加媒体设备权限
-
使用 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 这几个选项。
后续步骤
此文档是否对你有帮助?