Package com.brightcove.player.util

Class VideoFormatSelectorUtil

java.lang.Object
com.brightcove.player.util.VideoFormatSelectorUtil
public final class VideoFormatSelectorUtil extends Object
Selects from possible video formats. The class is a derivative of VideoFormatSelectorUtil Google ExoPlayer 1 SDK.

  • Method Summary

    Modifier and Type
    Method
    Description
    static int[]
    selectVideoFormats(List<? extends com.google.android.exoplayer2.source.dash.manifest.Representation> formatWrappers, String[] allowedContainerMimeTypes, boolean filterHdFormats, boolean orientationMayChange, int viewportWidth, int viewportHeight)
    Chooses a suitable subset from a number of video formats.
    static int[]
    selectVideoFormatsForDefaultDisplay(android.content.Context context, List<? extends com.google.android.exoplayer2.source.dash.manifest.Representation> formatWrappers, String[] allowedContainerMimeTypes, boolean filterHdFormats)
    Chooses a suitable subset from a number of video formats, to be rendered on the device's default display.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Method Details

    • selectVideoFormatsForDefaultDisplay

      public static int[] selectVideoFormatsForDefaultDisplay(android.content.Context context, List<? extends com.google.android.exoplayer2.source.dash.manifest.Representation> formatWrappers, String[] allowedContainerMimeTypes, boolean filterHdFormats) throws com.google.android.exoplayer2.mediacodec.MediaCodecUtil.DecoderQueryException
      Chooses a suitable subset from a number of video formats, to be rendered on the device's default display.
      Parameters:
      context - A context.
      formatWrappers - Wrapped formats from which to select.
      allowedContainerMimeTypes - An array of allowed container mime types. Null allows all mime types.
      filterHdFormats - True to filter HD formats. False otherwise.
      Returns:
      An array holding the indices of the selected formats.
      Throws:
      com.google.android.exoplayer2.mediacodec.MediaCodecUtil.DecoderQueryException - Thrown if there was an error querying decoders.

    • selectVideoFormats

      public static int[] selectVideoFormats(List<? extends com.google.android.exoplayer2.source.dash.manifest.Representation> formatWrappers, String[] allowedContainerMimeTypes, boolean filterHdFormats, boolean orientationMayChange, int viewportWidth, int viewportHeight) throws com.google.android.exoplayer2.mediacodec.MediaCodecUtil.DecoderQueryException
      Chooses a suitable subset from a number of video formats.

      A format is filtered (i.e. not selected) if:

      • allowedContainerMimeTypes is non-null and the format does not have one of the permitted mime types.
      • filterHdFormats is true and the format is HD.
      • It's determined that the video decoder isn't powerful enough to decode the format.
      • There exists another format of lower resolution whose resolution exceeds the maximum size in pixels that the video can be rendered within the viewport.
      Parameters:
      formatWrappers - Wrapped formats from which to select.
      allowedContainerMimeTypes - An array of allowed container mime types. Null allows all mime types.
      filterHdFormats - True to filter HD formats. False otherwise.
      orientationMayChange - True if the video's orientation may change with respect to the viewport during playback.
      viewportWidth - The width in pixels of the viewport within which the video will be displayed. If the viewport size may change, this should be set to the maximum possible width.
      viewportHeight - The height in pixels of the viewport within which the video will be displayed. If the viewport size may change, this should be set to the maximum possible height.
      Returns:
      An array holding the indices of the selected formats.
      Throws:
      com.google.android.exoplayer2.mediacodec.MediaCodecUtil.DecoderQueryException