# 自定义音频采集和渲染 (/zh-CN/api-reference/rtc/android/audio/audio-custom-capturenrendering) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## adjustCustomAudioPlayoutVolume [#adjustcustomaudioplayoutvolume] 调节本地播放的自定义音频轨道的音量。 ```java public abstract int adjustCustomAudioPlayoutVolume(int trackId, int volume); ``` 如果你希望更改本地播放的音频音量,需要再次调用该方法。 :::note 注: 请确保在调用该方法前,已调用 [createCustomAudioTrack](/zh-CN/api-reference/rtc/android/audio/audio-custom-capturenrendering#api_irtcengine_createcustomaudiotrack) 创建自定义音频轨道。 ::: ### 参数 [#参数] 音频轨道 ID。设置为 [createCustomAudioTrack](/zh-CN/api-reference/rtc/android/audio/audio-custom-capturenrendering#api_irtcengine_createcustomaudiotrack) 返回的自定义音频轨道 ID。 音频源的音量,取值范围为 0 到 100。 - 0:静音。 - 100:原始音量。 ### 返回值 [#返回值] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类] - [RtcEngine](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_irtcengine) ## adjustCustomAudioPublishVolume [#adjustcustomaudiopublishvolume] 调节远端播放的自定义音频轨道的音量。 ```java public abstract int adjustCustomAudioPublishVolume(int trackId, int volume); ``` 如果你想更改远端播放的音频音量,需要再次调用该方法。 :::note 注: 请确保在调用该方法前已调用 [createCustomAudioTrack](/zh-CN/api-reference/rtc/android/audio/audio-custom-capturenrendering#api_irtcengine_createcustomaudiotrack) 创建自定义音频轨道。 ::: ### 参数 [#参数-1] 音频轨道 ID。设置为 [createCustomAudioTrack](/zh-CN/api-reference/rtc/android/audio/audio-custom-capturenrendering#api_irtcengine_createcustomaudiotrack) 返回的自定义音频轨道 ID。 音频源的音量,取值范围为 0 到 100。 - 0:静音。 - 100:原始音量。 ### 返回值 [#返回值-1] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-1] - [RtcEngine](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_irtcengine) ## createCustomAudioTrack [#createcustomaudiotrack] 创建一个自定义音频轨道。 ```java public abstract int createCustomAudioTrack(Constants.AudioTrackType trackType, AudioTrackConfig config) ``` 你可以通过以下步骤发布自定义音频源: 1. 调用该方法创建一个自定义音频轨道,并获取音频轨道 ID。 2. 调用 `joinChannel` 加入频道。在 [ChannelMediaOptions](/zh-CN/api-reference/rtc/android/class-channelmediaoptions) 中,将 `publishCustomAudioTrackId` 设置为步骤 1 中获取的音频轨道 ID,并将 `publishCustomAudioTrack` 设置为 true。 3. 调用 [pushExternalAudioFrame](/zh-CN/api-reference/rtc/android/audio/audio-custom-capturenrendering#api_irtcengine_pushaudioframe2),并将 `trackId` 设置为步骤 2 中的音频轨道 ID,即可在频道中发布对应的自定义音频源。 :::note 注: 该方法需要在加入频道前调用。 ::: ### 参数 [#参数-2] 自定义音频轨道的类型,详见 [AudioTrackType](/zh-CN/api-reference/rtc/android/enum-audiotracktype)。 :::note 注: 如果该参数设置为 `AUDIO_TRACK_DIRECT`,则在调用 `joinChannel` 加入频道时,必须将 [ChannelMediaOptions](/zh-CN/api-reference/rtc/android/class-channelmediaoptions) 中的 `publishMicrophoneTrack` 设置为 false,否则加入频道会失败并返回错误码 -2。 ::: 自定义音频轨道的配置,详见 [AudioTrackConfig](/zh-CN/api-reference/rtc/android/class-audiotrackconfig)。 ### 返回值 [#返回值-2] - 方法调用成功,返回音频轨道 ID,作为该音频轨道的唯一标识。 - 方法调用失败,返回 `0xffffffff`。 ### 所属接口类 [#所属接口类-2] - [RtcEngine](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_irtcengine) ## destroyCustomAudioTrack [#destroycustomaudiotrack] 销毁指定的音频轨道。 ```java public abstract int destroyCustomAudioTrack(int trackId); ``` ### 参数 [#参数-3] 在 [createCustomAudioTrack](/zh-CN/api-reference/rtc/android/audio/audio-custom-capturenrendering#api_irtcengine_createcustomaudiotrack) 中返回的自定义音频轨道 ID。 ### 返回值 [#返回值-3] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-3] - [RtcEngine](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_irtcengine) ## enableCustomAudioLocalPlayback [#enablecustomaudiolocalplayback] 设置是否启用外部音频源的本地播放。 ```java public abstract int enableCustomAudioLocalPlayback(int trackId, boolean enabled); ``` 你可以调用 [adjustCustomAudioPlayoutVolume](/zh-CN/api-reference/rtc/android/audio/audio-custom-capturenrendering#api_irtcengine_adjustcustomaudioplayoutvolume) 方法调整自定义音频轨道的本地播放音量。 :::note 注: 请确保在调用该方法前,已通过调用 [createCustomAudioTrack](/zh-CN/api-reference/rtc/android/audio/audio-custom-capturenrendering#api_irtcengine_createcustomaudiotrack) 创建自定义音频轨道。 ::: ### 参数 [#参数-4] 音频轨道 ID,需设置为 [createCustomAudioTrack](/zh-CN/api-reference/rtc/android/audio/audio-custom-capturenrendering#api_irtcengine_createcustomaudiotrack) 返回的自定义音频轨道 ID。 是否播放外部音频源: - true:播放外部音频源。 - false:(默认)不播放外部音频源。 ### 返回值 [#返回值-4] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-4] - [RtcEngine](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_irtcengine) ## pullPlaybackAudioFrame [1/2] [#pullplaybackaudioframe-12] 拉取远端混音后的音频数据用于播放。 ```java public abstract int pullPlaybackAudioFrame(byte[] data, int lengthInByte); ``` 调用该方法前,请先调用 [setExternalAudioSink](/zh-CN/api-reference/rtc/android/audio/audio-custom-capturenrendering#api_irtcengine_setexternalaudiosink) 并设置 `enabled` 为 true,以启用外部音频渲染。 :::note 注: `pullPlaybackAudioFrame` 方法和 [onPlaybackAudioFrame](/zh-CN/api-reference/rtc/android/audio/audio-raw#callback_iaudioframeobserver_onplaybackaudioframe) 回调都可用于获取远端混音后的音频数据。启用外部音频渲染(调用 [setExternalAudioSink](/zh-CN/api-reference/rtc/android/audio/audio-custom-capturenrendering#api_irtcengine_setexternalaudiosink))后,无法再通过 [onPlaybackAudioFrame](/zh-CN/api-reference/rtc/android/audio/audio-raw#callback_iaudioframeobserver_onplaybackaudioframe) 回调获取数据。请根据实际业务需求选择使用 `pullPlaybackAudioFrame` 方法或 [onPlaybackAudioFrame](/zh-CN/api-reference/rtc/android/audio/audio-raw#callback_iaudioframeobserver_onplaybackaudioframe) 回调。两者区别如下: - 调用 `pullPlaybackAudioFrame` 方法后,App 会自动从 SDK 拉取音频数据。通过设置音频数据参数,SDK 会调整帧缓冲区以帮助 App 处理延迟,有效避免音频播放抖动。 - 注册 [onPlaybackAudioFrame](/zh-CN/api-reference/rtc/android/audio/audio-raw#callback_iaudioframeobserver_onplaybackaudioframe) 回调后,SDK 会通过回调将音频数据发送给 App。若处理音频帧存在延迟,可能会导致音频抖动。 该方法仅用于获取远端混音后的音频数据。如需获取采集、播放等其他音频处理阶段的数据,可通过调用 [registerAudioFrameObserver](/zh-CN/api-reference/rtc/android/audio/audio-raw#api_irtcengine_registeraudioframeobserver) 注册相应的回调。 ::: ### 调用时机 [#调用时机] 该方法需要在加入频道后调用。 ### 参数 [#参数-5] 输出参数,要拉取的远端音频数据。 数据长度(字节)。该值与音频时长,以及在 [setExternalAudioSink](/zh-CN/api-reference/rtc/android/audio/audio-custom-capturenrendering#api_irtcengine_setexternalaudiosink) 中设置的 `sampleRate` 和 `channels` 参数有关。计算公式为:`lengthInByte` = `sampleRate` / 1000 × 2 × `channels` × 音频时长(毫秒)。 ### 返回值 [#返回值-5] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-5] - [RtcEngine](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_irtcengine) ## pullPlaybackAudioFrame [2/2] [#pullplaybackaudioframe-22] 拉取远端音频数据。 ```java public abstract int pullPlaybackAudioFrame(ByteBuffer data, int lengthInByte); ``` 在调用该方法之前,你需要调用 [setExternalAudioSink](/zh-CN/api-reference/rtc/android/audio/audio-custom-capturenrendering#api_irtcengine_setexternalaudiosink) 方法,并将 `enabled` 设置为 true,以启用并设置外部音频播放。调用该方法成功后,App 会拉取解码并混音后的音频数据用于播放。 :::note 注: - 该方法需要在加入频道后调用。 - 该方法与 [onPlaybackAudioFrame](/zh-CN/api-reference/rtc/android/audio/audio-raw#callback_iaudioframeobserver_onplaybackaudioframe) 回调的区别如下: - [onPlaybackAudioFrame](/zh-CN/api-reference/rtc/android/audio/audio-raw#callback_iaudioframeobserver_onplaybackaudioframe):SDK 通过该回调将音频数据发送给 App。若 App 处理音频帧存在延迟,可能会导致音频抖动。 - `pullPlaybackAudioFrame`:App 主动拉取远端音频数据。设置音频参数后,SDK 会调整帧缓冲区,避免外部音频播放中因抖动引发的问题。 ::: ### 参数 [#参数-6] 用于接收拉取的远端音频数据。详见 `ByteBuffer`。 远端音频数据的字节长度。该值与音频时长,以及在 [setExternalAudioSink](/zh-CN/api-reference/rtc/android/audio/audio-custom-capturenrendering#api_irtcengine_setexternalaudiosink) 中设置的 `sampleRate` 和 `channels` 参数有关。 `lengthInByte` = `sampleRate` / 1000 × 2 × `channels` × 音频时长(毫秒)。 ### 返回值 [#返回值-6] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-6] - [RtcEngine](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_irtcengine) ## pushExternalAudioFrame [#pushexternalaudioframe] 将外部音频帧推送到 SDK。 ```java public abstract int pushExternalAudioFrame(byte[] data, long timestamp, int sampleRate, int channels, Constants.BytesPerSample bytesPerSample, int trackId); ``` 调用该方法前,请按以下顺序操作: 1. 调用 [createCustomAudioTrack](/zh-CN/api-reference/rtc/android/audio/audio-custom-capturenrendering#api_irtcengine_createcustomaudiotrack) 创建自定义音频轨道,并获取音频轨道 ID。 2. 调用 `joinChannel` 加入频道。在 [ChannelMediaOptions](/zh-CN/api-reference/rtc/android/class-channelmediaoptions) 中,将 `publishCustomAudioTrackId` 设置为要发布的音频轨道 ID,并将 `publishCustomAudioTrack` 设置为 true。 ### 调用时机 [#调用时机-1] 在调用该方法推送外部音频数据前,请先完成以下步骤: 1. 调用 [createCustomAudioTrack](/zh-CN/api-reference/rtc/android/audio/audio-custom-capturenrendering#api_irtcengine_createcustomaudiotrack) 创建自定义音频轨道并获取音频轨道 ID。 2. 调用 `joinChannel` 加入频道。在 [ChannelMediaOptions](/zh-CN/api-reference/rtc/android/class-channelmediaoptions) 中,将 `publishCustomAudioTrackId` 设置为要发布的音频轨道 ID,并将 `publishCustomAudioTrack` 设置为 true。 ### 参数 [#参数-7] 外部音频数据。 外部音频帧的时间戳(毫秒)。该参数为必填项,可用于还原采集音频帧的顺序,或在涉及视频的场景中(包括使用外部视频源的场景)实现音视频同步。 外部音频源的采样率(Hz),可设置为以下值: - `8000` - `16000` - `32000` - `44100` - `48000`。 外部音频源的声道数,可设置为以下值: - `1`:单声道。 - `2`:立体声。 每个采样点的字节数。 音频轨道 ID。请设置为 [createCustomAudioTrack](/zh-CN/api-reference/rtc/android/audio/audio-custom-capturenrendering#api_irtcengine_createcustomaudiotrack) 返回的自定义音频轨道 ID。 ### 返回值 [#返回值-7] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-7] - [RtcEngine](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_irtcengine) ## setExternalAudioSink [#setexternalaudiosink] 设置外部音频渲染器。 ```java public abstract int setExternalAudioSink(boolean enabled, int sampleRate, int channels); ``` 启用外部音频渲染器后,你可以调用 `pullPlaybackAudioFrame` 拉取远端音频帧,应用可以处理远端音频,并使用你希望的音效进行播放。 :::note 注: 启用外部音频渲染器后,应用将无法从 [onPlaybackAudioFrame](/zh-CN/api-reference/rtc/android/audio/audio-raw#callback_iaudioframeobserver_onplaybackaudioframe) 回调中获取任何音频数据。 ::: ### 适用场景 [#适用场景] 适用于需要使用外部音频数据进行播放的场景。 ### 调用时机 [#调用时机-2] 请在加入频道前调用该方法。 ### 参数 [#参数-8] 是否启用外部音频渲染器: - true:启用外部音频渲染器。 - false:(默认)关闭外部音频渲染器。 外部音频渲染器的采样率(Hz),可设置为以下值: - 16000 - 32000 - 44100 - 48000 外部音频渲染器的声道数: - 1:单声道。 - 2:立体声。 ### 返回值 [#返回值-8] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-8] - [RtcEngine](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_irtcengine) ## setExternalAudioSource [1/2] [#setexternalaudiosource-12] 设置外部音频源。 ```java public abstract int setExternalAudioSource(boolean enabled, int sampleRate, int channels); ``` :::error[废弃] 该方法已废弃,请改用 [createCustomAudioTrack](/zh-CN/api-reference/rtc/android/audio/audio-custom-capturenrendering#api_irtcengine_createcustomaudiotrack)。 ::: 在调用 `joinChannel` 和 `startPreview` 之前调用该方法。 ### 参数 [#参数-9] 是否启用外部音频源: - true:启用外部音频源。 - false:(默认)禁用外部音频源。 外部音频源的采样率(Hz),可设置为以下值: - 8000 - 16000 - 32000 - 44100 - 48000。 外部音频源的声道数: - 1:单声道。 - 2:立体声。 ### 返回值 [#返回值-9] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-9] - [RtcEngine](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_irtcengine) ## setExternalAudioSource [2/2] [#setexternalaudiosource-22] 设置外部音频源参数。 ```java public abstract int setExternalAudioSource(boolean enabled, int sampleRate, int channels, boolean localPlayback, boolean publish); ``` :::error[废弃] 该方法已废弃,请改用 [createCustomAudioTrack](/zh-CN/api-reference/rtc/android/audio/audio-custom-capturenrendering#api_irtcengine_createcustomaudiotrack)。 ::: ### 调用时机 [#调用时机-3] 在加入频道前调用该方法。 ### 参数 [#参数-10] 是否启用外部音频源: - true:启用外部音频源。 - false:(默认)不启用外部音频源。 外部音频源的采样率(Hz),可设置为以下值: - `8000` - `16000` - `32000` - `44100` - `48000`。 外部音频源的声道数,可设置为以下值: - `1`:单声道。 - `2`:立体声。 是否播放外部音频源: - true:播放外部音频源。 - false:(默认)不播放外部音频源。 是否向远端用户发布音频: - true:(默认)发布音频到远端用户。 - false:不发布音频到远端用户。 ### 返回值 [#返回值-10] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-10] - [RtcEngine](/zh-CN/api-reference/rtc/android/rtc-interface-class#class_irtcengine)