The RTCTrackEvent()
constructor
creates and returns a new RTCTrackEvent
object, configured to describe
the track which has been added to the RTCPeerConnection
.
In general, you won't need to use this constructor, as RTCTrackEvent
objects are created by WebRTC and delivered to your RTCPeerConnector
's
ontrack
event handler as appropriate.
Syntax
trackEvent = new RTCTrackEvent(eventInfo);
Parameters
eventInfo
- An object based on the
RTCTrackEventInit
dictionary, providing information about the track which has been added to theRTCPeerConnection
. This object has the following properties:
receiver
- The
RTCRtpReceiver
which is being used to receive the track's media. streams
Optional- An array of
MediaStream
objects representing each of the streams that comprise the event's corresponding track. track
- The
MediaStreamTrack
the event is associated with. transceiver
- The
RTCRtpTransceiver
associated with the event.
Return value
A new RTCTrackEvent
describing a track which has been added to the
RTCPeerConnection
.
Specifications
Specification | Status | Comment |
---|---|---|
WebRTC 1.0: Real-time Communication Between Browsers The definition of 'RTCTrackEvent()' in that specification. |
Candidate Recommendation | Initial specification. |