# io.agora.rtc.AgoraLocalAudioTrack类 参考 (/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-audio-track)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

<a id="doc-constructors"></a>

<a id="header-doc-constructors"></a>

## 构造及析构函数说明 [#构造及析构函数说明]

<a id="a5fa547ba6297820eb9b002c8856724e1"></a>

### AgoraLocalAudioTrack() [#agoralocalaudiotrack]

<ApiSignature>

io.agora.rtc.AgoraLocalAudioTrack.AgoraLocalAudioTrack(long *cptr*)

</ApiSignature>

构造函数。

<a id="doc-func-members"></a>

<a id="header-doc-func-members"></a>

## 成员函数说明 [#成员函数说明]

<a id="ae861b5a19271bf80fedf6c70bd68aa56"></a>

### adjustPublishVolume() [#adjustpublishvolume]

<ApiSignature>

native int io.agora.rtc.AgoraLocalAudioTrack.adjustPublishVolume(int *volume*)

</ApiSignature>

调整音频在远端播放的音量。

<ParameterList title="参数">
<Parameter name="volume">

音频的远端播放音量。取值范围为 [1,100]，其中默认值为 100，表示原始音量。

</Parameter>
</ParameterList>

<h4 data-toc-hidden="true" id={"返回值"}>返回值</h4>

- 0: 方法调用成功。
- &lt; 0: 方法调用失败。

<a id="a90054e0f30419b0ee2eea512db67f535"></a>

### clearSenderBuffer() [#clearsenderbuffer]

<ApiSignature>

native int io.agora.rtc.AgoraLocalAudioTrack.clearSenderBuffer()

</ApiSignature>

清除当前音频发送缓冲区。

:::info[自从]
4.4.30
:::

如果你不再需要当前音频发送缓冲区中的数据，可以调用该方法清除缓冲区。例如，用户给 AI 提了个问题，AI 正在通过 SDK 传输音频给用户解答，此时 SDK 的音频发送缓冲区中不断有数据进出。当用户打断 AI 的回复并提出另一个问题时，你可以调用该方法，让 SDK 清除当前未发送出去的缓冲数据，以便快速缓冲 AI 对新话题的回答。

<h4 data-toc-hidden="true" id={"返回值-1"}>返回值</h4>

- ≥ 0: 方法调用成功，返回被清除的音频帧数量。
- &lt; 0: 方法调用失败。

<a id="af9838e41efd92fdb4b2fa73a6707c720"></a>

### destroy() [#destroy]

<ApiSignature>

void io.agora.rtc.AgoraLocalAudioTrack.destroy()

</ApiSignature>

析构函数。

<a id="a89fdd0058a0cda13d791cd8059cbd5a5"></a>

### destroyStats() [#destroystats]

<ApiSignature>

native void io.agora.rtc.AgoraLocalAudioTrack.destroyStats([LocalAudioTrackStats](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-local-audio-track-stats) *stats*)

</ApiSignature>

<a id="ad634490661633d72c8152b98d06625c7"></a>

### getPublishVolume() [#getpublishvolume]

<ApiSignature>

native int io.agora.rtc.AgoraLocalAudioTrack.getPublishVolume(Out *volume*)

</ApiSignature>

获取当前音频在远端播放的音量。

<ParameterList title="参数">
<Parameter name="volume">

音频在远端的播放音量。

</Parameter>
</ParameterList>

<h4 data-toc-hidden="true" id={"返回值-2"}>返回值</h4>

- ≥ 0: 方法调用成功，并返回当前音频在远端播放的音量。
- &lt; 0: 方法调用失败。

<a id="af1f3a53b0f9a084232aa213f144f836d"></a>

### getState() [#getstate]

<ApiSignature>

native int io.agora.rtc.AgoraLocalAudioTrack.getState()

</ApiSignature>

查询本地音频状态。

<h4 data-toc-hidden="true" id={"返回值-3"}>返回值</h4>

本地音频状态。

<a id="a4a625fa92fac4f5219344c7d5d5d900f"></a>

### getStats() [#getstats]

<ApiSignature>

native [LocalAudioTrackStats](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-local-audio-track-stats) io.agora.rtc.AgoraLocalAudioTrack.getStats()

</ApiSignature>

获取本地音频质量数据。

<h4 data-toc-hidden="true" id={"返回值-4"}>返回值</h4>

本地音频质量数据。

<a id="aea84507e372a22f0827827af36d94a0a"></a>

### isEnabled() [#isenabled]

<ApiSignature>

native int io.agora.rtc.AgoraLocalAudioTrack.isEnabled()

</ApiSignature>

查询本地音频轨道是否已启用。

<h4 data-toc-hidden="true" id={"返回值-5"}>返回值</h4>

本地音频轨道是否已启用：

- true: 是
- false: 否

<a id="abc3c49e80e3a02771cd7cbd3c9041e27"></a>

### setEnabled() [#setenabled]

<ApiSignature>

native void io.agora.rtc.AgoraLocalAudioTrack.setEnabled(int *enable*)

</ApiSignature>

启用或禁用本地音频轨道。

启用本地音频轨道后，SDK 会允许本地音频采集、处理和编码。

<ParameterList title="参数">
<Parameter name="enable">

是否启用本地音频轨道：

- true: 是
- false: 否

</Parameter>
</ParameterList>

<a id="a3e4526e6402becdd5f25573513ce6a36"></a>

### setMaxBufferedAudioFrameNumber() [#setmaxbufferedaudioframenumber]

<ApiSignature>

native void io.agora.rtc.AgoraLocalAudioTrack.setMaxBufferedAudioFrameNumber(int *number*)

</ApiSignature>

设置音频发送缓冲区的最大容量。

:::info[自从]
4.4.30
:::

在 AI 交互等应用场景中，发送端发送音频帧的频率可能不均匀，例如有时每 20 ms 发送 1 帧数据、有时每 20 ms 发送 3 帧数据。如果 SDK 按照实际的发送频率去发送给声网服务器，则接收端可能会有卡顿、丢帧等不良体验。为优化音频传输性能，SDK 设置了音频发送缓冲区，不论发送端实际发送音频帧的频率是多少，SDK 都会将数据存放在音频发送缓冲区。待音频发送缓冲区中的数据达到允许发送的最小时长后，SDK 再开始按照 10 ms 每帧的频率发送数据给接收端。

SDK 默认的音频发送缓冲区最大容量是 6000，表示支持存放最多 6000 帧数据，即 60 s 的数据。如果你需要更大的缓冲区容量，你可以调用该方法进行调整。如果你还需要设置音频发送缓冲区允许发送的最小数据时长，调用 [setSendDelayMs](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-audio-track#ac16dee95915656c401981f1107183370) 方法。

:::info[注解]
该方法需要在 [publishAudio](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user#a30711bbe175b24277d4cd977cb544d4e) 方法之前调用。
:::

<ParameterList title="参数">
<Parameter name="number">

缓冲区存放的最大音频帧数。例如，填入 6000 则表示 6000 帧音频数据。

</Parameter>
</ParameterList>

<a id="ac16dee95915656c401981f1107183370"></a>

### setSendDelayMs() [#setsenddelayms]

<ApiSignature>

native void io.agora.rtc.AgoraLocalAudioTrack.setSendDelayMs(int *delayMs*)

</ApiSignature>

设置音频发送缓冲区允许发送的最小数据时长。

:::info[自从]
4.4.30
:::

SDK 默认允许发送的最小数据时长为 160 ms，即 SDK 会等音频发送缓冲区存满 160 ms 的数据后将数据发送给接收端，这会带来如下影响：

- 如果发送端一次发送的数据大于或等于 160 ms，例如 800 ms，则 SDK 会立即按照每帧 10 ms 的频率发送数据给接收端。
- 如果发送端一次发送的数据小于 160 ms，例如 100 ms，则 SDK 会等缓冲区数据达到 160 ms 后，再按照 10 ms 每帧的频率发送数据给接收端。这就会造成至多 60 ms 的延迟。

你可以根据实际业务需求，调用该方法调整缓冲区允许发送的最小数据时长。

<ParameterList title="参数">
<Parameter name="delayMs">

缓冲区允许发送的最小数据时长（ms）。该参数需要设置为 10 的倍数，取值范围为大于 0 且小于 [setMaxBufferedAudioFrameNumber](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-audio-track#a3e4526e6402becdd5f25573513ce6a36) 方法中 number 参数值的 10 倍。

</Parameter>
</ParameterList>

---

该类的文档由以下文件生成:

- AgoraLocalAudioTrack.java