引擎配置
引擎配置速览
RTC 引擎提供以下配置，可按需修改。
| 适用平台 | 配置项 | 默认值 |
|---|---|---|
| 全平台 | 断线重连 | 默认开启 |
| 全平台 | 状态报表数据回调时间间隔 | 默认1000ms |
| 全平台 | 音频初始化配置 - 编码类型 | 默认 Opus |
| Android | 音频初始化配置 - 录音来源 | 默认来自语音通信 |
| Android | 音频初始化配置 - 采样率 | 默认 16000 |
| Android | 音频初始化配置 - 立体声 | 默认开启 |
| Android | 音频初始化配置 - 麦克风采集 | 默认开启 |
| 全平台 | 视频初始化配置 - 大小流 | 默认开启 |
| Android | 视频初始化配置 - 硬件编码 | 默认开启 |
| Android | 视频初始化配置 - 硬件解码 | 默认开启 |
| Android | 视频初始化配置 - 高压缩编码 | 默认关闭 |
| Android | 视频初始化配置 - 硬件编码帧率 | 默认 30 Fps |
| Android | 视频初始化配置 - 采集/解码 到纹理 | 默认开启 |
断线重连
断线重连功能默认开启，可以在引擎初始化时传入以下配置进行关闭：
RCRTCEngineSetup setup = RCRTCEngineSetup.create(reconnectable: false);
engine = RCRTCEngine.create(setup);
状态报表数据回调时间间隔
状态数据报表回调默认时间间隔为1000ms，最小时间间隔为100ms。请注意，过小的时间间隔会影响性能。
可以在引擎初始化时传入以下配置进行修改：
/// 修改回调时间间隔为 2 秒
RCRTCEngineSetup setup = RCRTCEngineSetup.create(statsReportInterval: 2000);
engine = RCRTCEngine.create(setup);
音频初始化配置
修改音频编解码类型
目前支持 PCMU 和 OPUS 两种音频编 解码方式，默认配置是 OPUS。
可以在引擎初始化时传入以下配置进行修改：
/// 修改音频编解码类型为PCMU
RCRTCAudioSetup audioSetup = RCRTCAudioSetup.create(codec: RCRTCAudioCodecType.pcmu);
RCRTCEngineSetup setup = RCRTCEngineSetup.create(audioSetup: audioSetup);
engine = RCRTCEngine.create(setup);
修改音频录音来源
默认录音来源为语音通信。
可以在引擎初始化时传入以下配置进行修改（仅支持 Android）：
/// 修改录音来源为麦克风
RCRTCAudioSetup audioSetup = RCRTCAudioSetup.create(audioSource: RCRTCAudioSource.mic);
RCRTCEngineSetup setup = RCRTCEngineSetup.create(audioSetup: audioSetup);
engine = RCRTCEngine.create(setup);
RCRTCAudioSource 枚举值对应 Android SDK 中的 MediaRecorder.AudioSource。
修改音频采样率
引擎支持的采样率有：8000，16000， 32000， 44100， 48000。 默认为 16000。
可以在引擎初始化时传入以下配置进行修改（仅支持 Android）：
/// 修改音频采样率为 32000
RCRTCAudioSetup audioSetup = RCRTCAudioSetup.create(audioSampleRate: 32000);
RCRTCEngineSetup setup = RCRTCEngineSetup.create(audioSetup: audioSetup);
engine = RCRTCEngine.create(setup);
开启/关闭立体声
默认开启，可以在引擎初始化时传入以下配置进行关闭（仅支持 Android）：
RCRTCAudioSetup audioSetup = RCRTCAudioSetup.create(enableStereo: false);
RCRTCEngineSetup setup = RCRTCEngineSetup.create(audioSetup: audioSetup);
engine = RCRTCEngine.create(setup);
开启/关闭麦克风采集
默认开启，可以在引擎初始化时传入以下配置进行关闭（仅支持 Android）：
RCRTCAudioSetup audioSetup = RCRTCAudioSetup.create(enableMicrophone: false);
RCRTCEngineSetup setup = RCRTCEngineSetup.create(audioSetup: audioSetup);
engine = RCRTCEngine.create(setup);
如配置麦克风关闭，则在整个引擎生命周期内都无法再次开启。
视频初始化配置
开启/关闭大小流
默认开启，可以在引擎初始化时传入以下配置进行关闭：
RCRTCVideoSetup videoSetup = RCRTCVideoSetup.create(enableTinyStream: false);
RCRTCEngineSetup setup = RCRTCEngineSetup.create(videoSetup: videoSetup);
engine = RCRTCEngine.create(setup);
开启/关闭硬件编码
默认开启，可以在引擎初始化时传入以下配置进行关闭（仅支持 Android）：
RCRTCVideoSetup videoSetup = RCRTCVideoSetup.create(enableHardwareEncoder: false);
RCRTCEngineSetup setup = RCRTCEngineSetup.create(videoSetup: videoSetup);
engine = RCRTCEngine.create(setup);
开启/关闭硬件解码
默认开启，可以在引擎初始化时传入以下配置进行关闭（仅支持 Android）：
RCRTCVideoSetup videoSetup = RCRTCVideoSetup.create(enableHardwareDecoder: false);
RCRTCEngineSetup setup = RCRTCEngineSetup.create(videoSetup: videoSetup);
engine = RCRTCEngine.create(setup);
开启/关闭硬件高压缩编码
默认关闭，可以在引擎初始化时传入以下配置进行开启（仅支持 Android）：
RCRTCVideoSetup videoSetup = RCRTCVideoSetup.create(enableHardwareEncoderHighProfile: true);
RCRTCEngineSetup setup = RCRTCEngineSetup.create(videoSetup: videoSetup);
engine = RCRTCEngine.create(setup);
开启硬件高压缩编码可能会引发兼容性问题，请谨慎使用。
配置硬件编码帧率
取值范围 0～30 帧，默认 30 帧。
可以在引擎初始化时传入以下配置进行修改（仅支持 Android）：
/// 修改硬件编码帧率为 25 帧
RCRTCVideoSetup videoSetup = RCRTCVideoSetup.create(hardwareEncoderFrameRate: 25);
RCRTCEngineSetup setup = RCRTCEngineSetup.create(videoSetup: videoSetup);
engine = RCRTCEngine.create(setup);
开启/关闭 采集/解码 到纹理
默认开启，可以在引擎初始化时传入以下配置进行关闭（仅支持 Android）：
RCRTCVideoSetup videoSetup = RCRTCVideoSetup.create(enableTexture: false);
RCRTCEngineSetup setup = RCRTCEngineSetup.create(videoSetup: videoSetup);
engine = RCRTCEngine.create(setup);
关闭后，采集/解码将通过 YUV 数据的形式进行，通常建议 Android 5.0 以下的设备关闭此配置以换来更好的兼容性