AudioScenario enum

音频场景类型

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

Inheritance

• Object
• Enum
• AudioScenario

Available extensions

• EnumName

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 setter, inherited

index → int

A numeric identifier for the enumerated value.

no setter, inherited

name → String

Available on Enum, provided by the EnumName extension

The name of the enum value.

no setter

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

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.