跳到主要内容

引擎配置

引擎配置速览​

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

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

断线重连​

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

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

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

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

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

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

媒体流加密功能（SRTP）​

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

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

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

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

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

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

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

音频初始化配置​

与其它后台 App 进行混音​

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

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

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

开启/关闭立体声​

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

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

视频初始化配置​

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

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

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

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

最后于 更新