跳到主要内容

3.X 升级到 5.X(会议场景)

本文描述 RTCLib SDK 会议场景的升级步骤。

升级概述

RTCLib SDK 5.X 对比 3.X,适配了 iPhone 新机型与新系统,功能更丰富,更稳定,并在之前版本上修复了大量问题,建议尽早升级至新版 RTCLib SDK。

前置条件

  • 5.X RTCLib SDK 依赖 RongIMLibCore 请您确保已将 RongIMLibCore 升级至 5.X。
  • RongIMLib SDK 5.X 做了拆分,请遵照 IMLib 的升级文档先将使用对应功能的 SDK 进行升级集成。
  • 已遵照 IMLib 升级要求将您的 Cocoapod 版本升级到 1.10.0 以上。

手动集成

  1. 将原先 SDK 依赖的系统库全部去掉,如果 App 或者其他 SDK 有依赖的系统库除外

    • 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
  2. 将 3.X 的 RongRTCLib.framework、RongIMLib.framework、libopencore-amrnb.a (该库包含在 RongIMLib 软件包中) 删除并替换为 5.X 的 RongRTCLib.xcframework、RongIMLibCore.xcframework

  3. General -> Frameworks,Libraries,and Embedded Binaries 中将 RongXX.framework 的 Embed 设置为 Embed & Sign

pod 集成

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

    # pod 'RongRTCLib','~> 3.2.2'        # 注释 3.X 的内容
    pod 'RongCloudRTC/RongRTCLib', '~> x.y.z'
  2. 请在终端中运行以下命令:

    pod install

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

接口替换说明

对象命名的改变

RTCLib SDK 从 3.X 升级到 5.X 将对象的命名规则由 RongXXX 变更为 RCXXX,您可以全局针对 RTCLib 的对象进行统一的替换。 例如加入房间的方法名称没有变动,方法返回的实例对象名称由 RongRTCRoom 变更为 RCRTCRoom

- (void)joinRoom:(NSString *)roomId
completion:(nullable void (^)(RCRTCRoom *_Nullable room, RCRTCCode code))completion;

初始化接口

将原有 AppKey 初始化方法进行替换

#import <RongIMLibCore/RongIMLibCore.h>

[[RCCoreClient sharedCoreClient] initWithAppKey:@"从控制台申请的 AppKey"];

连接接口

将原有连接 IM 方法进行替换

// 连接 IM 服务
[[RCCoreClient sharedCoreClient] connectWithToken:@"从您服务器端获取的 Token"
dbOpened:^(RCDBErrorCode code) {}
success:^(NSString *userId) {}
error:^(RCConnectErrorCode status) {}];

音视频引擎初始化

将原有 sharedEngine 方法替换为

RCRTCEngine *engine = [RCRTCEngine sharedInstance];

状态监听接口

将原有的 RongRTCActivityMonitorDelegate 状态监视器代理替换为

@property (nonatomic, weak, nullable) id<RCRTCStatusReportDelegate> statusReportDelegate;

房间事件代理回调接口

将原有的 RongRTCRoomDelegate 房间事件代理替换为

/*!
房间事件代理
*/
@property (nonatomic, weak, nullable) id<RCRTCRoomEventDelegate> delegate;

代理中对应的方法变动对照 RCRTCRoomEventDelegate 中的说明替换即可

获取当前房间

将原有的当前加入房间 currentRoom 属性替换为

@property (nonatomic, strong, readonly, nullable) RCRTCRoom *room;

断线重连设置

断线重连功能默认开启,如果 3.X 有使用 setReconnectEnable: 设置为 NO ;升级后需要在引擎初始化时传入以下配置进行关闭:

RCRTCConfig *config = [[RCRTCConfig alloc] init];
config.isEnableAutoReconnect = NO;
[[RCRTCEngine sharedInstance] initWithConfig:config];

离开房间接口

将原有的 leaveRoom:completion: 方法替换为

- (void)leaveRoom:(nullable RCRTCOperationCallback)completion;

发布与取消发布资源接口

加入房间成功后 3.X 是通过加入房间返回的 RongRTCRoom 对象管理本地默认音视频流;5.X 变动为通过加入房间返回的 RCRTCRoom 中的 RCRTCLocalUser 对象管理本地默认音视频流

// 发布本地默认音视频资源
[[RCRTCEngine sharedInstance].room.localUser publishDefaultStream:^(BOOL isSuccess,RCRTCCode desc) {
}];
// 取消发布本地默认音视频资源
[[RCRTCEngine sharedInstance].room.localUser unpublishDefaultStream:^(BOOL isSuccess, RCRTCCode desc) {
}];

订阅与取消订阅资源接口

加入房间成功后 3.X 是通过加入房间返回的 RongRTCRoom 对象管理对端的音视频流;5.X 变动为通过加入房间返回的 RCRTCRoom 中的 RCRTCLocalUser 对象管理对端音视频流

// 订阅对端音视频资源
[[RCRTCEngine sharedInstance].room.localUser subscribeStream:avStreams
tinyStreams:nil
completion:^(BOOL isSuccess, RCRTCCode desc) {
}];
// 取消订阅对端音视频资源
[[RCRTCEngine sharedInstance].room.localUser unsubscribeStream:streams
completion:^(BOOL isSuccess, RCRTCCode desc) {
}];

创建渲染视图

3.X 的创建渲染视图分为本地渲染视图 RongRTCLocalVideoView 与远端渲染视图 RongRTCRemoteVideoView ,5.X 统一将创建渲染视图调整为 RCRTCVideoView

// 初始化本地渲染视图
RCRTCVideoView *view = [[RCRTCVideoView alloc]initWithFrame:CGRectMake(100, 100, 100, 100)];

渲染视频流

将 3.X 的渲染视图接口 setVideoRender: 接口替换为

// 渲染本地视图
[[RCRTCEngine sharedInstance].defaultVideoStream setVideoView:@"创建的 RCRTCVideoView 视图"];
// 渲染远端视图
[(RCRTCVideoInputStream *)stream setVideoView:@"创建的 RCRTCVideoView 视图"];

摄像头管理

将原有的摄像头相关接口调用替换为

// 打开摄像头
[[RCRTCEngine sharedInstance].defaultVideoStream startCapture];
// 关闭摄像头
[[RCRTCEngine sharedInstance].defaultVideoStream stopCapture];
// 切换摄像头
[[RCRTCEngine sharedInstance].defaultVideoStream switchCamera];

麦克风管理

将原有的开关麦克风接口调用替换为

// 设置禁用麦克风采集
[[RCRTCEngine sharedInstance].defaultAudioStream setMicrophoneDisable:YES];

扬声器管理

将原有的扬声器/听筒切换接口调用替换为

// 设置使用扬声器
[[RCRTCEngine sharedInstance] enableSpeaker:YES];

设置视频属性

将原有的 setVideoCaptureParam: 接口调用替换为

RCRTCVideoStreamConfig *videoConfig = [[RCRTCVideoStreamConfig alloc] init];
videoConfig.videoSizePreset = RCRTCVideoSizePreset720x480;
videoConfig.videoFps = RCRTCVideoFPS30;
[[RCRTCEngine sharedInstance].defaultVideoStream setVideoConfig:videoConfig];

视频大小流

将原有的控制是否开启大小流的接口替换为

[RCRTCEngine sharedInstance].defaultVideoStream.enableTinyStream = YES;

本地视频流处理

原有的获取本地流数据 RongRTCVideoCMSampleBufferCallback 方法已经废弃,升级后获取本地流与远端流的视频数据需要设置代理 RCRTCVideoOutputStreamEventDelegate 并实现对应代理方法

[RCRTCEngine sharedInstance].defaultVideoStream.streamEventDelegate = self;
/*!
采集视频数据回调

@param videoFrame 采集的视频数据,类型为 RCRTCVideoFrameFormatNV12
@param stream 采集的视频帧数据所属接收到的流
@discussion
采集的视频数据,如果修改该视频帧,会影响本地渲染和编码发送的视频帧数据,不支持修改数据格式

@remarks 代理
added from 5.2.3
*/
- (void)outputVideoStream:(RCRTCVideoOutputStream *)stream captureVideoFrame:(nullable RCRTCVideoFrame *)videoFrame;

远端视频流处理

原有的获取本地流数据 willRenderCVPixelBufferRef:stream: 方法已经废弃,升级后获取远端流的视频数据需要设置代理 RCRTCVideoInputStreamEventDelegate 并实现对应代理方法

// 获取到远端流后设置代理
((RCRTCVideoInputStream *)stream).streamEventDelegate = self;
/*!
即将渲染视频帧的数据回调

@param videoFrame 即将渲染的视频帧数据
@param stream 即将渲染的视频帧数据所属接收到的流
@discussion
即将渲染视频帧数据,如果修改该视频帧,会影响本地渲染远端用户的视频帧,不支持修改数据格式

@remarks 代理
added from 5.1.14
*/
- (void)inputVideoStream:(RCRTCVideoInputStream *)stream willRenderVideoFrame:(nullable RCRTCVideoFrame *)videoFrame;

进阶功能升级说明

混音设置

3.X 的混音功能只支持混音本地资源,5.X 支持混音在线网络音频资源。升级 5.X 后混音方法名称没有变动,需要注意的是方法调用对象由 RongRTCAudioMixer 变为 RCRTCAudioMixer

// 开始混音本地音频
NSString *audioFilePath = [[NSBundle mainBundle] pathForResource:@"test" ofType:@"mp3"];
NSURL *mediaUrl = [NSURL fileURLWithPath:audioFilePath];
[[RCRTCAudioMixer sharedInstance] startMixingWithURL:mediaUrl
playback:YES
mixerMode:RCRTCMixerModeMixing
loopCount:NSUIntegerMax];

更多具体的方法调用参考 5.X 的混音设置文档

设置音频属性

为了来满足不同场景对音频设置的需求,同时降低使用复杂度,融云 RongRTCLib 从 5.1.0 开始,对音频码率(5.1.0 音频通话质量)和音频模式(5.1.0 音频通话模式)进行了接口合并封装,并重新设计,对外提供音频质量 + 音频模式的接口。具体的参数选择参考 5.X 的设置音频属性文档

音频流处理

SDK 5.X 依旧提供了本地音频流发送前和远端视音频流接收后的上报,数据回调接口的所属类对象以及名称对比 3.X 有所变动,返回的数据仍为 PCM 数据。具体可以参考对应 5.X 的音频流处理文档替换对应回调。

发布自定义流

发布自定义流的逻辑可以直接通过 5.X 的自定义流文档进行修改适配

发布屏幕共享

屏幕共享的升级方案可以通过 5.X 的屏幕共享文档 进行修改适配