com.sun.media.jfxmedia

Class MediaManager

java.lang.Object

com.sun.media.jfxmedia.MediaManager

public class MediaManager
extends java.lang.Object

Factory class used to create media objects, players, and recorders, and to manage other global functionality.

See Also:

MediaPlayer, MediaRecorder

Constructor Summary

Constructors

Modifier	Constructor and Description
private	MediaManager()

Method Summary

Modifier and Type	Method and Description
static void	addMediaErrorListener(MediaErrorListener listener) Add a global listener for warnings.
static boolean	canPlayContentType(java.lang.String contentType) Whether a media source having the indicated content type may be played.
static boolean	canPlayProtocol(java.lang.String protocol) Whether a media source having the indicated protocol may be played.
static java.util.List<MediaPlayer>	getAllMediaPlayers() Retrieve all un-disposed MediaPlayers.
static Media	getMedia(Locator locator) Gets a Media object for the clip.
static MetadataParser	getMetadataParser(Locator locator)
static MediaPlayer	getPlayer(Locator locator) Get a player for the media locator
static java.lang.String[]	getSupportedContentTypes()
static void	registerMediaPlayerForDispose(java.lang.Object obj, MediaPlayer player) This function will register MediaPlayer for disposing when obj parameter does not have any strong reference.
static void	removeMediaErrorListener(MediaErrorListener listener) Remove a global listener for warnings.

Methods inherited from class java.lang.Object

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

Constructor Detail

MediaManager

private MediaManager()

Method Detail

getSupportedContentTypes

public static java.lang.String[] getSupportedContentTypes()

Returns:

String array of supported content types.

canPlayContentType

public static boolean canPlayContentType(java.lang.String contentType)

Whether a media source having the indicated content type may be played.

Throws:

java.lang.IllegalArgumentException - if contentType is null.

canPlayProtocol

public static boolean canPlayProtocol(java.lang.String protocol)

Whether a media source having the indicated protocol may be played.

Throws:

java.lang.IllegalArgumentException - if contentType is null.

getMetadataParser

public static MetadataParser getMetadataParser(Locator locator)

getMedia

public static Media getMedia(Locator locator)

Gets a Media object for the clip. It cannot be played without attaching to a MediaPlayer.

Parameters:

locator -

Returns:

Media object

Throws:

java.lang.IllegalArgumentException - if locator is null.

getPlayer

public static MediaPlayer getPlayer(Locator locator)

Get a player for the media locator

Parameters:

locator -

Returns:

MediaPlayer object

Throws:

java.lang.IllegalArgumentException - if locator is null.

addMediaErrorListener

public static void addMediaErrorListener(MediaErrorListener listener)

Add a global listener for warnings. This listener will receive warnings which occur fall outside the context of a particular player or recorder.

Parameters:

listener - The listener to add.

Throws:

java.lang.IllegalArgumentException - if listener is null.

removeMediaErrorListener

public static void removeMediaErrorListener(MediaErrorListener listener)

Remove a global listener for warnings.

Parameters:

listener - The listener to remove.

Throws:

java.lang.IllegalArgumentException - if listener is null.

registerMediaPlayerForDispose

public static void registerMediaPlayerForDispose(java.lang.Object obj,
                                                 MediaPlayer player)

This function will register MediaPlayer for disposing when obj parameter does not have any strong reference.

Parameters:

obj - - Object to watch for strong references

player - - MediaPlayer to dispose

getAllMediaPlayers

public static java.util.List<MediaPlayer> getAllMediaPlayers()

Retrieve all un-disposed MediaPlayers.

Returns:

a List of all un-disposed players or null.