AudioScenario enum

音频场景类型

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

Inheritance
Available extensions

Values

music → const AudioScenario

音乐场景(默认)

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

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

高质量通话场景

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

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

纯通话音量场景

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

media → const AudioScenario

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

此场景下,无论客户端音频采集播放设备和采集播放状态,全程使用媒体音量。
外放通话时,可能出现回声和啸叫,请联系技术支持人员。

gameStreaming → const AudioScenario

游戏媒体场景。

此场景下,蓝牙耳机使用通话音量,其它设备使用媒体音量。
若外放通话且无游戏音效消除优化时音质不理想,请联系技术支持人员。

highQualityChat → const AudioScenario

高质量通话场景

此场景和 highQualityCommunication 高度类似,唯一的差异在于:此场景下,在使用设备自带的麦克风和扬声器/听筒进行通话时,开关麦始终采用通话音量,不会引起音量类型突变。
音频采集播放设备和采集播放状态,到音量类型的映射如下:

不采集音频采集音频备注
设备自带麦克风和扬声器通话音量通话音量/
听筒通话音量通话音量/
有线耳机/ USB 耳机/ 外置声卡媒体音量媒体音量/
蓝牙耳机通话音量通话音量能够使用蓝牙耳机上自带的麦克风进行音频采集。

Properties

hashCode int
The hash code for this object.
no setterinherited
index int
A numeric identifier for the enumerated value.
no setterinherited
runtimeType Type
A representation of the runtime type of the object.
no setterinherited

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() String
A string representation of this object.
inherited

Operators

operator ==(Object other) bool
The equality operator.
inherited

Constants

values → const List<AudioScenario>
A constant List of the values in this enum, in order of their declaration.