Migration from v3: RxPlayer methods

Several RxPlayer methods have been removed, renamed or updated.

They are all listed here.

Removed methods

getAvailableAudioBitrates / getAvailableVideoBitrates

Both the getAvailableAudioBitrates and getAvailableVideoBitrates methods have been removed, like most bitrate-oriented API.

Its behavior is however easy to replace, just by using respectively the getAudioTrack and getVideoTrack methods:

// instead of getAvailableVideoBitrates you can do
const videoTrack = rxPlayer.getVideoTrack();
if (videoTrack !== null && videoTrack !== undefined) {
  const availableVideoBitrates = video.representation
    .map(r => r.bitrate)
    .filter(bitrate => bitrate !== undefined);
}

Note however that one of the main reason for calling one of those method was to change the currently playing bitrate and that such way of controlling the quality has been removed in profit of the new representation lock API. You can read the Bitrate Selection part of the migration guide for more information on this.

getVideoBitrate / getAudioBitrate

Both the getAudioBitrate and getVideoBitrate methods have been removed, like most bitrate-oriented API.

Its behavior is however easy to replace, just by using respectively the getAudioRepresentation and and getVideoRepresentation methods:

// instead of getVideoBitrate you can do
const videoRepresentation = rxPlayer.getVideoRepresentation();
if (videoRepresentation !== null && videoRepresentation !== undefined) {
  console.log("Current video bitrate:", videoRepresentation.bitrate);
}

setAudioBitrate / setVideoBitrate / getManualAudioBitrate / getManualAudioBitrate

The setAudioBitrate, setVideoBitrate, getManualAudioBitrate and getManualAudioBitrate methods have all been removed, as documented in the Bitrate Selection part of the migration guide.

setMinAudioBitrate / setMinVideoBitrate / getMinAudioBitrate / setMinAudioBitrate

The setMinAudioBitrate, setMinVideoBitrate, getMinAudioBitrate and setMinAudioBitrate methods have all been removed, as documented in the Bitrate Selection part of the migration guide.

setMaxAudioBitrate / setMaxVideoBitrate / getMaxAudioBitrate / setMaxAudioBitrate

The setMaxAudioBitrate, setMaxVideoBitrate, getMaxAudioBitrate and setMaxAudioBitrate methods have all been removed, as documented in the Bitrate Selection part of the migration guide.

getPreferredAudioTracks / getPreferredVideoTracks / getPreferredTextTracks

The getPreferredAudioTracks, getPreferredVideoTracks and getPreferredTextTracks methods have been removed.

Track preferences API does not exist anymore as documented in the Preferences part of the migration guide.

setPreferredAudioTracks / setPreferredVideoTracks / setPreferredTextTracks

The setPreferredAudioTracks, setPreferredVideoTracks and setPreferredTextTracks methods have been removed.

Track preferences API does not exist anymore as documented in the Preferences part of the migration guide.

getVideoPlayedTime

The getVideoPlayedTime method has been removed because it was poorly named, poorly understood, and it is easy to replace.

To replace it, you can write:

function getVideoPlayedTime() {
  const position = rxPlayer.getPosition();
  const mediaElement = rxPlayer.getVideoElement();
  if (mediaElement === null) {
    console.error("The RxPlayer is disposed");
  } else {
    const range = getRange(mediaElement.buffered, currentTime);
    return range !== null ? currentTime - range.start :
  }
}

/**
 * Get range object of a specific time in a TimeRanges object.
 * @param {TimeRanges} timeRanges
 * @returns {Object}
 */
function getRange(timeRanges, time) {
  for (let i = timeRanges.length - 1; i >= 0; i--) {
    const start = timeRanges.start(i);
    if (time >= start) {
      const end = timeRanges.end(i);
      if (time < end) {
        return { start, end };
      }
    }
  }
  return null;
}

getVideoLoadedTime

The getVideoLoadedTime method has been removed because it was poorly named, poorly understood, and it is easy to replace.

To replace it, you can write:

function getVideoLoadedTime() {
  const position = rxPlayer.getPosition();
  const mediaElement = rxPlayer.getVideoElement();
  if (mediaElement === null) {
    console.error("The RxPlayer is disposed");
  } else {
    const range = getRange(mediaElement.buffered, currentTime);
    return range !== null ? range.end - range.start :
                            0;
  }
}

/**
 * Get range object of a specific time in a TimeRanges object.
 * @param {TimeRanges} timeRanges
 * @returns {Object}
 */
function getRange(timeRanges, time) {
  for (let i = timeRanges.length - 1; i >= 0; i--) {
    const start = timeRanges.start(i);
    if (time >= start) {
      const end = timeRanges.end(i);
      if (time < end) {
        return { start, end };
      }
    }
  }
  return null;
}

getManifest

The getManifest method has been removed with no replacement because it exposed the RxPlayer's internals too much.

If you needed it for something, please open an issue explaining which property you needed.

getCurrentAdaptations

The getCurrentAdaptations method has been removed with no replacement because it exposed the RxPlayer's internals too much.

If you needed it for something, please open an issue explaining which property you needed.

getCurrentRepresentations

The getCurrentRepresentations method has been removed with no replacement because it exposed the RxPlayer's internals too much.

If you needed it for something, please open an issue explaining which property you needed.

isFullscreen / setFullscreen / exitFullscreen

The isFullscreen, setFullscreen and exitFullscreen methods have been removed.

Fullscreen functionalities now have to be completely handled by the applications, which most likely already did just that anyway.

getNativeTextTrack

The getNativeTextTrack methods has been removed.

This method was initially added for legacy reasons and should not be relied on anymore.

getImageTrackData

All image-related API, like the getImageTrackData method, have been removed.

If you need to parse BIF file, you can use the parseBifThumbnails tool instead.

Renamed

getUrl

The getUrl has both be updated and renamed, into the getContentUrls method.

However getContentUrls returns an optional array of URL (all URLs at which the content can be reached) whereas getUrl only provided a single one.

If you want to replicate getUrl's behavior, you may want to only use the first string optionally returned by getContentUrls.

getVideoDuration

The getVideoDuration method has been renamed getMediaDuration to prevent confusion with the duration of the video track.

getVideoBufferGap

The getVideoDuration method has been renamed getCurrentBufferGap to prevent confusion with the buffer gap specific to the video buffer.

Updated

getPlayerState

Two player states have been updated:

  • The "FREEZING" state has been added to the possible states sent through the playerStateChange event.

    This new state, which is sent when playback does not advance despite the fact that the right conditions for it are there, is described in the overview.

    In many case, you might want to handle it like a "BUFFERING" state.

  • The RELOADING player state can now happen at any time if it allows to unlock playback.

    Previously, it could only be sent if specific options have been used.

getAvailableVideoTracks / getVideoTrack

Several properties that can be received in a getAvailableVideoTracks or getVideoTrack call, to describe a video Representation (in the representations property of tracks returned by both methods), have been updated:

  • A Representation's frameRate property is now either a number - in terms of frame per seconds - or undefined, instead of a string.

  • A Representation's bitrate property can now be undefined if unknown.

getAvailableAudioTracks / getAudioTrack

The bitrate property that can be retrieved as a child property of the representations property, itself found in tracks returned by the getAvailableAudioTracks and getAudioTrack methods, can now be undefined if unknown.

mute / unMute / getVolume

Previously, those two methods updated the volume property of an HTMLMediaElement by setting it to 0 and restoring its previous value.

Now, it updates the muted property of that same HTMLMediaElement without actually updating the volume, meaning that:

  • The volume returned by getVolume won't be affected anymore when muted (it would previously be set to 0 in that case).

  • Likewise the volume property of the HTMLMediaElement won't be affected

Note that consequently the volumeChange also has been updated to indicates both an audio volume change (through a volume property) and/or a muting/un-muting of the volume (through a muted property).

setVolume / getVolume / mute / unMute / isMute

In the v3, mute, unMute and isMute were actually respectively setting the media element's volume property to 0 (mute), resetting it to its previous value (unMute) and telling if the current volume is set to 0 (isMute).

Now, mute actually set the media element's muted property to true, the unMute method set it to false, and the isMute return its current value. We're now doing this this way because it better reflect the HTML5 way of doing things and thus might be more compatible with some browser-provided features.

This means that you may have to update your code to handle the fact that now setVolume and muting methods don't interact, like they did before:

  1. If you before expected a setVolume call to automatically un-mute the media, you now also may have to call unMute to do so.

  2. If you expected isMute to return true when the current volume is set to 0 (e.g. to show an icon telling that there's no volume), you now will also have to check through getVolume if the volume is currently set to 0.

  3. Likewise getVolume will not return 0 when muted, but the last volume set through setVolume instead. Beware of this when showing UI volume indicators to not let users believe that there are sound when muted.

Migration from v3: RxPlayer methods

Page List