com.bramosystems.oss.player.core.client.ui
Class DivXPlayer

java.lang.Object
  com.google.gwt.user.client.ui.UIObject
      com.google.gwt.user.client.ui.Widget
          com.google.gwt.user.client.ui.Composite
              com.bramosystems.oss.player.core.client.AbstractMediaPlayer
                  com.bramosystems.oss.player.core.client.ui.DivXPlayer

All Implemented Interfaces:

PlaylistSupport, HasMediaMessageHandlers, HasMediaProgressHandlers, HasMediaStateHandlers, HasPlayStateHandlers, com.google.gwt.event.dom.client.HasKeyDownHandlers, com.google.gwt.event.dom.client.HasKeyPressHandlers, com.google.gwt.event.dom.client.HasKeyUpHandlers, com.google.gwt.event.dom.client.HasMouseDownHandlers, com.google.gwt.event.dom.client.HasMouseMoveHandlers, com.google.gwt.event.dom.client.HasMouseUpHandlers, com.google.gwt.event.logical.shared.HasAttachHandlers, com.google.gwt.event.shared.HasHandlers, com.google.gwt.user.client.EventListener, com.google.gwt.user.client.ui.IsWidget

public class DivXPlayer
extends AbstractMediaPlayer
implements PlaylistSupport

Widget to embed DivX® Web Player plugin.

Usage Example

 SimplePanel panel = new SimplePanel();   // create panel to hold the player
 Widget player = null;
 try {
      // create the player
      player = new DivXPlayer("www.example.com/mediafile.divx");
 } catch(LoadException e) {
      // catch loading exception and alert user
      Window.alert("An error occured while loading");
 } catch(PluginVersionException e) {
      // catch plugin version exception and alert user to download plugin first.
      // An option is to use the utility method in PlayerUtil class.
      player = PlayerUtil.getMissingPluginNotice(Plugin.DivXPlayer, "Missing Plugin",
              ".. some nice message telling the user to click and download plugin first ..",
              false);
 } catch(PluginNotFoundException e) {
      // catch PluginNotFoundException and tell user to download plugin, possibly providing
      // a link to the plugin download page.
      player = new HTML(".. another kind of message telling the user to download plugin..");
 }

 panel.setWidget(player); // add player to panel.
 

Since:

1.2

Author:

Sikiru Braheem

Nested Class Summary

static class	DivXPlayer.BufferingMode An enum of buffering modes for DivXPlayer widget.
static class	DivXPlayer.DisplayMode An enum of display modes for DivXPlayer widget.

Nested classes/interfaces inherited from class com.google.gwt.user.client.ui.UIObject

com.google.gwt.user.client.ui.UIObject.DebugIdImpl, com.google.gwt.user.client.ui.UIObject.DebugIdImplEnabled

Field Summary

Fields inherited from class com.google.gwt.user.client.ui.UIObject

DEBUG_ID_PREFIX

Constructor Summary

DivXPlayer(String mediaURL)
Constructs DivXPlayer to automatically playback media located at mediaURL using the default height of 90px and width of 100%.

DivXPlayer(String mediaURL, boolean autoplay)
Constructs DivXPlayer to playback media located at mediaURL using the default height of 90px and width of 100%.

DivXPlayer(String mediaURL, boolean autoplay, String height, String width)
Constructs DivXPlayer to playback media located at mediaURL using the default height of 90px and width of 100%.

Method Summary

void	addToPlaylist(List<MRL> mediaLocators) Adds the media locators to the players' playlist.
void	addToPlaylist(MRL mediaLocator) Adds the media locator to the players' playlist.
void	addToPlaylist(String... mediaURLs) Adds the media at the specified URLs to the players' playlist.
void	addToPlaylist(String mediaURL) Adds the media at the specified URL to the players' playlist.
void	clearPlaylist() Removes all entries in the players' playlist
DivXPlayer.DisplayMode	getDisplayMode() Returns the skin mode of the player which is used to display playback controls.
int	getLoopCount() Returns the number of times this player repeats playback before stopping.
long	getMediaDuration() Returns the duration of the loaded media in milliseconds.
int	getPlaylistSize() Returns the number of entries in the playlist
double	getPlayPosition() Gets the current position in the media that is being played.
RepeatMode	getRepeatMode() Returns the current playback repeat mode
int	getVideoHeight() Returns the height of the current media
int	getVideoWidth() Returns the width of the current media
double	getVolume() Gets the volume ranging from 0 (silent) to 1 (full volume).
boolean	isControllerVisible() Checks whether the player controls are visible.
boolean	isResizeToVideoSize() Checks if player is set to adjust its size to match the dimensions of a video.
boolean	isShuffleEnabled() Checks if this player is in shuffle mode.
void	loadMedia(String mediaURL) Loads the media at the specified URL into the player.
protected void	onLoad() Overridden to register player for plugin DOM events
protected void	onUnload() Overridden to release resources
void	pauseMedia() Pause the media playback
void	play(int index) Play playlist entry at the specified index
void	playMedia() Plays the media loaded into the player.
void	playNext() Plays the next item in the playlist
void	playPrevious() Plays the previous item in the playlist
void	removeFromPlaylist(int index) Removes the entry at the specified index from the players' playlist.
void	setAllowContextMenu(boolean allow) Specify whether the player should display a contextual (right-click) menu when the user presses the right mouse button or the menu buttons on the skin.
void	setBannerEnabled(boolean enable) Specifies whether the player should display the DivX advertisement banner at the end of playback.
void	setBufferingMode(DivXPlayer.BufferingMode mode) Specify how the player should buffer downloaded data before attempting to start playback.
void	setControllerVisible(boolean show) Displays or hides the player controls.
void	setDisplayMode(DivXPlayer.DisplayMode mode) Specifies which skin mode the player should use to display playback controls.
void	setLoopCount(int loop) Sets the number of times the current media file should repeat playback before stopping.
void	setPlayPosition(double position) Sets the playback position of the current media
void	setPreview(String imageURL, String message, int messageFontSize) Specifies an image, text and text size to use as a preview for the video.
void	setRepeatMode(RepeatMode mode) Puts the player in the specified repeat mode.
void	setResizeToVideoSize(boolean resize) If the current media is a video, sets the player to adjust its size to match the dimensions of the video
void	setShuffleEnabled(boolean enable) Enables or disables players' shuffle mode.
void	setVolume(double volume) Sets the volume.
void	showLogger(boolean enable) Displays or hides the players' logger widget.
void	stopMedia() Stops the media playback.

Methods inherited from class com.bramosystems.oss.player.core.client.AbstractMediaPlayer

addDebugHandler, addKeyDownHandler, addKeyPressHandler, addKeyUpHandler, addLoadingProgressHandler, addMediaInfoHandler, addMouseDownHandler, addMouseMoveHandler, addMouseUpHandler, addPlayerStateHandler, addPlayStateHandler, addToPlayerReadyCommandQueue, fireDebug, fireError, fireLoadingProgress, fireMediaInfoAvailable, firePlayerStateEvent, firePlayStateEvent, getRate, getWidgetFactory, isPlayerOnPage, removeFromPlayerReadyCommandQueue, setConfigParameter, setConfigParameter, setConfigParameter, setRate

Methods inherited from class com.google.gwt.user.client.ui.Composite

getWidget, initWidget, isAttached, onAttach, onBrowserEvent, onDetach, setWidget

Methods inherited from class com.google.gwt.user.client.ui.Widget

addAttachHandler, addDomHandler, addHandler, asWidget, asWidgetOrNull, createHandlerManager, delegateEvent, doAttachChildren, doDetachChildren, fireEvent, getHandlerCount, getLayoutData, getParent, isOrWasAttached, removeFromParent, setLayoutData, sinkEvents

Methods inherited from class com.google.gwt.user.client.ui.UIObject

addStyleDependentName, addStyleName, ensureDebugId, ensureDebugId, ensureDebugId, getAbsoluteLeft, getAbsoluteTop, getElement, getOffsetHeight, getOffsetWidth, getStyleElement, getStyleName, getStyleName, getStylePrimaryName, getStylePrimaryName, getTitle, isVisible, isVisible, onEnsureDebugId, removeStyleDependentName, removeStyleName, setElement, setElement, setHeight, setPixelSize, setSize, setStyleDependentName, setStyleName, setStyleName, setStyleName, setStyleName, setStylePrimaryName, setStylePrimaryName, setTitle, setVisible, setVisible, setWidth, toString, unsinkEvents

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.google.gwt.event.shared.HasHandlers

fireEvent

Constructor Detail

DivXPlayer

public DivXPlayer(String mediaURL,
                  boolean autoplay,
                  String height,
                  String width)
           throws LoadException,
                  PluginNotFoundException,
                  PluginVersionException

Constructs DivXPlayer to playback media located at mediaURL using the default height of 90px and width of 100%. Media playback begins automatically if autoplay is true.

Parameters:

mediaURL - the URL of the media to playback

autoplay - true to play playing automatically, false otherwise

height - the height of the player

width - the width of the player.

Throws:

LoadException - if an error occurs while loading the media.

PluginVersionException - if the required DivX® Web Player plugin version is not installed on the client.

PluginNotFoundException - if DivX® Web Player plugin is not installed on the client.

DivXPlayer

public DivXPlayer(String mediaURL,
                  boolean autoplay)
           throws LoadException,
                  PluginNotFoundException,
                  PluginVersionException

Constructs DivXPlayer to playback media located at mediaURL using the default height of 90px and width of 100%. Media playback begins automatically if autoplay is true.

Parameters:

mediaURL - the URL of the media to playback

autoplay - true to play playing automatically, false otherwise

Throws:

LoadException - if an error occurs while loading the media.

PluginVersionException - if the required DivX® Web Player plugin version is not installed on the client.

PluginNotFoundException - if DivX® Web Player plugin is not installed on the client.

DivXPlayer

public DivXPlayer(String mediaURL)
           throws LoadException,
                  PluginNotFoundException,
                  PluginVersionException

Constructs DivXPlayer to automatically playback media located at mediaURL using the default height of 90px and width of 100%.

This is the same as calling DivXPlayer(mediaURL, true, "90px", "100%")

Parameters:

mediaURL - the URL of the media to playback

Throws:

LoadException - if an error occurs while loading the media.

PluginVersionException - if the required DivX® Web Player plugin version is not installed on the client.

PluginNotFoundException - if DivX® Web Player plugin is not installed on the client.

Method Detail

onLoad

protected final void onLoad()

Overridden to register player for plugin DOM events

Overrides:

onLoad in class com.google.gwt.user.client.ui.Widget

onUnload

protected void onUnload()

Overridden to release resources

Overrides:

onUnload in class com.google.gwt.user.client.ui.Widget

loadMedia

public void loadMedia(String mediaURL)
               throws LoadException

Description copied from class: AbstractMediaPlayer

Loads the media at the specified URL into the player.

In respect of the same domain policy of some plugins, the URL should point to a destination on the same domain where the application is hosted.

Specified by:

loadMedia in class AbstractMediaPlayer

Parameters:

mediaURL - the URL of the media to load into the player.

Throws:

LoadException - if an error occurs while loading the media

playMedia

public void playMedia()
               throws PlayException

Description copied from class: AbstractMediaPlayer

Plays the media loaded into the player.

Specified by:

playMedia in class AbstractMediaPlayer

Throws:

PlayException - if an error occurs during media playback.

stopMedia

public void stopMedia()

Description copied from class: AbstractMediaPlayer

Stops the media playback.

Specified by:

stopMedia in class AbstractMediaPlayer

pauseMedia

public void pauseMedia()

Description copied from class: AbstractMediaPlayer

Pause the media playback

Specified by:

pauseMedia in class AbstractMediaPlayer

getMediaDuration

public long getMediaDuration()

Description copied from class: AbstractMediaPlayer

Returns the duration of the loaded media in milliseconds. An IllegalStateException is thrown is the player is not available

Specified by:

getMediaDuration in class AbstractMediaPlayer

Returns:

the duration of the loaded media in milliseconds.

getPlayPosition

public double getPlayPosition()

Description copied from class: AbstractMediaPlayer

Gets the current position in the media that is being played.

Specified by:

getPlayPosition in class AbstractMediaPlayer

Returns:

the current position of the media being played.

setPlayPosition

public void setPlayPosition(double position)

Description copied from class: AbstractMediaPlayer

Sets the playback position of the current media

Specified by:

setPlayPosition in class AbstractMediaPlayer

Parameters:

position - the new position from where to start playback

getVolume

public double getVolume()

Description copied from class: AbstractMediaPlayer

Gets the volume ranging from 0 (silent) to 1 (full volume).

Specified by:

getVolume in class AbstractMediaPlayer

Returns:

volume.

setVolume

public void setVolume(double volume)

Description copied from class: AbstractMediaPlayer

Sets the volume.

Specified by:

setVolume in class AbstractMediaPlayer

Parameters:

volume - 0 (silent) to 1 (full volume).

showLogger

public void showLogger(boolean enable)

Description copied from class: AbstractMediaPlayer

Displays or hides the players' logger widget. The logger widget logs debug messages which can be useful during development.

Overrides:

showLogger in class AbstractMediaPlayer

Parameters:

enable - true to make the logger widget visible, false otherwise.

See Also:

Logger

setControllerVisible

public void setControllerVisible(boolean show)

Displays or hides the player controls.

If this player is not available on the panel, this method call is added to the command-queue for later execution.

Overrides:

setControllerVisible in class AbstractMediaPlayer

Parameters:

show - true to make the player controls visible, false otherwise.

isControllerVisible

public boolean isControllerVisible()

Checks whether the player controls are visible.

Overrides:

isControllerVisible in class AbstractMediaPlayer

Returns:

true if player controls are visible, false otherwise.

getLoopCount

public int getLoopCount()

Returns the number of times this player repeats playback before stopping.

Overrides:

getLoopCount in class AbstractMediaPlayer

Returns:

the number of times this player will repeat playback before stopping.

setLoopCount

public void setLoopCount(int loop)

Sets the number of times the current media file should repeat playback before stopping.

If this player is not available on the panel, this method call is added to the command-queue for later execution.

Overrides:

setLoopCount in class AbstractMediaPlayer

Parameters:

loop - number of times to repeat playback. A negative value makes playback repeat forever!.

getVideoHeight

public int getVideoHeight()

Description copied from class: AbstractMediaPlayer

Returns the height of the current media

Overrides:

getVideoHeight in class AbstractMediaPlayer

Returns:

the height in pixels

getVideoWidth

public int getVideoWidth()

Description copied from class: AbstractMediaPlayer

Returns the width of the current media

Overrides:

getVideoWidth in class AbstractMediaPlayer

Returns:

the width in pixels

setResizeToVideoSize

public void setResizeToVideoSize(boolean resize)

Description copied from class: AbstractMediaPlayer

If the current media is a video, sets the player to adjust its size to match the dimensions of the video

Overrides:

setResizeToVideoSize in class AbstractMediaPlayer

Parameters:

resize - true if player should adjust its size, false otherwise

isResizeToVideoSize

public boolean isResizeToVideoSize()

Description copied from class: AbstractMediaPlayer

Checks if player is set to adjust its size to match the dimensions of a video.

Overrides:

isResizeToVideoSize in class AbstractMediaPlayer

Returns:

true if player adjusts its size, false otherwise

setBannerEnabled

public void setBannerEnabled(boolean enable)

Specifies whether the player should display the DivX advertisement banner at the end of playback.

If this player is not available on the panel, this method call is added to the command-queue for later execution.

Parameters:

enable - true to enable, false otherwise

setAllowContextMenu

public void setAllowContextMenu(boolean allow)

Specify whether the player should display a contextual (right-click) menu when the user presses the right mouse button or the menu buttons on the skin.

If this player is not available on the panel, this method call is added to the command-queue for later execution.

Parameters:

allow - true to allow, false otherwise

setBufferingMode

public void setBufferingMode(DivXPlayer.BufferingMode mode)

Specify how the player should buffer downloaded data before attempting to start playback.

If this player is not available on the panel, this method call is added to the command-queue for later execution.

Parameters:

mode - the mode

setDisplayMode

public void setDisplayMode(DivXPlayer.DisplayMode mode)

Specifies which skin mode the player should use to display playback controls.

If this player is not available on the panel, this method call is added to the command-queue for later execution.

Parameters:

mode - the display mode

getDisplayMode

public DivXPlayer.DisplayMode getDisplayMode()

Returns the skin mode of the player which is used to display playback controls.

Returns:

the display mode

Since:

1.3

setPreview

public void setPreview(String imageURL,
                       String message,
                       int messageFontSize)

Specifies an image, text and text size to use as a preview for the video.

The image file which should be in PNG, JPEG or GIF format is used as a preview image and is displayed in place of the DivX® logo. The message is displayed on top of the image at the size specified by messageFontSize.

Note: autoplay should be set to false for this method to take effect.

If this player is not available on the panel, this method call is added to the command-queue for later execution.

Parameters:

imageURL - the URL of the preview image

message - the text displayed on top of the image

messageFontSize - the font size of the displayed text

setShuffleEnabled

public void setShuffleEnabled(boolean enable)

Description copied from interface: PlaylistSupport

Enables or disables players' shuffle mode.

Specified by:

setShuffleEnabled in interface PlaylistSupport

Parameters:

enable - true to enable shuffle, false otherwise

isShuffleEnabled

public boolean isShuffleEnabled()

Description copied from interface: PlaylistSupport

Checks if this player is in shuffle mode.

Specified by:

isShuffleEnabled in interface PlaylistSupport

Returns:

true if player is in shuffle mode, false otherwise.

addToPlaylist

public void addToPlaylist(String mediaURL)

Description copied from interface: PlaylistSupport

Adds the media at the specified URL to the players' playlist.

In respect of the same domain policy of some plugins/browsers, the URL should point to a destination on the same domain where the application is hosted.

Specified by:

addToPlaylist in interface PlaylistSupport

Parameters:

mediaURL - the URL of the media.

addToPlaylist

public void addToPlaylist(MRL mediaLocator)

Description copied from interface: PlaylistSupport

Adds the media locator to the players' playlist.

Specified by:

addToPlaylist in interface PlaylistSupport

Parameters:

mediaLocator - specifies alternative URLs of the same media

addToPlaylist

public void addToPlaylist(String... mediaURLs)

Description copied from interface: PlaylistSupport

Adds the media at the specified URLs to the players' playlist.

The player chooses ONLY ONE of the mediaURLs it supports.

In respect of the same domain policy of some browsers, the URLs should point to a destination on the same domain where the application is hosted.

Specified by:

addToPlaylist in interface PlaylistSupport

Parameters:

mediaURLs - the alternative URLs of the same media (probably in different formats).

addToPlaylist

public void addToPlaylist(List<MRL> mediaLocators)

Description copied from interface: PlaylistSupport

Adds the media locators to the players' playlist.

Specified by:

addToPlaylist in interface PlaylistSupport

Parameters:

mediaLocators - list of alternative URLs of the same media

removeFromPlaylist

public void removeFromPlaylist(int index)

Description copied from interface: PlaylistSupport

Removes the entry at the specified index from the players' playlist.

Specified by:

removeFromPlaylist in interface PlaylistSupport

Parameters:

index - the index of the playlist entry.

clearPlaylist

public void clearPlaylist()

Description copied from interface: PlaylistSupport

Removes all entries in the players' playlist

Specified by:

clearPlaylist in interface PlaylistSupport

playNext

public void playNext()
              throws PlayException

Description copied from interface: PlaylistSupport

Plays the next item in the playlist

Specified by:

playNext in interface PlaylistSupport

Throws:

PlayException - if there are no more entries in the playlist to be played. Especially if we've advanced to the end of the playlist. Note: A player with a negative loop count (i.e. set to play forever!) may not throw this exception

playPrevious

public void playPrevious()
                  throws PlayException

Description copied from interface: PlaylistSupport

Plays the previous item in the playlist

Specified by:

playPrevious in interface PlaylistSupport

Throws:

PlayException - if there are no more entries in the playlist to be played. Especially if we've gotten to the beginning of the playlist. Note: A player with a negative loop count (i.e. set to play forever!) may not throw this exception

play

public void play(int index)
          throws IndexOutOfBoundsException

Description copied from interface: PlaylistSupport

Play playlist entry at the specified index

Specified by:

play in interface PlaylistSupport

Parameters:

index - number of the playlist entry

Throws:

IndexOutOfBoundsException - if index is outside the bounds of the playlist

getPlaylistSize

public int getPlaylistSize()

Description copied from interface: PlaylistSupport

Returns the number of entries in the playlist

Specified by:

getPlaylistSize in interface PlaylistSupport

Returns:

number of entries in the playlist

getRepeatMode

public RepeatMode getRepeatMode()

Description copied from class: AbstractMediaPlayer

Returns the current playback repeat mode

Overrides:

getRepeatMode in class AbstractMediaPlayer

Returns:

repeat mode

See Also:

RepeatMode

setRepeatMode

public void setRepeatMode(RepeatMode mode)

Description copied from class: AbstractMediaPlayer

Puts the player in the specified repeat mode.

The effect of the specified mode depends on the AbstractMediaPlayer.setLoopCount(int) property as shown in the table:

Value of loopCount	Value of repeatMode	What it means?
Any value < 0	Sets repeatMode to RepeatMode.REPEAT_ALL	Playlist is repeated continously
1	RepeatMode.REPEAT_OFF	Entire playlist is played only once
	RepeatMode.REPEAT_ONE	The current playlist entry is repeated continously
	RepeatMode.REPEAT_ALL	Entire playlist is repeated continously
Any value > 1	RepeatMode.REPEAT_OFF	The loopCount property is ignored, and the entire playlist is played only once
	RepeatMode.REPEAT_ONE	Player repeats each playlist entry for the number of times specified by loopCount and moves on the next until all entries are played and stops
	RepeatMode.REPEAT_ALL	Player repeats entire playlist for the number of times specified by loopCount and stops

Overrides:

setRepeatMode in class AbstractMediaPlayer

Parameters:

mode - the new repeat mode

See Also:

RepeatMode