• 前置条件
  • 服务开通
  • SDK 导入
    • 自动导入
    • 手动导入
  • 初始化
  • 连接 IM

集成 Demo 示例

融云在 GitHub 上提供了 快速集成 Demo (opens new window) 代码示例，方便开发者参考。

前置条件

服务开通

1. 在 开发者后台 (opens new window) 创建应用。
2. 开通音视频服务，开通位置如下图。

SDK 导入

以下两种方式可以将 SDK 导入您的项目中：

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

自动导入

1. 请运行以下命令更新本地的 CocoaPods 仓库列表：

pod repo update
已复制

2.。 请在 podfile 中添加如下内容：

pod 'RongRTCLib'，'~> 3.2.1'
已复制

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

pod install
已复制

4. pod install 完成后，会自动导入指定版本的 RongIMLib，CocoaPods 会在您的工程根目录下生成一个 .xcworkspace 文件，pod install 执行完成后，只需要打开 .xcworkspace 文件即可。

手动导入

1. 在融云官网下载实时音视频库进行集成，地址: https://www.rongcloud.cn/downloads (opens new window)

2. 导入 RongRTCLib.framework、RongIMLib.framework、libopencore-amrnb.a (该库包含在 RongIMLib 软件包中)。

3. 添加以下系统依赖库：

   • AssetsLibrary
   • MapKit
   • ImageIO
   • Security
   • SystemConfiguration
   • QuartzCore
   • AVFoundation
   • GLKit
   • OpenGLES
   • CoreGraphics
   • CoreLocation
   • CoreTelephony
   • CoreFoundation
   • CoreMedia
   • CoreAudio
   • CoreVideo
   • CFNetwork
   • AudioToolbox
   • VideoToolBox
   • AVFoundation
   • libc++.tbd
   • libz.tbd
   • libbz2.tbd
   • libiconv.tbd
   • libsqlite3.tbd

4. 请将工程中 Target -> Build Settings -> Enable Bitcode 将此项设置为 NO。

5. 请将工程中 Target -> Build Settings -> Other Linker Flags 在此项中添加 -ObjC。为避免造成编译失败，禁止使用 -all_load 和 -force_load。

初始化

在启动时，使用单例初始化 RCIMClient。

示例代码

// AppKey 设置
[[RCIMClient sharedRCIMClient] initWithAppKey:@"请在开发者平台获取AppKey"];
已复制

连接 IM

IM 初始化完成后需要连接 IM 服务。

示例代码

// 连接 IM 服务
[[RCIMClient sharedRCIMClient] connectWithToken:@"开发者的 server 通过请求 server api 获取到的 token 值"
                                        dbOpened:^(RCDBErrorCode code) {}
                                         success:^(NSString *userId) {}
                                           error:^(RCConnectErrorCode status) {}
                                  tokenIncorrect:^{}];
已复制