Interface IRemoteTrack

Events

first-frame-decoded

first-frame-decoded(): void

首帧音频或视频解码时触发。

注意

该事件只有在本地调用了 IRemoteTrack.play 后才会触发。

Returns
返回类型	描述
void

transceiver-updated

transceiver-updated(transceiver: RTCRtpTransceiver): void

当前轨道的 RTCRtpTransceiver 实例更新回调。

Parameters
参数名	描述
`transceiver`RTCRtpTransceiver required	新的 `RTCRtpTransceiver` 实例。

Returns
返回类型	描述
void

video-state-changed

video-state-changed(videoState: VideoState): void

视频状态发生变化时触发。

Parameters
参数名	描述
`videoState`VideoState required

Returns
返回类型	描述
void

Properties

isPlaying

isPlaying: boolean

Inherited from IBufferSourceAudioTrack.isPlaying

媒体轨道是否正在页面上播放。

true: 媒体轨道正在页面上播放。
false: 媒体轨道没有在页面上播放。

trackMediaType

trackMediaType: "audio"|"video"

Inherited from IBufferSourceAudioTrack.trackMediaType

媒体轨道的类型：

"audio": 音频轨道。
"video": 视频轨道。

Methods

getListeners

getListeners(event: string): Function[]

Inherited from EventEmitter.getListeners

指定一个事件名，获取当前所有监听这个事件的回调函数。

Parameters
参数名	描述
`event`string required	事件名称。

Returns
返回类型	描述
Function[]

getMediaStreamTrack

getMediaStreamTrack(): MediaStreamTrack

Inherited from IBufferSourceAudioTrack.getMediaStreamTrack

获取浏览器原生的 MediaStreamTrack 对象。

Returns
返回类型	描述
MediaStreamTrack	一个 MediaStreamTrack 对象。

getRTCRtpTransceiver

getRTCRtpTransceiver(type?: StreamType): RTCRtpTransceiver | undefined

Inherited from IBufferSourceAudioTrack.getRTCRtpTransceiver

获取当前轨道的 RTCRtpTransceiver 实例。

该方法目前主要用于视频流的端到端加密（Beta）。

如果 SDK 发生断线重连，当前轨道对应的 RTCRtpTransceiver 实例可能会发生变化。你可以通过以下回调来获取新的 RTCRtpTransceiver 实例：

本地轨道：ILocalTrack.transceiver-updated

远端轨道：IRemoteTrack.transceiver-updated

Parameters
参数名	描述
`type`StreamType optional	视频流的类型。详见 StreamType。

Returns
返回类型	描述
RTCRtpTransceiver \| undefined	当前轨道的 `RTCRtpTransceiver` 实例。

getStats

getStats(): RemoteAudioTrackStats | RemoteVideoTrackStats

获取远端轨道相关信息。

deprecated

自 v4.1.0 起废弃，请使用 AgoraRTCClient.getRemoteVideoStats 和 AgoraRTCClient.getRemoteAudioStats。

Returns
返回类型	描述
RemoteAudioTrackStats \| RemoteVideoTrackStats	RemoteAudioTrackStats 或 RemoteVideoTrackStats 对象。

getTrackId

getTrackId(): string

Inherited from IBufferSourceAudioTrack.getTrackId

获取由 SDK 生成的对于媒体轨道来说的唯一 ID。

Returns
返回类型	描述
string	媒体轨道 ID。

getUserId

getUserId(): UID

获取发布远端轨道的远端用户 ID。

Returns
返回类型	描述
UID	远端轨道对应的 `uid`。

off

off(event: string, listener: Function): void

Inherited from EventEmitter.off

取消一个指定事件的监听。

Parameters
参数名	描述
`event`string required	指定事件的名称。
`listener`Function required	监听事件时传入的回调函数。

Returns
返回类型	描述
void

on

on [1/3]

on(event: "track-updated", listener: typeof event_track_updated): void

Overrides EventEmitter.on

Parameters
参数名	描述
`event`"track-updated" required	事件名称。
`listener`typeof event_track_updated required	详见 track-updated。

Returns
返回类型	描述
void

on [2/3]

on(event: "first-frame-decoded", listener: typeof event_first_frame_decoded): void

Overrides EventEmitter.on

Parameters
参数名	描述
`event`"first-frame-decoded" required	事件名称。
`listener`typeof event_first_frame_decoded required	详见 first-frame-decoded。

Returns
返回类型	描述
void

on [3/3]

on(event: "transceiver-updated", listener: typeof event_transceiver_updated_2): void

Overrides EventEmitter.on

添加事件监听器。

Parameters
参数名	描述
`event`"transceiver-updated" required	事件名称。
`listener`typeof event_transceiver_updated_2 required	详见 IRemoteTrack.transceiver-updated。

Returns
返回类型	描述
void

once

once(event: string, listener: Function): void

Inherited from EventEmitter.once

监听一个指定的事件，当事件触发时会调用传入的回调函数。

当监听后事件第一次触发时，该监听和回调函数就会被立刻移除，也就是只监听一次指定事件。

Parameters
参数名	描述
`event`string required	指定事件的名称。
`listener`Function required	传入的回调函数。

Returns
返回类型	描述
void

play

play(element?: string | HTMLElement): void

Inherited from ILocalTrack.play

在页面上播放媒体轨道。

Parameters
参数名	描述
`element`string \| HTMLElement optional	指定一个 DOM 元素，SDK 将在这个元素下创建 `<video>` 元素播放视频轨道，支持 2 种类型： `string`: 指定该 DOM 元素的 ID 值。 `HTMLElement`: 直接传入一个 DOM 元素对象。

Returns
返回类型	描述
void

removeAllListeners

removeAllListeners(event?: string): void

Inherited from EventEmitter.removeAllListeners

指定一个事件，取消其所有的监听。

Parameters
参数名	描述
`event`string optional	指定事件的名称，如果没有指定事件，则取消所有事件的所有监听。

Returns
返回类型	描述
void

stop

stop(): void

Inherited from IBufferSourceAudioTrack.stop

停止播放。

Returns
返回类型	描述
void

Events

first-frame-decoded

transceiver-updated

video-state-changed

Properties

isPlaying

trackMediaType

Methods

getListeners

getMediaStreamTrack

getRTCRtpTransceiver

getStats

deprecated

getTrackId

getUserId

off

on

on [1/3]

on [2/3]

on [3/3]

once

play

removeAllListeners

stop

咨询电话

咨询电话

EventsCopy Anchor Link

first-frame-decodedCopy Anchor Link

transceiver-updatedCopy Anchor Link

video-state-changedCopy Anchor Link

PropertiesCopy Anchor Link

isPlayingCopy Anchor Link

trackMediaTypeCopy Anchor Link

MethodsCopy Anchor Link

getListenersCopy Anchor Link

getMediaStreamTrackCopy Anchor Link

getRTCRtpTransceiverCopy Anchor Link

getStatsCopy Anchor Link

deprecatedCopy Anchor Link

getTrackIdCopy Anchor Link

getUserIdCopy Anchor Link

offCopy Anchor Link

onCopy Anchor Link

on [1/3]Copy Anchor Link

on [2/3]Copy Anchor Link

on [3/3]Copy Anchor Link

onceCopy Anchor Link

playCopy Anchor Link

removeAllListenersCopy Anchor Link

stopCopy Anchor Link

咨询电话

咨询电话

Events

first-frame-decoded

transceiver-updated

video-state-changed

Properties

isPlaying

trackMediaType

Methods

getListeners

getMediaStreamTrack

getRTCRtpTransceiver

getStats

deprecated

getTrackId

getUserId

off

on

on [1/3]

on [2/3]

on [3/3]

once

play

removeAllListeners

stop