Skip to main content

​
JitsiTrackEvents

Events related to individual media tracks (audio and video) including local and remote tracks.

​
LOCAL_TRACK_STOPPED

Event: track.stopped Fires when the media track has been stopped and removed from the conference. 
localTrack.addEventListener(
  JitsiMeetJS.events.track.LOCAL_TRACK_STOPPED,
  () => {
    console.log('Track stopped');
  }
);

​
TRACK_MUTE_CHANGED

Event: track.trackMuteChanged Fires when the mute status of a media track has changed. 
track.addEventListener(
  JitsiMeetJS.events.track.TRACK_MUTE_CHANGED,
  () => {
    console.log('Track muted:', track.isMuted());
  }
);

​
TRACK_AUDIO_LEVEL_CHANGED

Event: track.audioLevelsChanged Fires when the audio level of this track has changed.
​
audioLevel
number
The audio level value in range [0, 1]
​
tpc
TraceablePeerConnection | undefined
The peer connection which measured the audio level. This is optional for local tracks (will be undefined). One audio track can be added to multiple peer connections simultaneously.
The second argument (TraceablePeerConnection) should be treated as library internal and may be removed at any time.
track.addEventListener(
  JitsiMeetJS.events.track.TRACK_AUDIO_LEVEL_CHANGED,
  (audioLevel) => {
    console.log('Audio level:', audioLevel);
  }
);

​
TRACK_AUDIO_OUTPUT_CHANGED

Event: track.audioOutputChanged Fires when the audio output device of the track has changed. 
track.addEventListener(
  JitsiMeetJS.events.track.TRACK_AUDIO_OUTPUT_CHANGED,
  (deviceId) => {
    console.log('Audio output changed to:', deviceId);
  }
);

​
TRACK_VIDEOTYPE_CHANGED

Event: track.videoTypeChanged Fires when the video type of the track has changed.
​
videoType
'camera' | 'desktop'
The new video type - either “camera” for regular video or “desktop” for screen sharing
track.addEventListener(
  JitsiMeetJS.events.track.TRACK_VIDEOTYPE_CHANGED,
  (videoType) => {
    console.log('Video type changed to:', videoType);
  }
);

​
TRACK_STREAMING_STATUS_CHANGED

Event: track.streaming_status_changed Fires whenever a video track’s streaming status changes. This is particularly useful for remote tracks to understand connection quality and availability.
​
sourceName
string
The source name of the track
​
status
'active' | 'inactive' | 'interrupted' | 'restoring'
The current streaming status:
  • active - The connection is active
  • inactive - The connection is inactive, intentionally interrupted by the bridge due to low bandwidth or the endpoint falling out of Last N
  • interrupted - A network problem occurred
  • restoring - The connection was inactive and is now restoring
remoteTrack.addEventListener(
  JitsiMeetJS.events.track.TRACK_STREAMING_STATUS_CHANGED,
  (sourceName, status) => {
    console.log(`Track ${sourceName} status:`, status);
    if (status === 'interrupted') {
      // Show loading indicator
    } else if (status === 'active') {
      // Hide loading indicator
    }
  }
);
You can obtain the current streaming status by calling JitsiRemoteTrack.getTrackStreamingStatus().

​
NO_AUDIO_INPUT

Event: track.no_audio_input Fires when the local audio track is not receiving any audio input from the currently selected microphone. 
localAudioTrack.addEventListener(
  JitsiMeetJS.events.track.NO_AUDIO_INPUT,
  () => {
    console.warn('No audio input detected from microphone');
    // Prompt user to check their microphone
  }
);

​
NO_DATA_FROM_SOURCE

Event: track.no_data_from_source Fires when the track is not receiving any data even though it is expected to receive data (i.e., the stream is not stopped). 
track.addEventListener(
  JitsiMeetJS.events.track.NO_DATA_FROM_SOURCE,
  () => {
    console.warn('Track not receiving data from source');
  }
);

​
TRACK_OWNER_SET

Event: track.owner_set Fires when a new owner has been assigned to a remote track. This event is only relevant when SSRC rewriting is enabled.
​
participant
JitsiParticipant
The participant who now owns the track
remoteTrack.addEventListener(
  JitsiMeetJS.events.track.TRACK_OWNER_SET,
  (participant) => {
    console.log('Track owner set to:', participant.getId());
  }
);

Build docs developers (and LLMs) love

Get started for freeTalk to us