# Interface IBufferSourceAudioTrack (/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 可以通过 [AgoraRTC.createBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/iagorartc#createbuffersourceaudiotrack) 来获取。 ## Events [#events] ### source-state-change [#source-state-change] source-state-change(currentState: [AudioSourceState](/zh-CN/api-reference/rtc/react-sdk/web-sdk/globals#audiosourcestate)): void 当 [BufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack) 的音频数据源处理状态变化时,会触发此事件。 [AudioSourceState](/zh-CN/api-reference/rtc/react-sdk/web-sdk/globals#audiosourcestate) 当前音频数据处理状态: - `"stopped"`: 音频源数据处理停止。可能是因为数据处理完毕,也可能是手动触发了停止。 - `"paused"`: 音频源数据暂停处理。 - `"playing"`: 音频源数据正在处理。 void ## Properties [#properties] ### currentState [#currentstate] currentState: [AudioSourceState](/zh-CN/api-reference/rtc/react-sdk/web-sdk/globals#audiosourcestate) 当前音频数据源的处理状态(开始/暂停/停止)。 ### duration [#duration] duration: number 音频总时长,单位为秒。 ### enabled [#enabled] enabled: boolean Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[enabled](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#enabled) 本地轨道当前的启用状态。 ### isPlaying [#isplaying] isPlaying: boolean Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[isPlaying](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#isplaying) 媒体轨道是否正在页面上播放。 - `true`: 媒体轨道正在页面上播放。 - `false`: 媒体轨道没有在页面上播放。 ### muted [#muted] muted: boolean Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[muted](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#muted) 本地媒体轨道当前的静音状态。 ### playbackSpeed [#playbackspeed] playbackSpeed: number :::info[自从] *4.18.0* 当前音频文件的播放速度。取值范围为 [50,400],其中: - `50`: 0.5 倍速。 - `100`: (默认)原始速度。 - `400`: 4 倍速。 ::: ### processorDestination [#processordestination] processorDestination: IAudioProcessor Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[processorDestination](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#processordestination) :::info[自从] *4.10.0* 本地音频轨道上当前媒体处理链路的最终节点。 ::: ### source [#source] source: string|File|AudioBuffer|null 创建时指定的 [source](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/buffersourceaudiotrackinitconfig#source) 值。 ### trackMediaType [#trackmediatype] trackMediaType: "audio"|"video" Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[trackMediaType](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#trackmediatype) 媒体轨道的类型: - `"audio"`: 音频轨道。 - `"video"`: 视频轨道。 ## Methods [#methods] ### close [#close] close(): void Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[close](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#close) 关闭本地轨道,并释放相关采集设备。 一旦本地轨道被关闭,就无法再次使用。如需再次使用本地轨道,需要重新创建。 void ### getCurrentTime [#getcurrenttime] getCurrentTime(): number 获取当前的音频处理的进度,单位为秒。 number 当前音频处理的进度。 ### getListeners [#getlisteners] getListeners(event: string): Function[] Inherited from EventEmitter.getListeners 指定一个事件名,获取当前所有监听这个事件的回调函数。 事件名称。 Function[] ### getMediaStreamTrack [#getmediastreamtrack] getMediaStreamTrack(): MediaStreamTrack Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[getMediaStreamTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#getmediastreamtrack) 获取浏览器原生的 [MediaStreamTrack](https://developer.mozilla.org/en-US/docs/Web/API/MediaStreamTrack) 对象。 MediaStreamTrack 一个 [MediaStreamTrack](https://developer.mozilla.org/en-US/docs/Web/API/MediaStreamTrack) 对象。 ### getRTCRtpTransceiver [#getrtcrtptransceiver] getRTCRtpTransceiver(type?: [StreamType](/zh-CN/api-reference/rtc/react-sdk/web-sdk/enums/streamtype)): RTCRtpTransceiver | undefined Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[getRTCRtpTransceiver](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#getrtcrtptransceiver) 获取当前轨道的 [RTCRtpTransceiver](https://developer.mozilla.org/en-US/docs/Web/API/RTCRtpTransceiver) 实例。 该方法目前主要用于视频流的[端到端加密(Beta)](/zh-CN/realtime-media/rtc/build/security-and-auth/e2e-encryption)。 :::caution[注意] 如果 SDK 发生断线重连,当前轨道对应的 `RTCRtpTransceiver` 实例可能会发生变化。你可以通过以下回调来获取新的 `RTCRtpTransceiver` 实例: - 本地轨道:[ILocalTrack.transceiver-updated](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ilocaltrack#event_transceiver_updated) - 远端轨道:[IRemoteTrack.transceiver-updated](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/iremotetrack#event_transceiver_updated_2) ::: [StreamType](/zh-CN/api-reference/rtc/react-sdk/web-sdk/enums/streamtype) 视频流的类型。详见 [StreamType](/zh-CN/api-reference/rtc/react-sdk/web-sdk/enums/streamtype)。 RTCRtpTransceiver | undefined 当前轨道的 `RTCRtpTransceiver` 实例。 ### getStats [#getstats] getStats(): [LocalAudioTrackStats](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/localaudiotrackstats) Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[getStats](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#getstats) Overrides [ILocalTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ilocaltrack).[getStats](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ilocaltrack#getstats) 获取本地音频轨道的质量相关信息。 :::warning[deprecated] 自 v4.1.0 起废弃,请使用 [AgoraRTCClient.getLocalVideoStats](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/iagorartcclient#getlocalvideostats) 和 [AgoraRTCClient.getLocalAudioStats](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/iagorartcclient#getlocalaudiostats)。 ::: [LocalAudioTrackStats](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/localaudiotrackstats) ### getTrackId [#gettrackid] getTrackId(): string Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[getTrackId](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#gettrackid) 获取由 SDK 生成的对于媒体轨道来说的唯一 ID。 string 媒体轨道 ID。 ### getTrackLabel [#gettracklabel] getTrackLabel(): string Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[getTrackLabel](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#gettracklabel) 获取本地轨道的来源描述。 string 可能返回以下值: - 如果是通过 `createMicrophoneAudioTrack` 或 `createCameraVideoTrack` 创建的轨道,返回 [MediaDeviceInfo.label](https://developer.mozilla.org/en-US/docs/Web/API/MediaDeviceInfo/label) 字段。 - 如果是通过 `createScreenVideoTrack` 创建的轨道,返回屏幕共享的 `sourceId`。 - 如果是 `createCustomAudioTrack` 或 `createCustomVideoTrack` 创建的轨道,返回 [MediaStreamTrack.label](https://developer.mozilla.org/en-US/docs/Web/API/MediaStreamTrack/label) 字段。 ### getVolumeLevel [#getvolumelevel] getVolumeLevel(): number Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[getVolumeLevel](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#getvolumelevel) 获取本地音频轨道的音量等级。 number 音量等级值,范围 [0, 1],1 代表理论最大音量。通常该值大于 0.6 代表用户在持续说话。 ### off [#off] off(event: string, listener: Function): void Inherited from EventEmitter.off 取消一个指定事件的监听。 指定事件的名称。 监听事件时传入的回调函数。 void ### on [#on] #### on [1/2] [#on-12] on(event: "source-state-change", listener: typeof event_source_state_change): void Overrides [ILocalAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ilocalaudiotrack).[on](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ilocalaudiotrack#on) 事件名称。 详见 [source-state-change](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#event_source_state_change)。 void #### on [2/2] [#on-22] on(event: string, listener: Function): void Overrides [ILocalAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ilocalaudiotrack).[on](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ilocalaudiotrack#on) 当指定的事件触发时,会调用传入的回调函数。 事件名称。 回调函数。 void ### once [#once] once(event: string, listener: Function): void Inherited from EventEmitter.once 监听一个指定的事件,当事件触发时会调用传入的回调函数。 当监听后事件第一次触发时,该监听和回调函数就会被立刻移除,也就是只监听一次指定事件。 指定事件的名称。 传入的回调函数。 void ### pauseProcessAudioBuffer [#pauseprocessaudiobuffer] pauseProcessAudioBuffer(): void 暂停处理音频数据。 void ### pipe [#pipe] pipe(processor: IAudioProcessor): IAudioProcessor Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[pipe](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#pipe) :::info[自从] *4.10.0* 将 `Processor` 注入本地音频轨道。 ::: `Processor` 实例。每个插件均有对应类型的 `Processor`。 IAudioProcessor `Processor` 实例。 ### play [#play] play(): void Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[play](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#play) Overrides [ILocalTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ilocaltrack).[play](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ilocaltrack#play) 播放本地音频轨道。 :::caution[注意] 播放音频时 SDK 不会创建任何 DOM 元素,所以无需像视频一样提供 DOM 元素。 ::: void ### removeAllListeners [#removealllisteners] removeAllListeners(event?: string): void Inherited from EventEmitter.removeAllListeners 指定一个事件,取消其所有的监听。 指定事件的名称,如果没有指定事件,则取消所有事件的所有监听。 void ### resumeProcessAudioBuffer [#resumeprocessaudiobuffer] resumeProcessAudioBuffer(): void 恢复被暂停的音频数据处理。 void ### seekAudioBuffer [#seekaudiobuffer] seekAudioBuffer(time: number): void 跳转到指定时间。 指定的音频时间,单位为秒。 void ### setAudioBufferPlaybackSpeed [#setaudiobufferplaybackspeed] setAudioBufferPlaybackSpeed(speed: number): void :::info[自从] *4.18.0* 设置当前音频文件的播放速度。 在加入频道前和加入频道后,你都可以调用该方法。 ::: 播放速度。取值范围为 [50,400],其中: - `50`: 0.5 倍速。 - `100`: (默认)原始速度。 - `400`: 4 倍速。 void ### setAudioFrameCallback [#setaudioframecallback] setAudioFrameCallback(audioFrameCallback: null | function, frameSize?: number): void Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[setAudioFrameCallback](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#setaudioframecallback) 设置原始音频数据(PCM)回调。 设置成功后,SDK 会不断地将本地音频轨道的音频帧以 [AudioBuffer](https://developer.mozilla.org/en-US/docs/Web/API/AudioBuffer) 的形式通过回调返回。 :::caution[注意] 你可以通过 `frameSize` 来设置每次回调中音频帧的大小。该设置也会影响回调的间隔,`frameSize` 越大,每次回调的音频数据越多,回调间隔越长。 ::: ```javascript track.setAudioFrameCallback((buffer) => { for (let channel = 0; channel < buffer.numberOfChannels; channel += 1) { // Float32Array with PCM data const currentChannelData = buffer.getChannelData(channel); console.log("PCM data in channel", channel, currentChannelData); } }, 2048); // .... // Stop getting the raw audio data track.setAudioFrameCallback(null); ``` 用于接收 [AudioBuffer](https://developer.mozilla.org/en-US/docs/Web/API/AudioBuffer) 的回调函数。设为 `null` 后,SDK 就会停止获取音频原始数据。 每次回调的 `AudioBuffer` 中每个声道包含的采样数据个数,只能设为下列值:256, 512, 1024, 2048, 4096, 8192, 16384。默认为 4096。 void ### setEnabled [#setenabled] setEnabled(enabled: boolean): Promise<void> Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[setEnabled](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#setenabled) :::info[自从] *4.0.0* 启用/禁用该轨道。 轨道禁用后,播放和发布都将被停止。 **注意:** - 禁用轨道不会触发 [LocalTrack.on("track-ended")](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ilocaltrack#event_track_ended) 事件。 - 如果该轨道已发布,禁用轨道后,远端会触发 [user-unpublished](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/iagorartcclient#event_user_unpublished) 事件。重新启用后,远端会触发 [user-published](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/iagorartcclient#event_user_published) 事件。 - `setEnabled` 和 `setMuted` 不能同时调用。 ::: 是否启用该轨道: - `true`: 启用该轨道。 - `false`: 禁用该轨道。 Promise<void> ### setMuted [#setmuted] setMuted(muted: boolean): Promise<void> Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[setMuted](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#setmuted) 发送或暂停发送该轨道的媒体数据。 :::info[自从] *4.6.0* 如果该轨道已发布,调用 `setMuted(true)` 后,远端会触发 [user-unpublished](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/iagorartcclient#event_user_unpublished) 事件。再调用 `setMuted(false)` 后,远端会触发 [user-published](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/iagorartcclient#event_user_published) 事件。 **注意:** - 与 [setEnabled](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#setenabled) 相比,调用该方法响应速度更快且不影响视频采集状态,详见 [setEnabled 和 setMuted 有什么区别?](/zh-CN/reference/faq/integration/set_enabled_set_muted)。 - `setEnabled` 和 `setMuted` 不能同时调用。 ::: 是否发送该轨道的媒体数据: - `true`: 暂停发送该轨道的媒体数据。 - `false`: 恢复发送该轨道的媒体数据。 Promise<void> ### setPlaybackDevice [#setplaybackdevice] setPlaybackDevice(deviceId: string): Promise<void> Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[setPlaybackDevice](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#setplaybackdevice) :::info[自从] *4.1.0* **注意事项:** - 自 v4.7.0 起,该方法不再生效。请改用 [IRemoteAudioTrack.setPlaybackDevice](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/iremoteaudiotrack#setplaybackdevice)。 设置本地播放远端音频流的设备(扬声器)。 ::: 设备 ID,可以通过 [getPlaybackDevices](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/iagorartc#getplaybackdevices) 方法获取。 Promise<void> ### setVolume [#setvolume] setVolume(volume: number): void Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[setVolume](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#setvolume) 设置本地音频轨道的音量。 音量值,范围 [0, 1000], 0 代表静音,100 代表原始音量。100 以上会使用 WebAudio 进行音量增益。如果本地音频轨道已经发布,修改音量会影响远端听到的音量大小。 void ### startProcessAudioBuffer [#startprocessaudiobuffer] startProcessAudioBuffer(options?: [AudioSourceOptions](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/audiosourceoptions)): void 开始处理音频数据源。 :::caution[注意] 开始处理音频数据源说明我们已经将音频数据送入 SDK 的处理节点。如果此时该音频轨道已发布,远端可以听到该音源的声音。 只有在调用 [play](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#play) 之后,音频数据才会送入声卡,此时本地才能听到该音源的声音。 ::: [AudioSourceOptions](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/audiosourceoptions) 音频数据源处理的相关设置,包括是否需要循环播放/开始播放的位置。详见 [AudioSourceOptions](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/audiosourceoptions)。 void ### stop [#stop] stop(): void Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[stop](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#stop) 停止播放。 void ### stopProcessAudioBuffer [#stopprocessaudiobuffer] stopProcessAudioBuffer(): void 停止处理音频数据。 void ### unpipe [#unpipe] unpipe(): void Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack).[unpipe](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/ibuffersourceaudiotrack#unpipe) :::info[自从] *4.10.0* 取消本地音频轨道上注入的 `Processor`。 ::: void