导入 SDK
融云支持使用 CocoaPods 和本地手动导入两种方式,将 RTCLib SDK 导入到您的应用工程中。
环境要求
- iOS 9.0 及以上。
- Xcode 9.0 或以上版本。
检查版本
在导入 SDK 前,您可以前往 融云官网 SDK 下载页面 确认当前最新版本号。
CocoaPods 导入
-
在 podfile 中添加如下内容:
pod 'RongCloudRTC/RongRTCLib', '~> x.y.z'
pod 'RongCloudRTC/RongFaceBeautifier', '~> x.y.z' 美颜(可选)
pod 'RongCloudRTC/RongRTCPlayer', '~> x.y.z' 混音网络资源文件(可选)
pod 'RongCloudRTC/RongVoiceBeautifier', '~> x.y.z' 美声特效(可选)提示x.y.z
代表具体版本,各个 SDK 的最新版本号可能不同,在融云下载页或 CocoaPods 仓库能查询到。- RTCLib 会自动依赖下载对应版本的 IMLib 库,一般不需要手动指定。
- RTCLib 必须与其依赖的 IMKit/IMLib SDK 保持版本一致。从 5.2.0 开始至 5.4.4(不含),要求前三位一致。从 5.4.4 开始,要求前两位保持一致。注意,RTCLib 5.4.4 不可匹配小于 5.4.4 的 IM SDK。
-
请在终端中运行以下命令:
pod install
提示如果出现找不到相关版本的问题,可先执行
pod repo update
,再执行pod install
。 -
上一步完成后,会自动导入指定版本的融云 SDK,CocoaPods 会在您的工程根目录下生成一个 xcworkspace 文件,只需通过 XCode 打开该文件即可加载工程。
本地手动导入
提示
RTCLib 必须与其依赖的 IMKit/IMLib SDK 保持版本一致。从 5.2.0 开始至 5.4.4(不含),要求前三位一致。从 5.4.4 开始,要求前两位保持一致。注意,RTCLib 5.4.4 不可匹配小于 5.4.4 的 IM SDK。
在导入 SDK 前,您需要前往融云官网 SDK 下载页面,将音视频通话(无 UI)SDK 下载到本地。
- 导入
RongRTCLib.xcframework
,并将 Embed 设置为 Embed & Sign。 - 导入
RongIMLibCore.xcframework
,并将 Embed 设置为 Embed & Sign。
工程配置
- 音视频通话需要用到摄像头和麦克风权限,请在工程的 info.plist 中添加如下键值:
- Privacy - Microphone Usage Description
- Privacy - Camera Usage Description
- 请将工程中 Target -> Signing & Capabilities -> Background Modes 如下内容勾选:
- Audio, AirPlay, and Picture in Picture
- Remote notifications
提示
SDK 5.1.1 及之前的版本,音视频通话中需要用到 HTTP
请求,请在工程的 info.plist 中添加如下键值:App Transport Security Settings
,并在此键值下再添加 Allow Arbitrary Loads
并将 Value 设置为 YES
。