文档反馈
文档反馈
音视频通话2.0 > 快速入门 > 集成SDK > 集成SDK（iOS）

集成SDK（iOS）

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

前提条件

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

集成 NERTC SDK

CocoaPods 集成

注意：请确保您的 Mac 已经安装 Ruby 环境。

集成前，请先前往 SDK 下载中心查看 NERTC SDK 最新版本的版本号。

  1. 安装 CocoaPods。

    在终端窗口中输入如下命令：

     sudo gem install cocoapods

  2. 创建 Podfile 文件。

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

     pod init

  3. 编辑 Podfile 文件。

    • YourApp：您的 Target 名称。
    • version：待集成的 NERTC SDK 版本号，建议使用最新版本。
      # platform :ios, '9.0' 
target '{YourApp}' do
  pod 'NERtcSDK', '~> {version}'
end

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

     pod search NERtcSDK

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

     pod repo update

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

     pod install

至此， NERTC SDK 已经导入完成。

手动集成

  1. 前往 SDK 下载页面获取当前最新版本。

  2. 将解压之后的 NMCBasicModuleFramework.framework 和 NERtcSDK.framework 文件加入到工程路径下。

  3. 以 Xcode Version 11.5 为例，进入 TARGETS > Project Name > General > Frameworks, Libraries, and Embedded Content 菜单，点击 +，再点击 Add Other…，将上述解压得到的 SDK 文件添加进去。

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

至此， NERTC SDK 已经导入完成。

注意：在手动导入 SDK 的情况下，由于 SDK 包含模拟器版本，会导致打包失败。所以需要在打包之前将模拟器版本剥去。

#!/bin/sh

# Strip invalid architectures

strip_invalid_archs() {
binary="$1"
echo "current binary ${binary}"
# Get architectures for current file
archs="$(lipo -info "$binary" | rev | cut -d ':' -f1 | rev)"
stripped=""
for arch in $archs; do
if ! [[ "${ARCHS}" == *"$arch"* ]]; then
if [ -f "$binary" ]; then
# Strip non-valid architectures in-place
lipo -remove "$arch" -output "$binary" "$binary" || exit 1
stripped="$stripped $arch"
fi
fi
done
if [[ "$stripped" ]]; then
echo "Stripped $binary of architectures:$stripped"
fi
}

APP_PATH="${TARGET_BUILD_DIR}/${WRAPPER_NAME}"

# This script loops through the frameworks embedded in the application and
# removes unused architectures.
find "$APP_PATH" -name '*.framework' -type d | while read -r FRAMEWORK
do
FRAMEWORK_EXECUTABLE_NAME=$(defaults read "$FRAMEWORK/Info.plist" CFBundleExecutable)
FRAMEWORK_EXECUTABLE_PATH="$FRAMEWORK/$FRAMEWORK_EXECUTABLE_NAME"
echo "Executable is $FRAMEWORK_EXECUTABLE_PATH"

strip_invalid_archs "$FRAMEWORK_EXECUTABLE_PATH"
done

添加媒体设备权限

  1. 在 Signing & Capabilities 页面，打开后台音频权限。

    打开后台音频权限之后，应用在手机中后台运行时，SDK 默认在后台也可以继续处理音频流，维持通话。

  2. 编辑 info.plist 文件，授权麦克风、摄像头和 WiFi 的使用权限。

    使用 SDK 的音视频功能，需要授权麦克风和摄像头的使用权限。在 App 的 Info.plist 中添加以下三项。

    • Privacy - Microphone Usage Description，并填入麦克风使用目的提示语。
    • Privacy - Camera Usage Description，并填入摄像头使用目的提示语。
    • Application uses Wi-Fi，设置为 YES。

后续步骤

实现音视频通话

相关文档

相关产品

×

反馈成功

非常感谢您的反馈，我们会继续努力做得更好。
确定