# Interface IRemoteAudioTrack (/zh-CN/api-reference/rtc/web/interfaces/iremoteaudiotrack) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## Properties [#properties] ### isPlaying [#isplaying] isPlaying: boolean Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/web/interfaces/ibuffersourceaudiotrack).[isPlaying](/zh-CN/api-reference/rtc/web/interfaces/ibuffersourceaudiotrack#isplaying) 媒体轨道是否正在页面上播放。 - `true`: 媒体轨道正在页面上播放。 - `false`: 媒体轨道没有在页面上播放。 ### processorDestination [#processordestination] processorDestination: IAudioProcessor :::info[自从] *4.13.0* ::: 远端音频轨道上当前媒体处理链路的最终节点。 ### trackMediaType [#trackmediatype] trackMediaType: "audio"|"video" Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/web/interfaces/ibuffersourceaudiotrack).[trackMediaType](/zh-CN/api-reference/rtc/web/interfaces/ibuffersourceaudiotrack#trackmediatype) 媒体轨道的类型: - `"audio"`: 音频轨道。 - `"video"`: 视频轨道。 ## Methods [#methods] ### addReferenceTrack [#addreferencetrack] addReferenceTrack(track: [ILocalAudioTrack](/zh-CN/api-reference/rtc/web/interfaces/ilocalaudiotrack) | [IRemoteAudioTrack](/zh-CN/api-reference/rtc/web/interfaces/iremoteaudiotrack)): void 向当前音频扩展链路添加参考音轨。 [ILocalAudioTrack](/zh-CN/api-reference/rtc/web/interfaces/ilocalaudiotrack) | [IRemoteAudioTrack](/zh-CN/api-reference/rtc/web/interfaces/iremoteaudiotrack) 作为参考输入的本地或远端音频轨道。 void ### getListeners [#getlisteners] getListeners(event: string): Function[] Inherited from EventEmitter.getListeners 指定一个事件名,获取当前所有监听这个事件的回调函数。 事件名称。 Function[] ### getMediaStreamTrack [#getmediastreamtrack] getMediaStreamTrack(): MediaStreamTrack Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/web/interfaces/ibuffersourceaudiotrack).[getMediaStreamTrack](/zh-CN/api-reference/rtc/web/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/web/enums/streamtype)): RTCRtpTransceiver | undefined Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/web/interfaces/ibuffersourceaudiotrack).[getRTCRtpTransceiver](/zh-CN/api-reference/rtc/web/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/web/interfaces/ilocaltrack#event_transceiver_updated) - 远端轨道:[IRemoteTrack.transceiver-updated](/zh-CN/api-reference/rtc/web/interfaces/iremotetrack#event_transceiver_updated_2) ::: [StreamType](/zh-CN/api-reference/rtc/web/enums/streamtype) 视频流的类型。详见 [StreamType](/zh-CN/api-reference/rtc/web/enums/streamtype)。 RTCRtpTransceiver | undefined 当前轨道的 `RTCRtpTransceiver` 实例。 ### getStats [#getstats] getStats(): [RemoteAudioTrackStats](/zh-CN/api-reference/rtc/web/interfaces/remoteaudiotrackstats) Overrides [IRemoteTrack](/zh-CN/api-reference/rtc/web/interfaces/iremotetrack).[getStats](/zh-CN/api-reference/rtc/web/interfaces/iremotetrack#getstats) 获取远端音频轨道相关信息。 **不推荐使用** 请使用 [AgoraRTCClient.getRemoteAudioStats](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#getremoteaudiostats) 获取远端音频轨道相关信息。 [RemoteAudioTrackStats](/zh-CN/api-reference/rtc/web/interfaces/remoteaudiotrackstats) 一个 [RemoteAudioTrackStats](/zh-CN/api-reference/rtc/web/interfaces/remoteaudiotrackstats) 对象。 ### getTrackId [#gettrackid] getTrackId(): string Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/web/interfaces/ibuffersourceaudiotrack).[getTrackId](/zh-CN/api-reference/rtc/web/interfaces/ibuffersourceaudiotrack#gettrackid) 获取由 SDK 生成的对于媒体轨道来说的唯一 ID。 string 媒体轨道 ID。 ### getUserId [#getuserid] getUserId(): [UID](/zh-CN/api-reference/rtc/web/globals#uid) Inherited from [IRemoteAudioTrack](/zh-CN/api-reference/rtc/web/interfaces/iremoteaudiotrack).[getUserId](/zh-CN/api-reference/rtc/web/interfaces/iremoteaudiotrack#getuserid) 获取发布远端轨道的远端用户 ID。 [UID](/zh-CN/api-reference/rtc/web/globals#uid) 远端轨道对应的 `uid`。 ### getVolume [#getvolume] getVolume(): number number ### getVolumeLevel [#getvolumelevel] getVolumeLevel(): number 获取远端音频轨道的音量等级。 number 音量等级值,范围 [0, 1],1 代表理论最大音量。通常该值大于 0.6 代表用户在持续说话。 ### getVolumeLevels [#getvolumelevels] getVolumeLevels(channels?: number[]): number[] 获取远端音频轨道各原始声道的音量。 返回的音量基于声道选择和混音前的音频数据。未启用多声道处理时,返回仅包含 [getVolumeLevel](/zh-CN/api-reference/rtc/web/interfaces/iremoteaudiotrack#getvolumelevel) 结果的数组。 :::info[自从] *4.24.10* ::: 需要查询的声道索引,从 `0` 开始。不设置时查询所有声道。 number[] 音量数组,正常音频的音量范围为 [0, 1],`0` 表示静音。数组索引对应原始声道索引; 指定 `channels` 时,未查询的声道位置为空。尚未读取到音频数据时,可能返回空数组或空位置。 ### off [#off] off(event: string, listener: Function): void Inherited from EventEmitter.off 取消一个指定事件的监听。 指定事件的名称。 监听事件时传入的回调函数。 void ### on [#on] #### on [1/3] [#on-13] on(event: "track-updated", listener: typeof event_track_updated): void Inherited from [IRemoteAudioTrack](/zh-CN/api-reference/rtc/web/interfaces/iremoteaudiotrack).[on](/zh-CN/api-reference/rtc/web/interfaces/iremoteaudiotrack#on) Overrides EventEmitter.on 事件名称。 详见 [track-updated](/zh-CN/api-reference/rtc/web/globals#event_track_updated)。 void #### on [2/3] [#on-23] on(event: "first-frame-decoded", listener: typeof event_first_frame_decoded): void Inherited from [IRemoteAudioTrack](/zh-CN/api-reference/rtc/web/interfaces/iremoteaudiotrack).[on](/zh-CN/api-reference/rtc/web/interfaces/iremoteaudiotrack#on) Overrides EventEmitter.on 事件名称。 详见 [first-frame-decoded](/zh-CN/api-reference/rtc/web/interfaces/iremotetrack#event_first_frame_decoded)。 void #### on [3/3] [#on-33] on(event: "transceiver-updated", listener: typeof event_transceiver_updated_2): void Inherited from [IRemoteAudioTrack](/zh-CN/api-reference/rtc/web/interfaces/iremoteaudiotrack).[on](/zh-CN/api-reference/rtc/web/interfaces/iremoteaudiotrack#on) Overrides EventEmitter.on 添加事件监听器。 事件名称。 详见 [IRemoteTrack.transceiver-updated](/zh-CN/api-reference/rtc/web/interfaces/iremotetrack#event_transceiver_updated_2)。 void ### once [#once] once(event: string, listener: Function): void Inherited from EventEmitter.once 监听一个指定的事件,当事件触发时会调用传入的回调函数。 当监听后事件第一次触发时,该监听和回调函数就会被立刻移除,也就是只监听一次指定事件。 指定事件的名称。 传入的回调函数。 void ### pipe [#pipe] pipe(processor: IAudioProcessor): IAudioProcessor :::info[自从] *4.13.0* ::: 将 `Processor` 注入远端音频轨道。 `Processor` 实例。每个插件均有对应类型的 `Processor`。 IAudioProcessor `Processor` 实例。 ### play [#play] play(): void Overrides [ILocalTrack](/zh-CN/api-reference/rtc/web/interfaces/ilocaltrack).[play](/zh-CN/api-reference/rtc/web/interfaces/ilocaltrack#play) 播放远端音频轨道。 :::caution[注意] 播放音频时 SDK 不会创建任何 DOM 元素,所以无需像视频一样提供 DOM 元素。 ::: void ### removeAllListeners [#removealllisteners] removeAllListeners(event?: string): void Inherited from EventEmitter.removeAllListeners 指定一个事件,取消其所有的监听。 指定事件的名称,如果没有指定事件,则取消所有事件的所有监听。 void ### removeExtension [#removeextension] removeExtension(extension: IAudioExtension): boolean 从远端音频轨道移除音频插件。 音频插件实例。 boolean 是否成功移除。 ### removeReferenceTrack [#removereferencetrack] removeReferenceTrack(track: [ILocalAudioTrack](/zh-CN/api-reference/rtc/web/interfaces/ilocalaudiotrack) | [IRemoteAudioTrack](/zh-CN/api-reference/rtc/web/interfaces/iremoteaudiotrack)): boolean 从当前音频扩展链路移除参考音轨。 [ILocalAudioTrack](/zh-CN/api-reference/rtc/web/interfaces/ilocalaudiotrack) | [IRemoteAudioTrack](/zh-CN/api-reference/rtc/web/interfaces/iremoteaudiotrack) 要移除的参考输入轨道。 boolean 是否成功移除。 ### selectChannels [#selectchannels] selectChannels(channels: number[], mode: [AudioRenderMode](/zh-CN/api-reference/rtc/web/globals#audiorendermode)): void 选择多声道音频轨道中需要使用的声道,并设置渲染模式。 适用于启用 [ClientConfig.multiopus](/zh-CN/api-reference/rtc/web/interfaces/clientconfig#multiopus) 后创建或接收的多声道音频轨道。 未启用多声道处理时,调用本方法不改变轨道。 :::info[自从] *4.24.10* ::: 需要使用的声道索引,从 `0` 开始,且小于原始声道数。 [AudioRenderMode](/zh-CN/api-reference/rtc/web/globals#audiorendermode) 渲染模式。传入 `"surround"` 可保留原始声道布局。详见 [AudioRenderMode](/zh-CN/api-reference/rtc/web/globals#audiorendermode)。 void ### setAmplifiedVolume [#setamplifiedvolume] setAmplifiedVolume(volume: number): void void ### setAudioFrameCallback [#setaudioframecallback] setAudioFrameCallback(audioFrameCallback: null | function, frameSize?: number): void 设置原始音频数据(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 ### setPlaybackDevice [#setplaybackdevice] setPlaybackDevice(deviceId: string): Promise<void> :::info[自从] *4.1.0* ::: 设置音频播放设备,比如扬声器。 :::caution[注意] 该方法只支持桌面端的 Chrome 和 Edge 浏览器,其他浏览器调用将会抛出 `NOT_SUPPORTED` 错误。 ::: 设备 ID,可以通过 [getPlaybackDevices](/zh-CN/api-reference/rtc/web/interfaces/iagorartc#getplaybackdevices) 方法获取。 Promise<void> ### setVolume [#setvolume] setVolume(volume: number): void 设置远端音频轨道的播放音量 音量值,范围 [0, 100],0 代表静音,100 代表原始音量。 void ### stop [#stop] stop(): void Inherited from [IBufferSourceAudioTrack](/zh-CN/api-reference/rtc/web/interfaces/ibuffersourceaudiotrack).[stop](/zh-CN/api-reference/rtc/web/interfaces/ibuffersourceaudiotrack#stop) 停止播放。 void ### unpipe [#unpipe] unpipe(): void :::info[自从] *4.13.0* ::: 取消远端音频轨道上注入的 `Processor`。 void ### useExtension [#useextension] useExtension<T>(extensionCtor: AudioExtensionConstructor<T>): T 使用类构造器在当前远端音频轨道上创建或复用一个音频插件实例。 音频插件类构造器。 T