AudioScenario enum Null safety

音频场景类型

选择音频场景后,SDK 会自动根据客户端音频采集播放设备和状态,适用通话音量/媒体音量。 如果以下音频场景类型无法满足你的业务需要,请联系技术支持同学进行定制。

Constants

communication → const AudioScenario

纯通话音量场景

此场景下,无论客户端音频采集播放设备和采集播放状态,全程使用通话音量。 适用于需要频繁上下麦的通话或会议场景。 此场景可以保持统一的音频模式,不会有音量突变的听感;最大程度地消除回声,使通话清晰度达到最优。 使用蓝牙耳机时,能够使用蓝牙耳机上自带的麦克风进行音频采集。 但是,此场景会压低使用媒体音量进行播放的其他音频的音量,且音质会变差。

const AudioScenario(2)
gameStreaming → const AudioScenario

游戏媒体场景

此场景下,蓝牙耳机时使用通话音量,其它设备使用媒体音量。 外放通话且无游戏音效消除优化时,极易出现回声和啸叫。

const AudioScenario(4)
highQualityCommunication → const AudioScenario

高质量通话场景

此场景适用于对音乐表现力有要求,但又希望能够使用蓝牙耳机上自带的麦克风进行音频采集的场景。 此场景可以兼顾外放/使用蓝牙耳机时的音频体验,并避免使用蓝牙耳机时音量类型切换导致的听感突变。 音频采集播放设备和采集播放状态,到音量类型的映射如下:

不采集音频采集音频备注
设备自带麦克风和扬声器/听筒媒体音量通话音量/
有线耳机媒体音量媒体音量/
蓝牙耳机通话音量通话音量通话音量能够使用蓝牙耳机上自带的麦克风进行音频采集
const AudioScenario(1)
media → const AudioScenario

纯媒体场景(一般不建议使用)

此场景下,无论客户端音频采集播放设备和采集播放状态,全程使用媒体音量。 外放通话时,极易出现回声和啸叫。

const AudioScenario(3)
music → const AudioScenario

音乐场景(默认)

此场景适用于对音乐表现力有要求的场景,如音乐直播等。 音频采集播放设备和采集播放状态,到音量类型的映射如下:

不采集音频采集音频备注
设备自带麦克风和扬声器/听筒媒体音量通话音量/
有线耳机媒体音量媒体音量
蓝牙耳机媒体音量媒体音量媒体音量即使蓝牙耳机有麦克风,也只能使用设备自带麦克风进行本地音频采集
const AudioScenario(0)
values → const List<AudioScenario>

A constant List of the values in this enum, in order of their declaration.

const List<AudioScenario>

Properties

hashCode → int
The hash code for this object. [...]
read-only, inherited
index → int

The integer index of this enum.

final
runtimeType → Type
A representation of the runtime type of the object.
read-only, inherited

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a non-existent method or property is accessed. [...]
inherited
toString() → String
A string representation of this object. [...]
override

Operators

operator ==(Object other) → bool
The equality operator. [...]
inherited