# 本地音频合流 (/zh-CN/api-reference/rtc/unity/audio/audio-prenpost/audiomixer)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## StartLocalAudioMixer [#startlocalaudiomixer]
开启本地音频合流。
```csharp
public abstract int StartLocalAudioMixer(LocalAudioMixerConfiguration config);
```
该方法支持在本地将多路音频流合并为一路音频流。例如:将本地麦克风采集的音频流、媒体播放器中的音频流、声卡采集的音频流、远端音频流等合并为一路音频流,然后将合流后的音频流发布到频道中。
- 如果你要对本地采集的音频流进行合流,可以将 [ChannelMediaOptions](/zh-CN/api-reference/rtc/unity/class-channelmediaoptions) 中的 publishMixedAudioTrack 设置为 true,则可将合流后的音频流发布到频道中。
- 如果你要对远端音频流进行合流,需确保远端音频流已在频道内发布并且已被订阅。
:::note
注: 为了保证音频质量,建议参与本地合流的音频流数量不超过 10 个。
:::
### 适用场景 [#适用场景]
你可以在如下场景中开启该功能:
- 结合本地合图功能一起使用,可将合图视频流相关的音频流同步采集和发布。
- 在直播场景下,用户接收频道内的音频流,在本地进行多路音频流合流后转发到其他频道。
- 在教育场景下,老师可将跟学生连麦互动的音频在本地进行合流,然后将合并的音频流转发到其他频道。
### 调用时机 [#调用时机]
该方法在加入频道前后均可调用。
### 参数 [#参数]
本地音频合流的配置。详见 [LocalAudioMixerConfiguration](/zh-CN/api-reference/rtc/unity/class-localaudiomixerconfiguration)。
### 返回值 [#返回值]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
- -7:[IRtcEngine](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengine) 对象尚未初始化。你需要在调用该方法前成功初始化 [IRtcEngine](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengine) 对象。
### 所属接口类 [#所属接口类]
- [IRtcEngine](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengine)
## StopLocalAudioMixer [#stoplocalaudiomixer]
停止本地音频合流。
```csharp
public abstract int StopLocalAudioMixer();
```
调用 [StartLocalAudioMixer](/zh-CN/api-reference/rtc/unity/audio/audio-prenpost/audiomixer#api_irtcengine_startlocalaudiomixer) 后,如果你希望停止本地音频合流,请调用该方法。
### 调用时机 [#调用时机-1]
该方法需要在 [StartLocalAudioMixer](/zh-CN/api-reference/rtc/unity/audio/audio-prenpost/audiomixer#api_irtcengine_startlocalaudiomixer) 之后调用。
### 返回值 [#返回值-1]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
- -7:[IRtcEngine](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengine) 对象尚未初始化。你需要在调用该方法前成功初始化 [IRtcEngine](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengine) 对象。
### 所属接口类 [#所属接口类-1]
- [IRtcEngine](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengine)
## UpdateLocalAudioMixerConfiguration [#updatelocalaudiomixerconfiguration]
更新本地音频合流的配置。
```csharp
public abstract int UpdateLocalAudioMixerConfiguration(LocalAudioMixerConfiguration config);
```
调用 [StartLocalAudioMixer](/zh-CN/api-reference/rtc/unity/audio/audio-prenpost/audiomixer#api_irtcengine_startlocalaudiomixer) 后,如果你希望更新本地音频合流的配置,请调用该方法。
:::note
注: 为了保证音频质量,建议参与本地合流的音频流数量不超过 10 个。
:::
### 调用时机 [#调用时机-2]
该方法需要在 [StartLocalAudioMixer](/zh-CN/api-reference/rtc/unity/audio/audio-prenpost/audiomixer#api_irtcengine_startlocalaudiomixer) 之后调用。
### 参数 [#参数-1]
本地音频合流的配置。详见 [LocalAudioMixerConfiguration](/zh-CN/api-reference/rtc/unity/class-localaudiomixerconfiguration)。
### 返回值 [#返回值-2]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
- -7:[IRtcEngine](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengine) 对象尚未初始化。你需要在调用该方法前成功初始化 [IRtcEngine](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengine) 对象。
### 所属接口类 [#所属接口类-2]
- [IRtcEngine](/zh-CN/api-reference/rtc/unity/rtc-interface-class#class_irtcengine)