集成 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 暂时只支持手动集成。

  1. 前往网易云信 SDK 下载中心获取当前最新版本 SDK,或联系网易云信技术支持获取对应版本的 SDK 安装包。

  2. 解压 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.frameworknertc_sdk_Mac.framework 文件加入到工程路径下。
  3. 打开 Xcode ,在左侧导航栏中选择目标Target,单击 Build Phases页签,在 Link Binary with Libraries 区域,单击 + 添加相应的 framework 动态库,待添加的动态库如上表所示。

    添加动态库-纯音频.png

    不同版本的动态库有差异,请以实际为准,具体请参见SDK 目录

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

    设置Embed-纯音频.png

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

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

    info.plist 中添加以下三项:

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

    • Application uses Wi-Fi,设置为 YES

    授权麦克风权限-纯音频.png

  2. 设置签名。

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

    Xcode_Signing.png

    1. Team 中选择您的开发团队。
  3. 如果 App 启用了 App SandboxHardened Runtime,请在 Signing & Capabilities 页面的 App SandboxHardened Runtime 区域,选择 NetworkAudio Input 这几个选项。

    AppSandbox-纯音频.png

    ResourceAccess-纯音频.png

后续步骤

实现音视频通话

此文档是否对你有帮助?
有帮助
去反馈
  • 开发环境要求
  • SDK 目录
  • 步骤1 集成 SDK
  • 步骤2 设置签名并添加媒体设备权限
  • 后续步骤