跳转到主要内容

​
PreOptionMic

PreOptionMic 类中包含 MicCaptureOptions、AudioPublishOptions 两个属性
MicCaptureOptions麦克风采集配置参数
AudioPublishOptions音频流发布配置参数

​
MicCaptureOptions

MicCaptureOptions 类主要用于配置麦克风采集参数，具体参数如下
deviceIdString 类型，设备 id
echoCancellationBoolean 类型，是否配置 AEC 回声消除
noiseSuppressionBoolean 类型，是否配置 ANS 降噪
autoGainControlBoolean 类型，是否配置 AGC 自动增益
channelCountInt 类型，声道数，目前只支持单声道
sampleRateInt 类型，采样率，16K 或者 48K
sampleSizeInt 类型，位深，默认 16bit
latencyDouble 类型，可接收或需要的延迟或延迟范围

​
AudioPublishOptions

AudioPublishOptions 类主要用于配置音频流发布参数，具体参数如下
descString 类型，轨道描述
codecCodecType 类型，编码格式
CodecType.unknow：未知
CodecType.AAC：AAC 格式
CodecType.OPUS：OPUS 格式
maxBitrateInt 类型，最大码率
dtxBoolean 类型，是否启用 dtx(音频的不连续传输)
redBoolean 类型，是否启用 red(冗余音频数据)
propsAny 类型，自定义属性。可空

​
PublishCustomOptions

PublishCustomOptions 类是用于在发布时对 desc、props 这两个参数做修改
descString 类型，轨道描述。
+ 可空，表示不做修改
propsAny 类型，自定义属性。
+ 可空，表示不做修改
simulcastsMutableList<PublishCustomOptions> 类型。
+ 目前只有摄像头流存在发布多路流的情况，所以此处用不上这个属性

​
预设值

目前预设值只有一个 PreOptionMic.def
  • 可以在发布流时通过 PublishCustomOptions 参数对 desc、props 参数做修改
  • 可以通过直接修改 PreOptionMic.def 获取到的实例的参数值，然后使用。
// 获取默认预设值
val preOpt: PreOptionMic = PreOptionMic.def
// 修改采集配置中的采样率
preOpt.capture.sampleRate = 48000
// 修改发布配置中的编码格式
preOpt.publish.codec = CodecType.AAC
// 使用修改后的预设值
micTrack = rtcEngine.getLocalMicTrack(PreOptionMic.def)
...
// 创建 publishCustomOptions 实例，其中有对轨道描述和扩展信息进行配置
val publishCustomOptions = PublishCustomOptions(TrackDesc.TRACK_AUDIO.value, null, null)
// 在发布时使用 publishCustomOptions 修改轨道描述和扩展信息
rtcEngine.publishLocalAudio(track, publishCustomOptions, null)
```kotlin

### PreOptionMic.def
配置如下：

```kotlin
val def = PreOptionMic(
    MicCaptureOptions(
        deviceId = "MicCapDef",
        echoCancellation = true,
        noiseSuppression = true,
        autoGainControl = true,
        channelCount = 1,
        sampleRate = 48000,
        sampleSize = 16,
        latency = 0.0
    ),
    AudioPublishOptions(
        desc = TrackDesc.TRACK_AUDIO.value,
        codec = CodecType.OPUS,
        maxBitrate = 32*1024,
        dtx = true,
        red = true,
        props = null
    )
)