# Interface IRemoteTrack (/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/iremotetrack)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## Events [#events]
### first-frame-decoded [#first-frame-decoded]
first-frame-decoded(): void
首帧音频或视频解码时触发。
void
### transceiver-updated [#transceiver-updated]
transceiver-updated(transceiver: RTCRtpTransceiver): void
当前轨道的 `RTCRtpTransceiver` 实例更新回调。
新的 `RTCRtpTransceiver` 实例。
void
### video-state-changed [#video-state-changed]
video-state-changed(videoState: [VideoState](/zh-CN/api-reference/rtc/react-sdk/web-sdk/enums/videostate)): void
视频状态发生变化时触发。
[VideoState](/zh-CN/api-reference/rtc/react-sdk/web-sdk/enums/videostate)
void
## Properties [#properties]
### 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`: 媒体轨道没有在页面上播放。
### 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]
### 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(): [RemoteAudioTrackStats](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/remoteaudiotrackstats) | [RemoteVideoTrackStats](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/remotevideotrackstats)
获取远端轨道相关信息。
:::warning[deprecated]
自 v4.1.0 起废弃,请使用 [AgoraRTCClient.getRemoteVideoStats](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/iagorartcclient#getremotevideostats) 和 [AgoraRTCClient.getRemoteAudioStats](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/iagorartcclient#getremoteaudiostats)。
:::
[RemoteAudioTrackStats](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/remoteaudiotrackstats) | [RemoteVideoTrackStats](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/remotevideotrackstats)
[RemoteAudioTrackStats](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/remoteaudiotrackstats) 或 [RemoteVideoTrackStats](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/remotevideotrackstats) 对象。
### 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。
### getUserId [#getuserid]
getUserId(): [UID](/zh-CN/api-reference/rtc/react-sdk/web-sdk/globals#uid)
获取发布远端轨道的远端用户 ID。
[UID](/zh-CN/api-reference/rtc/react-sdk/web-sdk/globals#uid)
远端轨道对应的 `uid`。
### 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
Overrides EventEmitter.on
事件名称。
详见 [track-updated](/zh-CN/api-reference/rtc/react-sdk/web-sdk/globals#event_track_updated)。
void
#### on [2/3] [#on-23]
on(event: "first-frame-decoded", listener: typeof event_first_frame_decoded): void
Overrides EventEmitter.on
事件名称。
详见 [first-frame-decoded](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/iremotetrack#event_first_frame_decoded)。
void
#### on [3/3] [#on-33]
on(event: "transceiver-updated", listener: typeof event_transceiver_updated_2): void
Overrides EventEmitter.on
添加事件监听器。
事件名称。
详见 [IRemoteTrack.transceiver-updated](/zh-CN/api-reference/rtc/react-sdk/web-sdk/interfaces/iremotetrack#event_transceiver_updated_2)。
void
### once [#once]
once(event: string, listener: Function): void
Inherited from EventEmitter.once
监听一个指定的事件,当事件触发时会调用传入的回调函数。
当监听后事件第一次触发时,该监听和回调函数就会被立刻移除,也就是只监听一次指定事件。
指定事件的名称。
传入的回调函数。
void
### play [#play]
play(element?: string | HTMLElement): void
Inherited from [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)
在页面上播放媒体轨道。
指定一个 DOM 元素,SDK 将在这个元素下创建 `
void
### removeAllListeners [#removealllisteners]
removeAllListeners(event?: string): void
Inherited from EventEmitter.removeAllListeners
指定一个事件,取消其所有的监听。
指定事件的名称,如果没有指定事件,则取消所有事件的所有监听。
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