# 自定义音频采集和渲染 (/zh-CN/api-reference/rtc/csharp-windows/audio/audio-custom-capturenrendering)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## AdjustCustomAudioPlayoutVolume [#adjustcustomaudioplayoutvolume]
调节自定义音频采集轨道在本地播放的音量。
```csharp
public abstract int AdjustCustomAudioPlayoutVolume(uint trackId, int volume);
```
### 详情 [#详情]
:::caution
注意: 在调用该方法前,请确保你已经调用 [CreateCustomAudioTrack](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-custom-capturenrendering#api_imediaengine_createcustomaudiotrack) 方法创建自定义音频采集轨道。
:::
调用该方法设置音频在本地播放的音量后,如果你想重新调整音量,你可以再次调用该方法。
### 参数 [#参数]
音频轨道 ID。将该参数设置为调用 CreateCustomAudioTrack 方法返回的自定义音频轨道 ID。
自定义采集音频的播放音量,取值范围为 [0,100]。0 表示静音,100 表示原始音量。
### 返回值 [#返回值]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类]
- [IRtcEngine](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengine)
## AdjustCustomAudioPublishVolume [#adjustcustomaudiopublishvolume]
调节自定义音频采集轨道在远端播放的音量。
```csharp
public abstract int AdjustCustomAudioPublishVolume(uint trackId, int volume);
```
### 详情 [#详情-1]
:::caution
注意: 在调用该方法前,请确保你已经调用 [CreateCustomAudioTrack](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-custom-capturenrendering#api_imediaengine_createcustomaudiotrack) 方法创建自定义音频采集轨道。
:::
调用该方法设置音频在远端播放的音量后,如果你想重新调整音量,你可以再次调用该方法。
### 参数 [#参数-1]
音频轨道 ID。将该参数设置为调用 CreateCustomAudioTrack 方法返回的自定义音频轨道 ID。
自定义采集音频的播放音量,取值范围为 [0,100]。0 表示静音,100 表示原始音量。
### 返回值 [#返回值-1]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-1]
- [IRtcEngine](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengine)
## CreateCustomAudioTrack [#createcustomaudiotrack]
创建一个自定义音频采集轨道。
```csharp
public abstract uint CreateCustomAudioTrack(AUDIO_TRACK_TYPE trackType, AudioTrackConfig config);
```
### 详情 [#详情-2]
:::caution
注意: 该方法需要在加入频道前调用。
:::
如需在频道中发布自定义采集音频,可参考以下步骤:
1. 调用该方法创建音频轨道并获得音频轨道 ID。
2. 调用 [JoinChannel [2/2]](/zh-CN/api-reference/rtc/csharp-windows/channel#api_irtcengine_joinchannel2) 加入频道时,将 [ChannelMediaOptions](/zh-CN/api-reference/rtc/csharp-windows/class-channelmediaoptions) 中的 publishCustomAudioTrackId 设置为你想要发布的音频轨道 ID,并将 publishCustomAudioTrack 设置为 `true`。
3. 调用 [PushAudioFrame](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-custom-capturenrendering#api_imediaengine_pushaudioframe0) 将 trackId 指定为步骤 2 中指定的音频轨道 ID,即可实现在频道内发布对应的自定义音频源。
### 参数 [#参数-2]
自定义音频轨道类型。详见 [AUDIO_TRACK_TYPE](/zh-CN/api-reference/rtc/csharp-windows/enum-audiotracktype)。
:::caution
注意: 如指定 AUDIO_TRACK_DIRECT,则必须在调用 [JoinChannel [2/2]](/zh-CN/api-reference/rtc/csharp-windows/channel#api_irtcengine_joinchannel2) 加入频道时,将 [ChannelMediaOptions](/zh-CN/api-reference/rtc/csharp-windows/class-channelmediaoptions) 中的 `publishMicrophoneTrack` 设为 `false`,否则加入频道失败并返回错误码 -2。
:::
自定义音频轨道配置。详见 [AudioTrackConfig](/zh-CN/api-reference/rtc/csharp-windows/class-audiotrackconfig)。
### 返回值 [#返回值-2]
- 方法调用成功,返回音频轨道 ID 作为该音频轨道的唯一标识。
- 方法调用失败,返回 0xffffffff。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
## DestroyCustomAudioTrack [#destroycustomaudiotrack]
销毁指定的音频轨道。
```csharp
public abstract int DestroyCustomAudioTrack(uint trackId);
```
### 详情 [#详情-3]
### 参数 [#参数-3]
调用 [CreateCustomAudioTrack](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-custom-capturenrendering#api_imediaengine_createcustomaudiotrack) 方法返回的自定义音频轨道 ID。
### 返回值 [#返回值-3]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
## SetExternalAudioSource [#setexternalaudiosource]
设置外部音频采集参数。
```csharp
public abstract int SetExternalAudioSource(bool enabled, int sampleRate, int channels, bool localPlayback = false, bool publish = true);
```
:::error[弃用:]
该方法已废弃,请改用 [CreateCustomAudioTrack](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-custom-capturenrendering#api_imediaengine_createcustomaudiotrack)。
:::
### 调用时机 [#调用时机]
该方法需要在加入频道前调用。
### 调用限制 [#调用限制]
无。
### 参数 [#参数-4]
是否开启使用外部音频源的功能:
- `true`:开启外部音频源。
- `false`:(默认)关闭外部音频源。
外部音频源的采样率 (Hz),可设置为 `8000`,`16000`,`32000`,`44100` 或 `48000`。
外部音频源的声道数,可设置为 `1`(单声道)或 `2`(双声道)。
是否在本地播放外部音频源:
- `true`:在本地播放。
- `false`:(默认)不在本地播放。
是否将音频发布到远端:
- `true`:(默认)发布到远端。
- `false`:不发布到远端。
### 返回值 [#返回值-4]
- 0:方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
## PullAudioFrame [#pullaudioframe]
拉取远端音频数据。
```csharp
public abstract int PullAudioFrame(AudioFrame frame);
```
调用该方法后,App 会采取主动拉取的方式获取远端已解码和混音后的音频数据,用于音频播放。
### 调用时机 [#调用时机-1]
该方法需要在加入频道后调用。
调用该方法前,你需要调用 [SetExternalAudioSink](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-custom-capturenrendering#api_imediaengine_setexternalaudiosink)`(enabled: true)` 开启并设置外部渲染。
### 调用限制 [#调用限制-1]
该方法和 [OnPlaybackAudioFrame](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-raw#callback_iaudioframeobserverbase_onplaybackaudioframe) 回调均可用于获取远端混音后的音频播放数据。在调用 SetExternalAudioSink 开启外部音频渲染后,App 将无法从 OnPlaybackAudioFrame 回调中获得数据。因此,请根据实际的业务需求在该方法和 OnPlaybackAudioFrame 回调之间进行选择。二者的处理机制不同,具体区别如下:
- 调用该方法后,App 会主动拉取音频数据。通过设置音频数据,SDK 可以调整缓存,帮助 App 处理延时,从而有效避免音频播放抖动。
- 注册 OnPlaybackAudioFrame 回调后,SDK 通过该回调将音频数据传输给 App。App 在处理音频帧的延迟时,可能会导致音频播放抖动。
该方法仅用于拉取远端混音后的音频播放数据,如需获取采集的原始音频数据、混音前每条拉流单独的原始音频播放数据等,可以通过调用 [RegisterAudioFrameObserver](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-raw#api_imediaengine_registeraudioframeobserver) 注册相应的回调。
### 参数 [#参数-5]
指向 [AudioFrame](/zh-CN/api-reference/rtc/csharp-windows/class-audioframe) 的指针。
### 返回值 [#返回值-5]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
## PushAudioFrame [#pushaudioframe]
推送外部音频帧。
```csharp
public abstract int PushAudioFrame(AudioFrame frame, uint trackId = 0);
```
调用该方法通过音频轨道推送外部音频帧。
### 调用时机 [#调用时机-2]
调用该方法推送外部音频数据前,请先进行以下操作:
1. 调用 [CreateCustomAudioTrack](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-custom-capturenrendering#api_imediaengine_createcustomaudiotrack) 创建音频轨道并获得音频轨道 ID。
2. 调用 [JoinChannel [2/2]](/zh-CN/api-reference/rtc/csharp-windows/channel#api_irtcengine_joinchannel2) 加入频道时,将 [ChannelMediaOptions](/zh-CN/api-reference/rtc/csharp-windows/class-channelmediaoptions) 中的 publishCustomAudioTrackId 设置为你想要发布的音频轨道 ID,并将 publishCustomAudioTrack 设置为 `true`。
### 调用限制 [#调用限制-2]
无。
### 参数 [#参数-6]
外部音频帧。详见 [AudioFrame](/zh-CN/api-reference/rtc/csharp-windows/class-audioframe)。
音频轨道 ID。如果你要发布自定义的外部音频源,则将该参数设置为你想要发布的自定义音频轨道 ID。
### 返回值 [#返回值-6]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
## SetExternalAudioSink [#setexternalaudiosink]
设置外部音频渲染。
```csharp
public abstract int SetExternalAudioSink(bool enabled, int sampleRate, int channels);
```
调用该方法开启外部音频渲染后,你可以调用 [PullAudioFrame](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-custom-capturenrendering#api_imediaengine_pullaudioframe) 拉取远端音频数据。App 可以对拉取到的原始音频数据进行处理后再渲染,获取想要的音频效果。
### 适用场景 [#适用场景]
该方法适用于需要自行渲染音频的场景。
### 调用时机 [#调用时机-3]
该方法需要在加入频道前调用。
### 调用限制 [#调用限制-3]
调用该方法开启外部音频渲染后,App 将无法从 [OnPlaybackAudioFrame](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-raw#callback_iaudioframeobserverbase_onplaybackaudioframe) 回调中获得数据。
### 参数 [#参数-7]
设置是否开启外部音频渲染:
- `true`:开启外部音频渲染。
- `false`:(默认)关闭外部音频渲染。
外部音频渲染的采样率 (Hz),可设置为 16000,32000,44100 或 48000。
外部音频渲染的声道数:
- 1: 单声道
- 2: 双声道
### 返回值 [#返回值-7]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-2]
- [IRtcEngine](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengine)