集成SDK(iOS)
本文为您介绍 iOS 端集成 SDK 的操作步骤,帮助您快速集成 SDK 并能使用音视频通话的基本功能。
前提条件
在开始运行工程之前,请您准备以下开发环境:
- Xcode 10 及以上版本。
- iOS 9.0 及以上版本的 iOS 设备。
集成 NERTC SDK
CocoaPods 集成
注意:请确保您的 Mac 已经安装 Ruby 环境。
集成前,请先前往 SDK 下载中心查看 NERTC SDK 最新版本的版本号。
安装 CocoaPods。
在终端窗口中输入如下命令:
sudo gem install cocoapods
创建 Podfile 文件。
从 Terminal 中进入您所创建项目所在路径,运行以下命令创建
Podfile
文件。pod init
编辑 Podfile 文件。
- YourApp:您的 Target 名称。
- version:待集成的 NERTC SDK 版本号,建议使用最新版本。
# platform :ios, '9.0' target '{YourApp}' do pod 'NERtcSDK', '~> {version}' end
执行以下命令查询本地库版本。
pod search NERtcSDK
若不是最新版本,可以执行以下命令更新本地库版本。
pod repo update
执行以下命令安装安装 SDK。
pod install
至此, NERTC SDK 已经导入完成。
手动集成
前往 SDK 下载页面获取当前最新版本。
将解压之后的
NMCBasicModuleFramework.framework
和NERtcSDK.framework
文件加入到工程路径下。以 Xcode Version 11.5 为例,进入 TARGETS > Project Name > General > Frameworks, Libraries, and Embedded Content 菜单,点击 +,再点击 Add Other…,将上述解压得到的 SDK 文件添加进去。
- 将 Embed 属性设置为 Embed & Sign,以使得SDK动态库和应用签名保持一致。
至此, NERTC SDK 已经导入完成。
注意:在手动导入 SDK 的情况下,由于 SDK 包含模拟器版本,会导致打包失败。所以需要在打包之前将模拟器版本剥去。
- 在工程里创建
nim_strip_archs.sh
脚本到指定目录,如Supporting Files
里 - 在
Build Phases
中增加过程,类型为New Run Script Phase
。需要把去掉模拟器的 Run Script 脚本放在 Embed Frameworks 之后。 - 在工程里添加内容: /bin/sh 您的脚本路径 如
/bin/sh "${SRCROOT}/NIMDemo/Supporting Files/nim_strip_archs.sh"
- 将如下内容复制到脚本:
#!/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
添加媒体设备权限
在 Signing & Capabilities 页面,打开后台音频权限。
打开后台音频权限之后,应用在手机中后台运行时,SDK 默认在后台也可以继续处理音频流,维持通话。
编辑
info.plist
文件,授权麦克风、摄像头和 WiFi 的使用权限。使用 SDK 的音视频功能,需要授权麦克风和摄像头的使用权限。在 App 的
Info.plist
中添加以下三项。- Privacy - Microphone Usage Description,并填入麦克风使用目的提示语。
- Privacy - Camera Usage Description,并填入摄像头使用目的提示语。
- Application uses Wi-Fi,设置为 YES。
后续步骤


此文档对你是否有帮助

