com.brightcove.player.controller

Class DefaultSourceSelectionController

java.lang.Object

com.brightcove.player.event.AbstractComponent

com.brightcove.player.controller.DefaultSourceSelectionController

All Implemented Interfaces:

SourceSelector, Component

Direct Known Subclasses:

ExoPlayerSourceSelectionController, OnceUxSourceSelectionController

@ListensFor(events="selectSource")
 @Emits(events="sourceNotFound")
public class DefaultSourceSelectionController
extends AbstractComponent
implements Component, SourceSelector

Provides a default SourceSelector controller implementation that will automatically select a Source rendition based on the following rules:

• If an HLS source rendition exists use it (there should be only one, if any)
• If no HLS renditions exists, but MP4 renditions exist, use the rendition that is closest to 256 kBps
• If no HLS or MP4 renditions exist, throw a NoSourceFoundException

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	TAG

Fields inherited from class com.brightcove.player.event.AbstractComponent

eventEmitter, listenerTokens

Constructor Summary

Constructors

Constructor and Description
DefaultSourceSelectionController(EventEmitter eventEmitter) Initializes this controller with the given EventEmitter.

Method Summary

Modifier and Type	Method and Description
Source	findBestSourceByBitRate(SourceCollection sourceCollection, java.lang.Integer bitRate) Given a SourceCollection, finds the Source with the closest bit rate to the given value.
protected void	initializeListeners()
Source	selectSource(Video video) Determines best appropriate Source within given Video object based on logic implemented.

Methods inherited from class com.brightcove.player.event.AbstractComponent

addListener, addOnceListener, getEventEmitter, removeListener, removeListeners

Methods inherited from class java.lang.Object

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

Field Detail

TAG

public static final java.lang.String TAG

Constructor Detail

DefaultSourceSelectionController

public DefaultSourceSelectionController(EventEmitter eventEmitter)

Initializes this controller with the given EventEmitter.

Parameters:

eventEmitter - the EventEmitter through which this controller will interact

Method Detail

selectSource

public Source selectSource(Video video)
                    throws NoSourceFoundException

Description copied from interface: SourceSelector

Determines best appropriate Source within given Video object based on logic implemented.

Specified by:

selectSource in interface SourceSelector

Parameters:

video - Video in which to find the most appropriate Source

Returns:

the best matched Source based on the currently implemented selection logic

Throws:

NoSourceFoundException

See Also:

SourceSelector.selectSource(com.brightcove.player.model.Video)

findBestSourceByBitRate

public Source findBestSourceByBitRate(SourceCollection sourceCollection,
                                      java.lang.Integer bitRate)
                               throws NoSourceFoundException

Given a SourceCollection, finds the Source with the closest bit rate to the given value.

Parameters:

sourceCollection - the collection of Sources in which the match should be found

bitRate - the target bit rate desired for the chosen Source

Returns:

the Source that most closely matches the given bit rate, or any Source, if no match can be found

Throws:

NoSourceFoundException

initializeListeners

protected void initializeListeners()