跳转至

集成说明

有两种方式可以将 SDK 导入您的项目中:

  • 通过 CocoaPods 管理依赖 (推荐使用)
  • 手动导入 SDK 并管理依赖

使用 CocoaPods 导入 SDK

  1. 导入 IM SDK,请参考 IM SDK - 下载与导入SDK文档.

  2. 导入 CallKit CallLib

在您的工程根目录下新建一个 Podfile 文件,在文件中输入以下内容。(在此以 2.9.23 版本为例,其中 “MyApp” 为自己工程名)

target 'MyApp' do
	pod 'RongCloudIM/IMLib', '2.9.23'	
    pod 'RongCloudIM/IMKit', '2.9.23'
    pod 'RongCloudRTC/RongCallLib', '2.9.23'
    pod 'RongCloudRTC/RongCallKit', '2.9.23'
end

然后在终端中运行以下命令:

pod install

完成后,CocoaPods 会在您的工程根目录下生成一个 .xcworkspace 文件。您需要通过此文件打开您的工程,而不是之前的 .xcodeproj

说明

如果没有特殊要求,建议开发者使用最新版本的 SDK 。如果无法安装 SDK 最新版本,运行以下命令更新本地的 CocoaPods 仓库列表

pod repo update

手动导入 SDK

1、 下载 SDK

您可以到融云官方网站下载 SDK。

2、 融云 IM SDKCall SDK 的基础。使用 CallKitCallLib,必须同时集成使用融云 IM SDK。 手动导入 IM SDK,可以参考 IM SDK - 下载与导入文档。

SDK 文件说明:

文件 说明 注意事项
RongCallKit.framework CallKit 的 framework 库 使用 CallKit 必须导入
RongCallLib.framework CallLib 的 framework 库 使用 CallLib 与使用 CallKit 都必须导入
RongRTCLib.framework 通话引擎 集成 SDK 2.9.13 及以上版本必须导入,否则通话功能将无法使用
Blink.framework 通话引擎 集成 SDK 2.9.12 及以下版本必须导入,否则通话功能将无法使用
Bailingquic.framework quic连接引擎 集成 SDK 2.9.12 及以下版本必须导入,否则通话连接将无法建立

3、 手动集成了融云 SDK 之后,您需要在您的工程中导入以下库:

  • RongCallKit.framework
  • RongCallLib.framewrok
  • RongRTCLib.framework(集成 SDK 2.9.13 及以上版本必须导入)
  • Bailingquic.framework(集成 SDK 2.9.12 及以下版本必须导入)
  • Blink.framework(集成 SDK 2.9.12 及以下版本必须导入)
  • CoreGraphics.framework
  • Foundation.framework
  • AudioToolbox.framework
  • UIKit.framework
  • GLKit.framework
  • CoreMedia.framework
  • CFNetwork.framework
  • AVFoundation.framework
  • SystemConfiguration.framework
  • Security.framework
  • CoreFoundation.framework
  • CoreMotion.framework
  • libz.tbd
  • libbz2.tbd
  • libiconv.tbd
  • libstdc++.tbd
  • libresolv.tbd
  • CoreVideo.framework
  • VideoToolbox.framework

4、 在 Xcode 项目 Build Settings -> Other Linker Flags 中,增加"-ObjC"。

5、 在 Xcode 项目 Build Settings 中,搜索 Enable Bitcode 将此设置为 NO。

提示

如果开发者 CocoaPods 方式集成了 IMKit IMLib CallKit CallLib 这四个框架,在聊天界面输入扩展的加号内,会自动出现音频通话/视频通话的入口按钮。开发者不需要调用任何 API,App 就具备了音视频通话的功能。 由于手动集成方式不具备 Cocoapods 自动管理依赖库的功能,手动集成需要导入上面文档中描述的库才可以。