# 音频基础功能 (/zh-CN/api-reference/rtc/flutter/audio/audio-basic)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## adjustPlaybackSignalVolume [#adjustplaybacksignalvolume]
调节本地播放的所有远端用户信号音量。
```dart
Future adjustPlaybackSignalVolume(int volume);
```
该方法用于调节所有远端用户混音后在本地播放的信号音量,如果你需要调节指定远端用户在本地播放的信号音量,建议你调用 [adjustUserPlaybackSignalVolume](/zh-CN/api-reference/rtc/flutter/audio/audio-basic#api_irtcengine_adjustuserplaybacksignalvolume)。
### 调用时机 [#调用时机]
加入频道前后均可调用。
### 参数 [#参数]
音量,取值范围为 [0,400]。
- 0: 静音。
- 100: (默认)原始音量。
- 400: 原始音量的 4 倍,自带溢出保护。
### 返回值 [#返回值]
方法成功调用时,无返回值;方法调用失败时,会抛出 [AgoraRtcException](/zh-CN/api-reference/rtc/flutter/class-agorartcexception) 异常,你需要捕获异常并进行处理。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类]
- [RtcEngine](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengine)
## adjustUserPlaybackSignalVolume [#adjustuserplaybacksignalvolume]
调节本地播放的指定远端用户信号音量。
```dart
Future adjustUserPlaybackSignalVolume(
{required int uid, required int volume});
```
你可以在通话中调用该方法调节指定远端用户在本地播放的音量。如需调节多个用户在本地播放的音量,则需多次调用该方法。
### 调用时机 [#调用时机-1]
该方法需要在加入频道后调用。
### 参数 [#参数-1]
远端用户 ID。
音量,取值范围为 [0,400]。
- 0: 静音。
- 100: (默认)原始音量。
- 400: 原始音量的 4 倍,自带溢出保护。
### 返回值 [#返回值-1]
方法成功调用时,无返回值;方法调用失败时,会抛出 [AgoraRtcException](/zh-CN/api-reference/rtc/flutter/class-agorartcexception) 异常,你需要捕获异常并进行处理。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-1]
- [RtcEngine](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengine)
## adjustUserPlaybackSignalVolumeEx [#adjustuserplaybacksignalvolumeex]
调节本地播放的指定远端用户信号音量。
```dart
Future adjustUserPlaybackSignalVolumeEx(
{required int uid,
required int volume,
required RtcConnection connection});
```
你可以在通话中调用该方法调节指定远端用户在本地播放的音量。如需调节多个用户在本地播放的音量,则需多次调用该方法。
### 调用时机 [#调用时机-2]
该方法需要在 [joinChannelEx](/zh-CN/api-reference/rtc/flutter/channel#api_irtcengineex_joinchannelex) 之后调用。
### 参数 [#参数-2]
远端用户 ID。
音量,取值范围为 [0,400]。
- 0: 静音。
- 100: (默认)原始音量。
- 400: 原始音量的 4 倍,自带溢出保护。
Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/flutter/class-rtcconnection)。
### 返回值 [#返回值-2]
方法成功调用时,无返回值;方法调用失败时,会抛出 [AgoraRtcException](/zh-CN/api-reference/rtc/flutter/class-agorartcexception) 异常,你需要捕获异常并进行处理。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-2]
- [RtcEngineEx](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineex)
## disableAudio [#disableaudio]
关闭音频模块。
```dart
Future disableAudio();
```
音频模块默认开启,你可以调用该方法关闭音频模块。
:::note
注: 该方法重置整个引擎,响应时间较慢,因此声网建议使用如下方法来控制音频模块:
- [enableLocalAudio](/zh-CN/api-reference/rtc/flutter/audio/audio-capture#api_irtcengine_enablelocalaudio):是否启动麦克风采集并创建本地音频流。
- [enableLoopbackRecording](/zh-CN/api-reference/rtc/flutter/audio/audio-capture#api_irtcengine_enableloopbackrecording):是否开启声卡采集。
- [muteLocalAudioStream](/zh-CN/api-reference/rtc/flutter/publishnsubscribe#api_irtcengine_mutelocalaudiostream):是否发布本地音频流。
- [muteRemoteAudioStream](/zh-CN/api-reference/rtc/flutter/publishnsubscribe#api_irtcengine_muteremoteaudiostream):是否接收并播放远端音频流。
- [muteAllRemoteAudioStreams](/zh-CN/api-reference/rtc/flutter/publishnsubscribe#api_irtcengine_muteallremoteaudiostreams):是否接收并播放所有远端音频流。
:::
### 调用时机 [#调用时机-3]
加入频道前后均可调用。离开频道后仍然有效。
### 返回值 [#返回值-3]
方法成功调用时,无返回值;方法调用失败时,会抛出 [AgoraRtcException](/zh-CN/api-reference/rtc/flutter/class-agorartcexception) 异常,你需要捕获异常并进行处理。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-3]
- [RtcEngine](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengine)
## enableAudio [#enableaudio]
启用音频模块。
```dart
Future enableAudio();
```
音频模块默认开启。如果你调用 [disableAudio](/zh-CN/api-reference/rtc/flutter/audio/audio-basic#api_irtcengine_disableaudio) 关闭了音频模块,可调用该方法重新开启。
:::note
注:
- 调用该方法会重置整个引擎,响应时间较慢。你可以根据实际需求用以下方法来独立控制音频模块的某一项功能:
- [enableLocalAudio](/zh-CN/api-reference/rtc/flutter/audio/audio-capture#api_irtcengine_enablelocalaudio): 是否启动麦克风采集并创建本地音频流。
- [muteLocalAudioStream](/zh-CN/api-reference/rtc/flutter/publishnsubscribe#api_irtcengine_mutelocalaudiostream): 是否发布本地音频流。
- [muteRemoteAudioStream](/zh-CN/api-reference/rtc/flutter/publishnsubscribe#api_irtcengine_muteremoteaudiostream): 是否接收并播放远端音频流。
- [muteAllRemoteAudioStreams](/zh-CN/api-reference/rtc/flutter/publishnsubscribe#api_irtcengine_muteallremoteaudiostreams): 是否接收并播放所有远端音频流。
- 在频道内调用该方法时,会重置 [enableLocalAudio](/zh-CN/api-reference/rtc/flutter/audio/audio-capture#api_irtcengine_enablelocalaudio)、[muteRemoteAudioStream](/zh-CN/api-reference/rtc/flutter/publishnsubscribe#api_irtcengine_muteremoteaudiostream) 和 [muteAllRemoteAudioStreams](/zh-CN/api-reference/rtc/flutter/publishnsubscribe#api_irtcengine_muteallremoteaudiostreams) 的设置,需谨慎使用。
:::
### 调用时机 [#调用时机-4]
加入频道前后均可调用。离开频道后仍然有效。
### 返回值 [#返回值-4]
方法成功调用时,无返回值;方法调用失败时,会抛出 [AgoraRtcException](/zh-CN/api-reference/rtc/flutter/class-agorartcexception) 异常,你需要捕获异常并进行处理。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-4]
- [RtcEngine](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengine)
## enableAudioVolumeIndication [#enableaudiovolumeindication]
启用用户音量提示。
```dart
Future enableAudioVolumeIndication(
{required int interval, required int smooth, required bool reportVad});
```
该方法允许 SDK 定期向 App 报告本地发流用户和瞬时音量最高的远端用户(最多 3 位)的音量相关信息。
### 调用时机 [#调用时机-5]
加入频道前后均可调用。
### 相关回调 [#相关回调]
成功调用该方法、且频道内存在发流用户时,SDK 会按设置的时间间隔触发 [onAudioVolumeIndication](/zh-CN/api-reference/rtc/flutter/audio/audio-basic#callback_irtcengineeventhandler_onaudiovolumeindication) 回调。
### 参数 [#参数-3]
指定音量提示的时间间隔:
- ≤ 0: 禁用音量提示功能。
- > 0: 返回音量提示的间隔,单位为毫秒。建议设置到大于 100 毫秒,不得小于 10 毫秒,否则会收不到 [onAudioVolumeIndication](/zh-CN/api-reference/rtc/flutter/audio/audio-basic#callback_irtcengineeventhandler_onaudiovolumeindication) 回调。
平滑系数,指定音量提示的灵敏度。取值范围为 [0,10],建议值为 3。数字越大,波动越灵敏;数字越小,波动越平滑。
- true:开启本地人声检测功能。开启后,[onAudioVolumeIndication](/zh-CN/api-reference/rtc/flutter/audio/audio-basic#callback_irtcengineeventhandler_onaudiovolumeindication) 回调的 `vad` 参数会报告是否在本地检测到人声。
- false:(默认)关闭本地人声检测功能。除引擎自动进行本地人声检测的场景外,[onAudioVolumeIndication](/zh-CN/api-reference/rtc/flutter/audio/audio-basic#callback_irtcengineeventhandler_onaudiovolumeindication) 回调的 `vad` 参数不会报告是否在本地检测到人声。
### 返回值 [#返回值-5]
方法成功调用时,无返回值;方法调用失败时,会抛出 [AgoraRtcException](/zh-CN/api-reference/rtc/flutter/class-agorartcexception) 异常,你需要捕获异常并进行处理。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-5]
- [RtcEngine](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengine)
## enableAudioVolumeIndicationEx [#enableaudiovolumeindicationex]
启用用户音量提示。
```dart
Future enableAudioVolumeIndicationEx(
{required int interval,
required int smooth,
required bool reportVad,
required RtcConnection connection});
```
该方法允许 SDK 定期向 App 报告本地发流用户和瞬时音量最高的远端用户(最多 3 位)的音量相关信息。
### 调用时机 [#调用时机-6]
该方法需要在 [joinChannelEx](/zh-CN/api-reference/rtc/flutter/channel#api_irtcengineex_joinchannelex) 之后调用。
### 相关回调 [#相关回调-1]
成功调用该方法、且频道内存在发流用户时,SDK 会按设置的时间间隔触发 [onAudioVolumeIndication](/zh-CN/api-reference/rtc/flutter/audio/audio-basic#callback_irtcengineeventhandler_onaudiovolumeindication) 回调。
### 参数 [#参数-4]
指定音量提示的时间间隔:
- ≤ 0: 禁用音量提示功能。
- > 0: 返回音量提示的间隔,单位为毫秒。建议设置到大于 100 毫秒,不得小于 10 毫秒,否则会收不到 [onAudioVolumeIndication](/zh-CN/api-reference/rtc/flutter/audio/audio-basic#callback_irtcengineeventhandler_onaudiovolumeindication) 回调。
平滑系数,指定音量提示的灵敏度。取值范围为 [0,10],建议值为 3。数字越大,波动越灵敏;数字越小,波动越平滑。
- true:开启本地人声检测功能。开启后,[onAudioVolumeIndication](/zh-CN/api-reference/rtc/flutter/audio/audio-basic#callback_irtcengineeventhandler_onaudiovolumeindication) 回调的 `vad` 参数会报告是否在本地检测到人声。
- false:(默认)关闭本地人声检测功能。除引擎自动进行本地人声检测的场景外,[onAudioVolumeIndication](/zh-CN/api-reference/rtc/flutter/audio/audio-basic#callback_irtcengineeventhandler_onaudiovolumeindication) 回调的 `vad` 参数不会报告是否在本地检测到人声。
Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/flutter/class-rtcconnection)。
### 返回值 [#返回值-6]
方法成功调用时,无返回值;方法调用失败时,会抛出 [AgoraRtcException](/zh-CN/api-reference/rtc/flutter/class-agorartcexception) 异常,你需要捕获异常并进行处理。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-6]
- [RtcEngineEx](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineex)
## setAudioProfile [#setaudioprofile]
设置音频编码属性和音频场景。
```dart
Future setAudioProfile(
{required AudioProfileType profile,
AudioScenarioType scenario = AudioScenarioType.audioScenarioDefault});
```
:::note
注: 由于 iOS 系统限制,部分音频路由在通话音量模式下无法识别。因此,如需使用外接声卡,建议将音频应用场景设置为高音质场景 `audioScenarioGameStreaming`(3)。在这种场景下,SDK 会切换到媒体音量规避该问题。
:::
### 适用场景 [#适用场景]
该方法适用于各种音频场景,你可以按需选择。例如,在音乐教学等高音质需求的场景中,建议将 `profile` 设置为 `AudioProfileMusicHighQuality`(4),`scenario` 设置为 `AudioScenarioGameStreaming`(3)。
### 调用时机 [#调用时机-7]
该方法在加入频道前后均可调用。
### 参数 [#参数-5]
音频编码属性,包含采样率、码率、编码模式和声道数。详见 [AudioProfileType](/zh-CN/api-reference/rtc/flutter/enum-audioprofiletype)。
音频场景。不同的音频场景下,设备的音量类型是不同的。
详见 [AudioScenarioType](/zh-CN/api-reference/rtc/flutter/enum-audioscenariotype) 。
### 返回值 [#返回值-7]
方法成功调用时,无返回值;方法调用失败时,会抛出 [AgoraRtcException](/zh-CN/api-reference/rtc/flutter/class-agorartcexception) 异常,你需要捕获异常并进行处理。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-7]
- [RtcEngine](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengine)
## setAudioScenario [#setaudioscenario]
设置音频场景。
```dart
Future setAudioScenario(AudioScenarioType scenario);
```
:::note
注: 由于 iOS 系统限制,部分音频路由在通话音量模式下无法识别。因此,如需使用外接声卡,建议将音频应用场景设置为高音质场景 `audioScenarioGameStreaming`(3)。在这种场景下,SDK 会切换到媒体音量规避该问题。
:::
### 适用场景 [#适用场景-1]
该方法适用于各种音频场景,你可以按需选择。例如,在音乐教学等高音质需求的场景中,建议将 `scenario` 设置为 `AudioScenarioGameStreaming`(3)。
### 调用时机 [#调用时机-8]
该方法在加入频道前后均可调用。
### 参数 [#参数-6]
音频场景。不同的音频场景下,设备的音量类型是不同的。
详见 [AudioScenarioType](/zh-CN/api-reference/rtc/flutter/enum-audioscenariotype) 。
### 返回值 [#返回值-8]
方法成功调用时,无返回值;方法调用失败时,会抛出 [AgoraRtcException](/zh-CN/api-reference/rtc/flutter/class-agorartcexception) 异常,你需要捕获异常并进行处理。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-8]
- [RtcEngine](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengine)
## setAudioSessionOperationRestriction [#setaudiosessionoperationrestriction]
设置 SDK 对 Audio Session 的操作权限。
```dart
Future setAudioSessionOperationRestriction(
AudioSessionOperationRestriction restriction);
```
默认情况下,SDK 和 App 对 Audio Session 都有操作权限。如果你只需使用 App 对 Audio Session 进行操作,你可以调用该方法限制 SDK 对 Audio Session 的操作权限。
该方法在加入频道前后都能调用。一旦调用该方法限制了 SDK 对 Audio Session 的操作权限,该限制会在 SDK 需要更改 Audio Session 时生效。
:::note
注:
- 该方法仅适用于 iOS 平台。
- 该方法不会限制 App 对 Audio Session 的操作权限。
:::
### 参数 [#参数-7]
SDK 对 Audio Session 的操作权限,详见 [AudioSessionOperationRestriction](/zh-CN/api-reference/rtc/flutter/enum-audiosessionoperationrestriction)。该参数为 Bit Mask,每个 Bit 对应一个权限。
### 返回值 [#返回值-9]
方法成功调用时,无返回值;方法调用失败时,会抛出 [AgoraRtcException](/zh-CN/api-reference/rtc/flutter/class-agorartcexception) 异常,你需要捕获异常并进行处理。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-9]
- [RtcEngine](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengine)
## onActiveSpeaker [#onactivespeaker]
监测到远端最活跃用户回调。
```dart
final void Function(RtcConnection connection, int uid)? onActiveSpeaker;
```
成功调用 [enableAudioVolumeIndication](/zh-CN/api-reference/rtc/flutter/audio/audio-basic#api_irtcengine_enableaudiovolumeindication) 后,SDK 会持续监测音量最大的远端用户,并统计该用户被判断为音量最大者的次数。当前时间段内,该次数累积最多的远端用户为最活跃的用户。
当频道内用户数量大于或等于 2 且有远端活跃用户时,SDK 会触发该回调并报告远端最活跃用户的 `uid`。
- 如果远端最活跃用户一直是同一位用户,则 SDK 不会再次触发 [onActiveSpeaker](/zh-CN/api-reference/rtc/flutter/audio/audio-basic#callback_irtcengineeventhandler_onactivespeaker) 回调。
- 如果远端最活跃用户有变化,则 SDK 会再次触发该回调并报告新的远端最活跃用户的 `uid`。
### 参数 [#参数-8]
Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/flutter/class-rtcconnection)。
远端最活跃用户的 ID。
### 所属接口类 [#所属接口类-10]
- [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler)
## onAudioQuality [#onaudioquality]
远端声音质量回调。
```dart
final void Function(RtcConnection connection, int remoteUid,
QualityType quality, int delay, int lost)? onAudioQuality;
```
:::error[废弃]
弃用: 请改用 [onRemoteAudioStats](/zh-CN/api-reference/rtc/flutter/audio/audio-basic#callback_irtcengineeventhandler_onremoteaudiostats)。
:::
该回调描述远端用户在通话中的音频质量,针对每个远端用户/主播每 2 秒触发一次。如果远端同时存在多个用户/主播,该回调每 2 秒会被触发多次。
### 参数 [#参数-9]
Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/flutter/class-rtcconnection)。
用户 ID,指定是谁发的音频流。
语音质量。详见 [QualityType](/zh-CN/api-reference/rtc/flutter/enum-qualitytype)。
音频包从发送端到接收端的延迟(毫秒),包括声音采样前处理、网络传输、网络抖动缓冲引起的延迟。
音频包从发送端到接收端的丢包率 (%)。
### 所属接口类 [#所属接口类-11]
- [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler)
## onAudioVolumeIndication [#onaudiovolumeindication]
用户音量提示回调。
```dart
final void Function(RtcConnection connection, List speakers,
int speakerNumber, int totalVolume)? onAudioVolumeIndication;
```
该回调默认禁用,你可以通过 [enableAudioVolumeIndication](/zh-CN/api-reference/rtc/flutter/audio/audio-basic#api_irtcengine_enableaudiovolumeindication) 开启。 开启后,只要频道内有发流用户,SDK 会在加入频道后按 [enableAudioVolumeIndication](/zh-CN/api-reference/rtc/flutter/audio/audio-basic#api_irtcengine_enableaudiovolumeindication) 中设置的时间间隔触发 [onAudioVolumeIndication](/zh-CN/api-reference/rtc/flutter/audio/audio-basic#callback_irtcengineeventhandler_onaudiovolumeindication) 回调。每次会触发两个 [onAudioVolumeIndication](/zh-CN/api-reference/rtc/flutter/audio/audio-basic#callback_irtcengineeventhandler_onaudiovolumeindication) 回调,一个报告本地发流用户的音量相关信息,另一个报告瞬时音量最高的远端用户(最多 3 位)的音量相关信息。
:::note
注: 启用该功能后,如果有用户将自己静音(调用了 [muteLocalAudioStream](/zh-CN/api-reference/rtc/flutter/publishnsubscribe#api_irtcengine_mutelocalaudiostream)),SDK 会继续报告本地用户的音量提示回调。
瞬时音量最高的远端用户静音后 20 秒,远端的音量提示回调中将不再包含该用户;如果远端所有用户都将自己静音,20 秒后 SDK 停止报告远端用户的音量提示回调。
:::
### 参数 [#参数-10]
Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/flutter/class-rtcconnection)。
用户音量信息,详见 [AudioVolumeInfo](/zh-CN/api-reference/rtc/flutter/class-audiovolumeinfo) 数组。如果 `speakers` 为空,则表示远端用户不发流或没有远端用户。
用户数量。
- 在本地用户的回调中,只要本地用户在发流,`speakerNumber` 始终为 1。
- 在远端用户的回调中,`speakerNumber` 取值范围为 [0,3]。如果远端发流用户数量大于 3,则此回调中 `speakerNumber` 值为 3。
混音后的总音量,取值范围为 [0,255]。
- 在本地用户的回调中,`totalVolume` 为本地发流用户的音量。
- 在远端用户的回调中,`totalVolume` 为瞬时音量最高的远端用户(最多 3 位)混音后的总音量。
### 所属接口类 [#所属接口类-12]
- [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler)
## onFirstLocalAudioFramePublished [#onfirstlocalaudioframepublished]
已发布本地音频首帧回调。
```dart
final void Function(RtcConnection connection, int elapsed)?
onFirstLocalAudioFramePublished;
```
SDK 会在以下时机触发该回调:
- 开启本地音频的情况下,调用 [joinChannel](/zh-CN/api-reference/rtc/flutter/channel#api_irtcengine_joinchannel2) 成功加入频道后。
- 调用 [muteLocalAudioStream](/zh-CN/api-reference/rtc/flutter/publishnsubscribe#api_irtcengine_mutelocalaudiostream)(`true)`,再调用 [muteLocalAudioStream](/zh-CN/api-reference/rtc/flutter/publishnsubscribe#api_irtcengine_mutelocalaudiostream)(`false)` 后。
- 调用 [disableAudio](/zh-CN/api-reference/rtc/flutter/audio/audio-basic#api_irtcengine_disableaudio),再调用 [enableAudio](/zh-CN/api-reference/rtc/flutter/audio/audio-basic#api_irtcengine_enableaudio) 后。
### 参数 [#参数-11]
Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/flutter/class-rtcconnection)。
从调用 [joinChannel](/zh-CN/api-reference/rtc/flutter/channel#api_irtcengine_joinchannel2) 方法到触发该回调的时间间隔(毫秒)。
### 所属接口类 [#所属接口类-13]
- [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler)
## onFirstRemoteAudioDecoded [#onfirstremoteaudiodecoded]
已解码远端音频首帧的回调。
```dart
final void Function(RtcConnection connection, int uid, int elapsed)?
onFirstRemoteAudioDecoded;
```
:::error[废弃]
弃用: 请改用 [onRemoteAudioStateChanged](/zh-CN/api-reference/rtc/flutter/audio/audio-basic#callback_irtcengineeventhandler_onremoteaudiostatechanged) 。
:::
SDK 会在以下时机触发该回调:
- 远端用户首次上线后发送音频。
- 远端用户音频离线再上线发送音频。音频离线指本地在 15 秒内没有收到音频包,可能有如下原因:
- 远端用户离开频道
- 远端用户掉线
- 远端用户调用 [muteLocalAudioStream](/zh-CN/api-reference/rtc/flutter/publishnsubscribe#api_irtcengine_mutelocalaudiostream) 方法停止发送音频流
- 远端用户调用 [disableAudio](/zh-CN/api-reference/rtc/flutter/audio/audio-basic#api_irtcengine_disableaudio) 方法关闭音频
### 参数 [#参数-12]
Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/flutter/class-rtcconnection)。
远端用户 ID。
从本地用户调用 [joinChannel](/zh-CN/api-reference/rtc/flutter/channel#api_irtcengine_joinchannel2) 直至该回调触发的延迟,单位为毫秒。
### 所属接口类 [#所属接口类-14]
- [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler)
## onFirstRemoteAudioFrame [#onfirstremoteaudioframe]
已接收远端音频首帧回调。
```dart
final void Function(RtcConnection connection, int userId, int elapsed)?
onFirstRemoteAudioFrame;
```
:::error[废弃]
弃用: 请改用 [onRemoteAudioStateChanged](/zh-CN/api-reference/rtc/flutter/audio/audio-basic#callback_irtcengineeventhandler_onremoteaudiostatechanged) 。
:::
### 参数 [#参数-13]
Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/flutter/class-rtcconnection)。
发送音频帧的远端用户的用户 ID。
从本地用户调用 [joinChannel](/zh-CN/api-reference/rtc/flutter/channel#api_irtcengine_joinchannel2) 直至该回调触发的延迟,单位为毫秒。
### 所属接口类 [#所属接口类-15]
- [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler)
## onLocalAudioStateChanged [#onlocalaudiostatechanged]
本地音频状态发生改变回调。
```dart
final void Function(RtcConnection connection, LocalAudioStreamState state,
LocalAudioStreamReason reason)? onLocalAudioStateChanged;
```
本地音频的状态发生改变时(包括本地麦克风采集状态和音频编码状态),SDK 会触发该回调报告当前的本地音频状态。在本地音频出现故障时,该回调可以帮助你了解当前音频的状态以及出现故障的原因,方便你排查问题。
:::note
注: 当状态为 `localAudioStreamStateFailed` (3) 时, 你可以在 `error` 参数中查看返回的错误信息。
:::
### 参数 [#参数-14]
Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/flutter/class-rtcconnection)。
当前的本地音频状态。详见 [LocalAudioStreamState](/zh-CN/api-reference/rtc/flutter/enum-localaudiostreamstate)。
本地音频状态改变原因。详见 [LocalAudioStreamReason](/zh-CN/api-reference/rtc/flutter/enum-localaudiostreamreason)。
### 所属接口类 [#所属接口类-16]
- [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler)
## onLocalAudioStats [#onlocalaudiostats]
通话中本地音频流的统计信息回调。
```dart
final void Function(RtcConnection connection, LocalAudioStats stats)?
onLocalAudioStats;
```
SDK 每 2 秒触发该回调一次。
### 参数 [#参数-15]
Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/flutter/class-rtcconnection)。
本地音频统计数据。详见 [LocalAudioStats](/zh-CN/api-reference/rtc/flutter/class-localaudiostats)。
### 所属接口类 [#所属接口类-17]
- [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler)
## onRemoteAudioStateChanged [#onremoteaudiostatechanged]
远端音频流状态发生改变回调。
```dart
final void Function(
RtcConnection connection,
int remoteUid,
RemoteAudioState state,
RemoteAudioStateReason reason,
int elapsed)? onRemoteAudioStateChanged;
```
远端用户(通信场景)或主播(直播场景)的音频状态发生改变时,SDK 会触发该回调向本地用户报告当前的远端音频流状态。
:::note
注: 频道内的用户(通信场景)或主播(直播场景)人数超过 32 人时,该回调可能不准确。
:::
### 参数 [#参数-16]
Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/flutter/class-rtcconnection)。
发生音频状态改变的远端用户 ID。
远端音频流状态,详见 [RemoteAudioState](/zh-CN/api-reference/rtc/flutter/enum-remoteaudiostate)。
远端音频流状态改变的具体原因,详见 [RemoteAudioStateReason](/zh-CN/api-reference/rtc/flutter/enum-remoteaudiostatereason)。
从本地用户调用 [joinChannel](/zh-CN/api-reference/rtc/flutter/channel#api_irtcengine_joinchannel2) 方法到发生本事件经历的时间,单位为毫秒。
### 所属接口类 [#所属接口类-18]
- [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler)
## onRemoteAudioStats [#onremoteaudiostats]
通话中远端音频流的统计信息回调。
```dart
final void Function(RtcConnection connection, RemoteAudioStats stats)?
onRemoteAudioStats;
```
该回调针对每个发送音频流的远端用户/主播每 2 秒触发一次。如果远端有多个用户/主播发送音频流,该回调每 2 秒会被触发多次。
### 参数 [#参数-17]
Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/flutter/class-rtcconnection)。
接收到的远端音频统计数据,详见 [RemoteAudioStats](/zh-CN/api-reference/rtc/flutter/class-remoteaudiostats)。
### 所属接口类 [#所属接口类-19]
- [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler)
## onRemoteAudioTransportStats [#onremoteaudiotransportstats]
通话中远端音频流传输的统计信息回调。
```dart
final void Function(RtcConnection connection, int remoteUid, int delay,
int lost, int rxKBitRate)? onRemoteAudioTransportStats;
```
弃用:
请改用 [onRemoteAudioStats](/zh-CN/api-reference/rtc/flutter/audio/audio-basic#callback_irtcengineeventhandler_onremoteaudiostats)。
该回调描述远端用户通话中端到端的网络统计信息,通过音频包计算,用客观的数据,如丢包、 网络延迟等,展示当前网络状态。通话中,当用户收到远端用户/主播发送的音频数据包后,会每 2 秒触发一次该回调。
### 参数 [#参数-18]
Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/flutter/class-rtcconnection)。
用户 ID,指定是哪个用户/主播的音频包。
音频包从发送端到接收端的延时(毫秒)。
音频包从发送端到接收端的丢包率 (%)。
远端音频包的接收码率(Kbps)。
### 所属接口类 [#所属接口类-20]
- [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler)
## onUserMuteAudio [#onusermuteaudio]
远端用户(通信场景)/主播(直播场景)停止或恢复发送音频流回调。
```dart
final void Function(RtcConnection connection, int remoteUid, bool muted)?
onUserMuteAudio;
```
该回调是由远端用户调用 [muteLocalAudioStream](/zh-CN/api-reference/rtc/flutter/publishnsubscribe#api_irtcengine_mutelocalaudiostream) 方法关闭或开启音频发送触发的。
:::note
注: 频道内的用户(通信场景)或主播(直播场景)人数超过 32 人时,该回调可能不准确。
:::
### 参数 [#参数-19]
Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/flutter/class-rtcconnection)。
用户 ID。
该用户是否静音:
- true: 该用户已将音频静音。
- false: 该用户取消了音频静音。
### 所属接口类 [#所属接口类-21]
- [RtcEngineEventHandler](/zh-CN/api-reference/rtc/flutter/rtc-interface-class#class_irtcengineeventhandler)