跳到主要内容

引擎配置

引擎配置速览

RTC 引擎提供以下配置,可按需修改。

配置项默认值
断线重连默认开启
媒体流加密功能(SRTP)默认关闭
状态报表数据回调时间间隔默认 1000ms
检测 IM SDK 和 RTC SDK 版本号是否一致默认开启
音频初始化配置 - 与其它后台 App 进行混音默认开启
音频初始化配置 - 立体声默认开启
视频初始化配置 - 硬件高压缩编码默认关闭

断线重连

断线重连功能默认开启,可以在引擎初始化时传入以下配置进行关闭:

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

状态报表数据回调时间间隔

状态数据报表回调默认时间间隔为 1000ms,最小时间间隔为 100ms。请注意,过小的时间间隔会影响性能。

可以在引擎初始化时传入以下配置进行修改:

RCRTCConfig *config = [[RCRTCConfig alloc] init];
NSUInteger myInterval = 2000 // 修改回调时间间隔为 2 秒
config.statusReportInterval = myInterval;
[[RCRTCEngine sharedInstance] initWithConfig:config];

媒体流加密功能(SRTP)

SDK 内置 SRTP 安全实时传输协议,即协议层的标准加密方式。以开关形式提供,使用简单。媒体流加密功能(SRTP)功能默认关闭。请注意,开启该功能会对性能和用户体验有一定影响,如果没有该需求请不要打开。

可以在引擎初始化时传入以下配置进行开启:

RCRTCConfig *config = [[RCRTCConfig alloc] init];
config.enableSRTP = YES;
[[RCRTCEngine sharedInstance] initWithConfig:config];

检测 IM SDK 和 RTC SDK 版本号是否一致

默认开启,用于在 Debug 模式下检测 IM SDK 和 RTC SDK 版本号是否一致。

可以在引擎初始化时传入以下配置进行关闭:

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

音频初始化配置

与其它后台 App 进行混音

默认开启,允许与其他后台 App 进行混音。请注意,如果该属性设置为 NO,切换到其它 App 操作麦克风或者扬声器时,会导致自己 App 麦克风采集和播放被打断。

可以在引擎初始化时传入以下配置进行关闭:

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

开启/关闭立体声

默认开启,可以在引擎初始化时传入以下配置进行关闭:

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

视频初始化配置

开启/关闭硬件高压缩编码

默认关闭,使用BaseLine进行视频编码。您可以在引擎初始化时传入以下配置进行开启:

RCRTCConfig *config = [[RCRTCConfig alloc] init];
config.enableHardwareEncoderHighProfile = YES;
[[RCRTCEngine sharedInstance] initWithConfig:config];
提示

开启硬件高压缩编码可能会引发兼容性问题,请谨慎使用。