# 音频基础功能 (/zh-CN/api-reference/rtc/csharp-windows/audio/audio-basic) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## AdjustUserPlaybackSignalVolume [#adjustuserplaybacksignalvolume] 调节本地播放的指定远端用户信号音量。 ```csharp public abstract int AdjustUserPlaybackSignalVolume(uint uid, int volume); ``` 你可以在通话中调用该方法调节指定远端用户在本地播放的音量。如需调节多个用户在本地播放的音量,则需多次调用该方法。 ### 调用时机 [#调用时机] 该方法需要在加入频道后调用。 ### 调用限制 [#调用限制] 无。 ### 参数 [#参数] 远端用户 ID。 音量,取值范围为 [0,400]。 - 0: 静音。 - 100: (默认)原始音量。 - 400: 原始音量的 4 倍,自带溢出保护。 ### 返回值 [#返回值] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类] - [IRtcEngine](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengine) ## AdjustUserPlaybackSignalVolumeEx [#adjustuserplaybacksignalvolumeex] 调节本地播放的指定远端用户信号音量。 ```csharp public abstract int AdjustUserPlaybackSignalVolumeEx(uint uid, int volume, RtcConnection connection); ``` 你可以在通话中调用该方法调节指定远端用户在本地播放的音量。如需调节多个用户在本地播放的音量,则需多次调用该方法。 ### 调用时机 [#调用时机-1] 该方法需要在 [JoinChannelEx](/zh-CN/api-reference/rtc/csharp-windows/channel#api_irtcengineex_joinchannelex) 之后调用。 ### 调用限制 [#调用限制-1] 无。 ### 参数 [#参数-1] 远端用户 ID。 音量,取值范围为 [0,400]。 - 0: 静音。 - 100: (默认)原始音量。 - 400: 原始音量的 4 倍,自带溢出保护。 Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/csharp-windows/class-rtcconnection)。 ### 返回值 [#返回值-1] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-1] - [IRtcEngineEx](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengineex) ## DisableAudio [#disableaudio] 关闭音频模块。 ```csharp public abstract int DisableAudio(); ``` 音频模块默认开启,你可以调用该方法关闭音频模块。 ### 调用时机 [#调用时机-2] 加入频道前后均可调用。离开频道后仍然有效。 ### 调用限制 [#调用限制-2] 该方法重置整个引擎,响应时间较慢,因此声网建议使用如下方法来控制音频模块: - [EnableLocalAudio](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-capture#api_irtcengine_enablelocalaudio):是否启动麦克风采集并创建本地音频流。 - [EnableLoopbackRecording](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-capture#api_irtcengine_enableloopbackrecording):是否开启声卡采集。 - [MuteLocalAudioStream](/zh-CN/api-reference/rtc/csharp-windows/publishnsubscribe#api_irtcengine_mutelocalaudiostream):是否发布本地音频流。 - [MuteRemoteAudioStream](/zh-CN/api-reference/rtc/csharp-windows/publishnsubscribe#api_irtcengine_muteremoteaudiostream):是否接收并播放远端音频流。 - [MuteAllRemoteAudioStreams](/zh-CN/api-reference/rtc/csharp-windows/publishnsubscribe#api_irtcengine_muteallremoteaudiostreams):是否接收并播放所有远端音频流。 ### 返回值 [#返回值-2] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-2] - [IRtcEngine](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengine) ## EnableAudio [#enableaudio] 启用音频模块。 ```csharp public abstract int EnableAudio(); ``` 音频模块默认开启。如果你调用 [DisableAudio](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-basic#api_irtcengine_disableaudio) 关闭了音频模块,可调用该方法重新开启。 ### 调用时机 [#调用时机-3] 加入频道前后均可调用。离开频道后仍然有效。 ### 调用限制 [#调用限制-3] - 调用该方法会重置整个引擎,响应时间较慢。你可以根据实际需求用以下方法来独立控制音频模块的某一项功能: - [EnableLocalAudio](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-capture#api_irtcengine_enablelocalaudio): 是否启动麦克风采集并创建本地音频流。 - [MuteLocalAudioStream](/zh-CN/api-reference/rtc/csharp-windows/publishnsubscribe#api_irtcengine_mutelocalaudiostream): 是否发布本地音频流。 - [MuteRemoteAudioStream](/zh-CN/api-reference/rtc/csharp-windows/publishnsubscribe#api_irtcengine_muteremoteaudiostream): 是否接收并播放远端音频流。 - [MuteAllRemoteAudioStreams](/zh-CN/api-reference/rtc/csharp-windows/publishnsubscribe#api_irtcengine_muteallremoteaudiostreams): 是否接收并播放所有远端音频流。 - 在频道内调用该方法时,会重置 EnableLocalAudio、MuteRemoteAudioStream 和 MuteAllRemoteAudioStreams 的设置,需谨慎使用。 ### 返回值 [#返回值-3] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-3] - [IRtcEngine](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengine) ## EnableAudioVolumeIndication [#enableaudiovolumeindication] 启用用户音量提示。 ```csharp public abstract int EnableAudioVolumeIndication(int interval, int smooth, bool reportVad); ``` 该方法允许 SDK 定期向 App 报告本地发流用户和瞬时音量最高的远端用户(最多 3 位)的音量相关信息。 ### 调用时机 [#调用时机-4] 加入频道前后均可调用。 ### 调用限制 [#调用限制-4] 无。 ### 相关回调 [#相关回调] 成功调用该方法、且频道内存在发流用户时,SDK 会按设置的时间间隔触发 [OnAudioVolumeIndication](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-basic#callback_irtcengineeventhandler_onaudiovolumeindication) 回调。 ### 参数 [#参数-2] 指定音量提示的时间间隔: - ≤ 0: 禁用音量提示功能。 - > 0: 返回音量提示的间隔,单位为毫秒。建议设置到大于 100 毫秒,不得小于 10 毫秒,否则会收不到 OnAudioVolumeIndication 回调。 平滑系数,指定音量提示的灵敏度。取值范围为 [0,10],建议值为 3。数字越大,波动越灵敏;数字越小,波动越平滑。 - `true`:开启本地人声检测功能。开启后,OnAudioVolumeIndication 回调的 vad 参数会报告是否在本地检测到人声。 - `false`:(默认)关闭本地人声检测功能。除引擎自动进行本地人声检测的场景外,OnAudioVolumeIndication 回调的 vad 参数不会报告是否在本地检测到人声。 ### 返回值 [#返回值-4] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-4] - [IRtcEngine](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengine) ## EnableAudioVolumeIndicationEx [#enableaudiovolumeindicationex] 启用用户音量提示。 ```csharp public abstract int EnableAudioVolumeIndicationEx(int interval, int smooth, bool reportVad, RtcConnection connection); ``` 该方法允许 SDK 定期向 App 报告本地发流用户和瞬时音量最高的远端用户(最多 3 位)的音量相关信息。 ### 调用时机 [#调用时机-5] 该方法需要在 [JoinChannelEx](/zh-CN/api-reference/rtc/csharp-windows/channel#api_irtcengineex_joinchannelex) 之后调用。 ### 调用限制 [#调用限制-5] 无。 ### 相关回调 [#相关回调-1] 成功调用该方法、且频道内存在发流用户时,SDK 会按设置的时间间隔触发 [OnAudioVolumeIndication](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-basic#callback_irtcengineeventhandler_onaudiovolumeindication) 回调。 ### 参数 [#参数-3] 指定音量提示的时间间隔: - ≤ 0: 禁用音量提示功能。 - > 0: 返回音量提示的间隔,单位为毫秒。建议设置到大于 100 毫秒,不得小于 10 毫秒,否则会收不到 OnAudioVolumeIndication 回调。 平滑系数,指定音量提示的灵敏度。取值范围为 [0,10],建议值为 3。数字越大,波动越灵敏;数字越小,波动越平滑。 - `true`:开启本地人声检测功能。开启后,OnAudioVolumeIndication 回调的 vad 参数会报告是否在本地检测到人声。 - `false`:(默认)关闭本地人声检测功能。除引擎自动进行本地人声检测的场景外,OnAudioVolumeIndication 回调的 vad 参数不会报告是否在本地检测到人声。 Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/csharp-windows/class-rtcconnection)。 ### 返回值 [#返回值-5] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-5] - [IRtcEngineEx](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengineex) ## SetAudioProfile [1/2] [#setaudioprofile-12] 设置音频编码属性和音频场景。 ```csharp public abstract int SetAudioProfile(AUDIO_PROFILE_TYPE profile, AUDIO_SCENARIO_TYPE scenario); ``` :::error[弃用:] 此方法已废弃,如需设置音频编码属性,请改用 [SetAudioProfile [2/2]](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-basic#api_irtcengine_setaudioprofile2);如需设置音频场景,请改用 [SetAudioScenario](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-basic#api_irtcengine_setaudioscenario)。 ::: ### 适用场景 [#适用场景] 该方法适用于各种音频场景,你可以按需选择。例如,在音乐教学等高音质需求的场景中,建议将 profile 设置为 `AUDIO_PROFILE_MUSIC_HIGH_QUALITY`(4),scenario 设置为 `AUDIO_SCENARIO_GAME_STREAMING`(3)。 ### 调用时机 [#调用时机-6] 该方法在加入频道前后均可调用。 ### 调用限制 [#调用限制-6] 无。 ### 参数 [#参数-4] 音频编码属性,包含采样率、码率、编码模式和声道数。详见 [AUDIO_PROFILE_TYPE](/zh-CN/api-reference/rtc/csharp-windows/enum-audioprofiletype)。 音频场景。不同的音频场景下,设备的音量类型是不同的。 详见 [AUDIO_SCENARIO_TYPE](/zh-CN/api-reference/rtc/csharp-windows/enum-audioscenariotype)。 ### 返回值 [#返回值-6] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-6] - [IRtcEngine](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengine) ## SetAudioProfile [2/2] [#setaudioprofile-22] 设置音频编码属性。 ```csharp public abstract int SetAudioProfile(AUDIO_PROFILE_TYPE profile); ``` 如果你想设置音频应用场景,可以直接调用 [SetAudioScenario](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-basic#api_irtcengine_setaudioscenario) 方法进行设置,也可以调用 [Initialize](/zh-CN/api-reference/rtc/csharp-windows/initialize#api_irtcengine_initialize) 并设置 [RtcEngineContext](/zh-CN/api-reference/rtc/csharp-windows/class-rtcengineconfig) 结构体中的 audioScenario。 ### 适用场景 [#适用场景-1] 该方法适用于各种音频场景,你可以按需选择。例如,在音乐教学等高音质需求的场景中,建议将 `profile` 设置为 `AUDIO_PROFILE_MUSIC_HIGH_QUALITY`(4)。 ### 调用时机 [#调用时机-7] 该方法在加入频道前后均可调用。 ### 调用限制 [#调用限制-7] 无。 ### 参数 [#参数-5] 音频编码属性,包含采样率、码率、编码模式和声道数。详见 [AUDIO_PROFILE_TYPE](/zh-CN/api-reference/rtc/csharp-windows/enum-audioprofiletype)。 ### 返回值 [#返回值-7] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ## SetAudioScenario [#setaudioscenario] 设置音频场景。 ```csharp public abstract int SetAudioScenario(AUDIO_SCENARIO_TYPE scenario); ``` ### 适用场景 [#适用场景-2] 该方法适用于各种音频场景,你可以按需选择。例如,在音乐教学等高音质需求的场景中,建议将 scenario 设置为 `AUDIO_SCENARIO_GAME_STREAMING`(3)。 ### 调用时机 [#调用时机-8] 该方法在加入频道前后均可调用。 ### 调用限制 [#调用限制-8] 无。 ### 参数 [#参数-6] 音频场景。不同的音频场景下,设备的音量类型是不同的。 详见 [AUDIO_SCENARIO_TYPE](/zh-CN/api-reference/rtc/csharp-windows/enum-audioscenariotype)。 ### 返回值 [#返回值-8] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-7] - [IRtcEngine](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengine) ## OnActiveSpeaker [#onactivespeaker] 监测到远端最活跃用户回调。 ```csharp public virtual void OnActiveSpeaker(RtcConnection connection, uint uid) { } ``` ### 详情 [#详情] 成功调用 [EnableAudioVolumeIndication](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-basic#api_irtcengine_enableaudiovolumeindication) 后,SDK 会持续监测音量最大的远端用户,并统计该用户被判断为音量最大者的次数。当前时间段内,该次数累积最多的远端用户为最活跃的用户。 当频道内用户数量大于或等于 2 且有远端活跃用户时,SDK 会触发该回调并报告远端最活跃用户的 uid。 - 如果远端最活跃用户一直是同一位用户,则 SDK 不会再次触发 OnActiveSpeaker 回调。 - 如果远端最活跃用户有变化,则 SDK 会再次触发该回调并报告新的远端最活跃用户的 uid。 ### 参数 [#参数-7] Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/csharp-windows/class-rtcconnection)。 远端最活跃用户的 ID。 ### 所属接口类 [#所属接口类-8] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengineeventhandler) ## OnAudioQuality [#onaudioquality] 远端声音质量回调。 ```csharp public virtual void OnAudioQuality(RtcConnection connection, uint remoteUid, int quality, UInt16 delay, UInt16 lost) {} ``` ### 详情 [#详情-1] :::error[弃用:] 请改用 [OnRemoteAudioStats](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-basic#callback_irtcengineeventhandler_onremoteaudiostats)。 ::: 该回调描述远端用户在通话中的音频质量,针对每个远端用户/主播每 2 秒触发一次。如果远端同时存在多个用户/主播,该回调每 2 秒会被触发多次。 ### 参数 [#参数-8] Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/csharp-windows/class-rtcconnection)。 用户 ID,指定是谁发的音频流。 语音质量。详见 [QUALITY_TYPE](/zh-CN/api-reference/rtc/csharp-windows/enum-qualitytype)。 音频包从发送端到接收端的延迟(毫秒),包括声音采样前处理、网络传输、网络抖动缓冲引起的延迟。 音频包从发送端到接收端的丢包率 (%)。 ### 所属接口类 [#所属接口类-9] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengineeventhandler) ## OnAudioVolumeIndication [#onaudiovolumeindication] 用户音量提示回调。 ```csharp public virtual void OnAudioVolumeIndication(RtcConnection connection, AudioVolumeInfo[] speakers, uint speakerNumber, int totalVolume) {} ``` ### 详情 [#详情-2] 该回调默认禁用,你可以通过 [EnableAudioVolumeIndication](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-basic#api_irtcengine_enableaudiovolumeindication) 开启。 开启后,只要频道内有发流用户,SDK 会在加入频道后按 EnableAudioVolumeIndication 中设置的时间间隔触发 OnAudioVolumeIndication 回调。每次会触发两个 OnAudioVolumeIndication 回调,一个报告本地发流用户的音量相关信息,另一个报告瞬时音量最高的远端用户(最多 3 位)的音量相关信息。 :::caution 注意: 启用该功能后,如果有用户将自己静音(调用了 [MuteLocalAudioStream](/zh-CN/api-reference/rtc/csharp-windows/publishnsubscribe#api_irtcengine_mutelocalaudiostream)),SDK 会继续报告本地用户的音量提示回调。 瞬时音量最高的远端用户静音后 20 秒,远端的音量提示回调中将不再包含该用户;如果远端所有用户都将自己静音,20 秒后 SDK 停止报告远端用户的音量提示回调。 ::: ### 参数 [#参数-9] Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/csharp-windows/class-rtcconnection)。 用户音量信息,详见 [AudioVolumeInfo](/zh-CN/api-reference/rtc/csharp-windows/class-audiovolumeinfo) 数组。如果 speakers 为空,则表示远端用户不发流或没有远端用户。 用户数量。 - 在本地用户的回调中,只要本地用户在发流,speakerNumber 始终为 1。 - 在远端用户的回调中,speakerNumber 取值范围为 [0,3]。如果远端发流用户数量大于 3,则此回调中 speakerNumber 值为 3。 混音后的总音量,取值范围为 [0,255]。 - 在本地用户的回调中,totalVolume 为本地发流用户的音量。 - 在远端用户的回调中,totalVolume 为瞬时音量最高的远端用户(最多 3 位)混音后的总音量。 ### 所属接口类 [#所属接口类-10] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengineeventhandler) ## OnFirstLocalAudioFramePublished [#onfirstlocalaudioframepublished] 已发布本地音频首帧回调。 ```csharp public virtual void OnFirstLocalAudioFramePublished(RtcConnection connection, int elapsed) {} ``` ### 详情 [#详情-3] SDK 会在以下时机触发该回调: - 开启本地音频的情况下,调用 JoinChannel [2/2] 成功加入频道后。 - 调用 [MuteLocalAudioStream](/zh-CN/api-reference/rtc/csharp-windows/publishnsubscribe#api_irtcengine_mutelocalaudiostream)(`true)`,再调用 MuteLocalAudioStream(`false)` 后。 - 调用 [DisableAudio](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-basic#api_irtcengine_disableaudio),再调用 [EnableAudio](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-basic#api_irtcengine_enableaudio) 后。 - 调用 [PushAudioFrame](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-custom-capturenrendering#api_imediaengine_pushaudioframe0) 成功向 SDK 推送音频帧后。 ### 参数 [#参数-10] Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/csharp-windows/class-rtcconnection)。 从调用 JoinChannel [2/2] 方法到触发该回调的时间间隔(毫秒)。 ### 所属接口类 [#所属接口类-11] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengineeventhandler) ## OnFirstRemoteAudioDecoded [#onfirstremoteaudiodecoded] 已解码远端音频首帧的回调。 ```csharp public virtual void OnFirstRemoteAudioDecoded(RtcConnection connection, uint uid, int elapsed) { } ``` ### 详情 [#详情-4] :::error[弃用:] 请改用 [OnRemoteAudioStateChanged](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-basic#callback_irtcengineeventhandler_onremoteaudiostatechanged) 。 ::: SDK 会在以下时机触发该回调: - 远端用户首次上线后发送音频。 - 远端用户音频离线再上线发送音频。音频离线指本地在 15 秒内没有收到音频包,可能有如下原因: - 远端用户离开频道 - 远端用户掉线 - 远端用户调用 [MuteLocalAudioStream](/zh-CN/api-reference/rtc/csharp-windows/publishnsubscribe#api_irtcengine_mutelocalaudiostream) 方法停止发送音频流 - 远端用户调用 [DisableAudio](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-basic#api_irtcengine_disableaudio) 方法关闭音频 ### 参数 [#参数-11] Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/csharp-windows/class-rtcconnection)。 远端用户 ID。 从本地用户调用 JoinChannel [2/2] 直至该回调触发的延迟,单位为毫秒。 ### 所属接口类 [#所属接口类-12] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengineeventhandler) ## OnFirstRemoteAudioFrame [#onfirstremoteaudioframe] 已接收远端音频首帧回调。 ```csharp public virtual void OnFirstRemoteAudioFrame(RtcConnection connection, uint userId, int elapsed) { } ``` ### 详情 [#详情-5] :::error[弃用:] 请改用 [OnRemoteAudioStateChanged](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-basic#callback_irtcengineeventhandler_onremoteaudiostatechanged) 。 ::: ### 参数 [#参数-12] Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/csharp-windows/class-rtcconnection)。 发送音频帧的远端用户的用户 ID。 从本地用户调用 JoinChannel [2/2] 直至该回调触发的延迟,单位为毫秒。 ### 所属接口类 [#所属接口类-13] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengineeventhandler) ## OnLocalAudioStateChanged [#onlocalaudiostatechanged] 本地音频状态发生改变回调。 ```csharp public virtual void OnLocalAudioStateChanged(RtcConnection connection, LOCAL_AUDIO_STREAM_STATE state, LOCAL_AUDIO_STREAM_REASON reason) ``` ### 详情 [#详情-6] 本地音频的状态发生改变时(包括本地麦克风采集状态和音频编码状态),SDK 会触发该回调报告当前的本地音频状态。在本地音频出现故障时,该回调可以帮助你了解当前音频的状态以及出现故障的原因,方便你排查问题。 :::caution 注意: 当状态为 LOCAL_AUDIO_STREAM_STATE_FAILED (3) 时, 你可以在 error 参数中查看返回的错误信息。 ::: ### 参数 [#参数-13] Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/csharp-windows/class-rtcconnection)。 当前的本地音频状态。详见 [LOCAL_AUDIO_STREAM_STATE](/zh-CN/api-reference/rtc/csharp-windows/enum-localaudiostreamstate)。 本地音频状态改变原因。详见 [LOCAL_AUDIO_STREAM_REASON](/zh-CN/api-reference/rtc/csharp-windows/enum-localaudiostreamreason)。 ### 所属接口类 [#所属接口类-14] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengineeventhandler) ## OnLocalAudioStats [#onlocalaudiostats] 通话中本地音频流的统计信息回调。 ```csharp public virtual void OnLocalAudioStats(RtcConnection connection, LocalAudioStats stats) {} ``` ### 详情 [#详情-7] SDK 每 2 秒触发该回调一次。 ### 参数 [#参数-14] Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/csharp-windows/class-rtcconnection)。 本地音频统计数据。详见 [LocalAudioStats](/zh-CN/api-reference/rtc/csharp-windows/class-localaudiostats)。 ### 所属接口类 [#所属接口类-15] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengineeventhandler) ## OnRemoteAudioStateChanged [#onremoteaudiostatechanged] 远端音频流状态发生改变回调。 ```csharp public virtual void OnRemoteAudioStateChanged(RtcConnection connection, uint remoteUid, REMOTE_AUDIO_STATE state, REMOTE_AUDIO_STATE_REASON reason, int elapsed) {} ``` ### 详情 [#详情-8] 远端用户(通信场景)或主播(直播场景)的音频状态发生改变时,SDK 会触发该回调向本地用户报告当前的远端音频流状态。 :::caution 注意: 频道内的用户(通信场景)或主播(直播场景)人数超过 32 人时,该回调可能不准确。 ::: ### 参数 [#参数-15] Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/csharp-windows/class-rtcconnection)。 发生音频状态改变的远端用户 ID。 远端音频流状态,详见 [REMOTE_AUDIO_STATE](/zh-CN/api-reference/rtc/csharp-windows/enum-remoteaudiostate)。 远端音频流状态改变的具体原因,详见 [REMOTE_AUDIO_STATE_REASON](/zh-CN/api-reference/rtc/csharp-windows/enum-remoteaudiostatereason)。 从本地用户调用 JoinChannel [2/2] 方法到发生本事件经历的时间,单位为毫秒。 ### 所属接口类 [#所属接口类-16] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengineeventhandler) ## OnRemoteAudioStats [#onremoteaudiostats] 通话中远端音频流的统计信息回调。 ```csharp public virtual void OnRemoteAudioStats(RtcConnection connection, RemoteAudioStats stats) {} ``` ### 详情 [#详情-9] 该回调针对每个发送音频流的远端用户/主播每 2 秒触发一次。如果远端有多个用户/主播发送音频流,该回调每 2 秒会被触发多次。 ### 参数 [#参数-16] Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/csharp-windows/class-rtcconnection)。 接收到的远端音频统计数据,详见 [RemoteAudioStats](/zh-CN/api-reference/rtc/csharp-windows/class-remoteaudiostats)。 ### 所属接口类 [#所属接口类-17] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengineeventhandler) ## OnRemoteAudioTransportStats [#onremoteaudiotransportstats] 通话中远端音频流传输的统计信息回调。 ```csharp public virtual void OnRemoteAudioTransportStats(RtcConnection connection, uint remoteUid, UInt16 delay, UInt16 lost, UInt16 rxKBitRate) {} ``` ### 详情 [#详情-10] :::error[弃用:] 请改用 [OnRemoteAudioStats](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-basic#callback_irtcengineeventhandler_onremoteaudiostats)。 ::: 该回调描述远端用户通话中端到端的网络统计信息,通过音频包计算,用客观的数据,如丢包、 网络延迟等,展示当前网络状态。通话中,当用户收到远端用户/主播发送的音频数据包后,会每 2 秒触发一次该回调。 ### 参数 [#参数-17] Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/csharp-windows/class-rtcconnection)。 用户 ID,指定是哪个用户/主播的音频包。 音频包从发送端到接收端的延时(毫秒)。 音频包从发送端到接收端的丢包率 (%)。 远端音频包的接收码率(Kbps)。 ### 所属接口类 [#所属接口类-18] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengineeventhandler) ## OnUserMuteAudio [#onusermuteaudio] 远端用户(通信场景)/主播(直播场景)停止或恢复发送音频流回调。 ```csharp public virtual void OnUserMuteAudio(RtcConnection connection, uint remoteUid, bool muted) { } ``` ### 详情 [#详情-11] 该回调是由远端用户调用 [MuteLocalAudioStream](/zh-CN/api-reference/rtc/csharp-windows/publishnsubscribe#api_irtcengine_mutelocalaudiostream) 方法关闭或开启音频发送触发的。 :::caution 注意: 频道内的用户(通信场景)或主播(直播场景)人数超过 32 人时,该回调可能不准确。 ::: ### 参数 [#参数-18] Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/csharp-windows/class-rtcconnection)。 用户 ID。 该用户是否静音: - `true`: 该用户已将音频静音。 - `false`: 该用户取消了音频静音。 ### 所属接口类 [#所属接口类-19] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengineeventhandler)