文档反馈
文档反馈

集成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.frameworkNERtcSDK.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

后续步骤

实现音视频通话

×

反馈成功

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