跳到主要内容

导入 SDK

融云支持使用 CocoaPods 和本地手动导入两种方式，将 RTCLib SDK 导入到您的应用工程中。

环境要求​

  • iOS 9.0 及以上。
  • Xcode 9.0 或以上版本。

检查版本​

在导入 SDK 前，您可以前往 融云官网 SDK 下载页面 确认当前最新版本号。

CocoaPods 导入​

  1. 在 podfile 中添加如下内容：

    ruby
    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。

  2. 请在终端中运行以下命令：

    ruby
    pod install
    提示

    如果出现找不到相关版本的问题，可先执行 pod repo update ，再执行 pod install。

  3. 上一步完成后，会自动导入指定版本的融云 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 下载到本地。

  1. 导入 RongRTCLib.xcframework，并将 Embed 设置为 Embed & Sign。
  2. 导入 RongIMLibCore.xcframework，并将 Embed 设置为 Embed & Sign。

工程配置​

  1. 音视频通话需要用到摄像头和麦克风权限，请在工程的 info.plist 中添加如下键值：
    • Privacy - Microphone Usage Description
    • Privacy - Camera Usage Description
  2. 请将工程中 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。

最后于 更新