跳到主要内容

引擎配置

引擎配置速览​

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

适用平台配置项默认值
全平台断线重连默认开启
全平台状态报表数据回调时间间隔默认1000ms
全平台音频初始化配置 - 编码类型默认 Opus
Android音频初始化配置 - 录音来源默认来自语音通信
Android音频初始化配置 - 采样率默认 16000
Android音频初始化配置 - 立体声默认开启
Android音频初始化配置 - 麦克风采集默认开启
全平台视频初始化配置 - 大小流默认开启
Android视频初始化配置 - 硬件编码默认开启
Android视频初始化配置 - 硬件解码默认开启
Android视频初始化配置 - 高压缩编码默认关闭
Android视频初始化配置 - 硬件编码帧率默认 30 Fps
Android视频初始化配置 - 采集/解码 到纹理默认开启

断线重连​

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

方法​

JavaScript
RCRTCEngine.create(setup);

参数说明​

参数类型必填说明
setupObject是引擎配置项
setup.reconnectableBoolean否是否开启断线重连，默认 true

示例代码​

JavaScript
// 关闭断线重连
let setup = { reconnectable: false };
RCRTCEngine.create(setup);
console.log('断线重连已关闭');

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

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

方法​

JavaScript
RCRTCEngine.create(setup);

参数说明​

参数类型必填说明
setupObject是引擎配置项
setup.statsReportIntervalNumber否状态报表数据回调时间间隔，单位毫秒，默认 1000

示例代码​

JavaScript
// 修改回调时间间隔为 2 秒
let setup = { statsReportInterval: 2000 };
RCRTCEngine.create(setup);
console.log('状态报表回调间隔已设置为 2 秒');

音频初始化配置​

修改音频编解码类型​

目前支持 PCMU 和 OPUS 两种音频编解码方式，默认配置是 OPUS。

方法​

JavaScript
RCRTCEngine.create(setup);

参数说明​

参数类型必填说明
setupObject是引擎配置项
setup.audioSetupObject否音频配置项
setup.audioSetup.codecRCRTCAudioCodecType否音频编解码类型，默认 OPUS

示例代码​

JavaScript
// 修改音频编解码类型为PCMU
let audioSetup = { codec: RCRTCAudioCodecType.PCMU };
let setup = { audioSetup };
RCRTCEngine.create(setup);
console.log('音频编解码类型已设置为 PCMU');

修改音频录音来源​

默认录音来源为语音通信。

方法​

JavaScript
RCRTCEngine.create(setup);

参数说明​

参数类型必填说明
setupObject是引擎配置项
setup.audioSetupObject否音频配置项
setup.audioSetup.audioSourceRCRTCAudioSource否音频录音来源，默认语音通信

示例代码​

JavaScript
// 修改录音来源为麦克风
let audioSetup = { audioSource: RCRTCAudioSource.MIC };
let setup = { audioSetup };
RCRTCEngine.create(setup);
console.log('音频录音来源已设置为麦克风');

RCRTCAudioSource 枚举值对应 Android SDK 中的 MediaRecorder.AudioSource。

修改音频采样率​

引擎支持的采样率有：8000，16000， 32000， 44100， 48000。 默认为 16000。

方法​

JavaScript
RCRTCEngine.create(setup);

参数说明​

参数类型必填说明
setupObject是引擎配置项
setup.audioSetupObject否音频配置项
setup.audioSetup.audioSampleRateRCRTCAudioSampleRate否音频采样率，默认 16000

示例代码​

JavaScript
// 修改音频采样率为 32000
let audioSetup = { audioSampleRate: RCRTCAudioSampleRate.Type32000 };
let setup = { audioSetup };
RCRTCEngine.create(setup);
console.log('音频采样率已设置为 32000');

开启/关闭立体声​

默认开启，可以在引擎初始化时传入以下配置进行关闭（仅支持 Android）。

方法​

JavaScript
RCRTCEngine.create(setup);

参数说明​

参数类型必填说明
setupObject是引擎配置项
setup.audioSetupObject否音频配置项
setup.audioSetup.enableStereoBoolean否是否开启立体声，默认 true

示例代码​

JavaScript
// 关闭立体声
let audioSetup = { enableStereo: false };
let setup = { audioSetup };
RCRTCEngine.create(setup);
console.log('立体声已关闭');

开启/关闭麦克风采集​

默认开启，可以在引擎初始化时传入以下配置进行关闭（仅支持 Android）。

方法​

JavaScript
RCRTCEngine.create(setup);

参数说明​

参数类型必填说明
setupObject是引擎配置项
setup.audioSetupObject否音频配置项
setup.audioSetup.enableMicrophoneBoolean否是否开启麦克风采集，默认 true

示例代码​

JavaScript
// 关闭麦克风采集
let audioSetup = { enableMicrophone: false };
let setup = { audioSetup };
RCRTCEngine.create(setup);
console.log('麦克风采集已关闭');
提示

如配置麦克风关闭，则在整个引擎生命周期内都无法再次开启。

视频初始化配置​

开启/关闭大小流​

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

方法​

JavaScript
RCRTCEngine.create(setup);

参数说明​

参数类型必填说明
setupObject是引擎配置项
setup.videoSetupObject否视频配置项
setup.videoSetup.enableTinyStreamBoolean否是否开启大小流，默认 true

示例代码​

JavaScript
// 关闭大小流
let videoSetup = { enableTinyStream: false };
let setup = { videoSetup };
RCRTCEngine.create(setup);
console.log('大小流已关闭');

开启/关闭硬件编码​

默认开启，可以在引擎初始化时传入以下配置进行关闭（仅支持 Android）。

方法​

JavaScript
RCRTCEngine.create(setup);

参数说明​

参数类型必填说明
setupObject是引擎配置项
setup.videoSetupObject否视频配置项
setup.videoSetup.enableHardwareEncoderBoolean否是否开启硬件编码，默认 true

示例代码​

JavaScript
// 关闭硬件编码
let videoSetup = { enableHardwareEncoder: false };
let setup = { videoSetup };
RCRTCEngine.create(setup);
console.log('硬件编码已关闭');

开启/关闭硬件解码​

默认开启，可以在引擎初始化时传入以下配置进行关闭（仅支持 Android）。

方法​

JavaScript
RCRTCEngine.create(setup);

参数说明​

参数类型必填说明
setupObject是引擎配置项
setup.videoSetupObject否视频配置项
setup.videoSetup.enableHardwareDecoderBoolean否是否开启硬件解码，默认 true

示例代码​

JavaScript
// 关闭硬件解码
let videoSetup = { enableHardwareDecoder: false };
let setup = { videoSetup };
RCRTCEngine.create(setup);
console.log('硬件解码已关闭');

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

默认关闭，可以在引擎初始化时传入以下配置进行开启（仅支持 Android）。

方法​

JavaScript
RCRTCEngine.create(setup);

参数说明​

参数类型必填说明
setupObject是引擎配置项
setup.videoSetupObject否视频配置项
setup.videoSetup.enableHardwareEncoderHighProfileBoolean否是否开启硬件高压缩编码，默认 false

示例代码​

JavaScript
// 开启硬件高压缩编码
let videoSetup = { enableHardwareEncoderHighProfile: true };
let setup = { videoSetup };
RCRTCEngine.create(setup);
console.log('硬件高压缩编码已开启');
提示

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

配置硬件编码帧率​

取值范围 0～30 帧，默认 30 帧。

方法​

JavaScript
RCRTCEngine.create(setup);

参数说明​

参数类型必填说明
setupObject是引擎配置项
setup.videoSetupObject否视频配置项
setup.videoSetup.hardwareEncoderFrameRateNumber否硬件编码帧率，范围 0-30，默认 30

示例代码​

JavaScript
// 修改硬件编码帧率为 25 帧
let videoSetup = { hardwareEncoderFrameRate: 25 };
let setup = { videoSetup };
RCRTCEngine.create(setup);
console.log('硬件编码帧率已设置为 25 帧');

开启/关闭 采集/解码 到纹理​

默认开启，可以在引擎初始化时传入以下配置进行关闭（仅支持 Android）。

方法​

JavaScript
RCRTCEngine.create(setup);

参数说明​

参数类型必填说明
setupObject是引擎配置项
setup.videoSetupObject否视频配置项
setup.videoSetup.enableTextureBoolean否是否开启采集/解码到纹理，默认 true

示例代码​

JavaScript
// 关闭采集/解码到纹理
let videoSetup = { enableTexture: false };
let setup = { videoSetup };
RCRTCEngine.create(setup);
console.log('采集/解码到纹理已关闭');
提示

关闭后，采集/解码将通过 YUV 数据的形式进行，通常建议 Android 5.0 以下的设备关闭此配置以换来更好的兼容性

最后于 更新