net.rim.plazmic.mediaengine
Interface MediaListener

Deprecated. Use SVGEventListener instead.

public interface MediaListener

The listener interface for all media events.

Since:

BlackBerry API 3.7.0

Field Summary
static int	MEDIA_COMPLETE Deprecated. Sent when all scheduled media actions have been completed.
static int	MEDIA_IO Deprecated. Sent by the MediaManager to notify about download progress/status.
static int	MEDIA_LOADING_FAILED Deprecated. Sent by a MediaManager on failure of asynchronous download of media.
static int	MEDIA_REALIZED Deprecated. Sent by a MediaManager on completion of asynchronous download of media.
static int	MEDIA_REQUESTED Deprecated. Sent when new content is requested.
static int	UNUSED Deprecated. Value to use for "eventParam" parameter values in the MediaListener.mediaEvent(java.lang.Object, int, int, java.lang.Object) method, when the parameter is not required.

Method Summary
void	mediaEvent(Object sender, int event, int eventParam, Object data) Deprecated. Invoked to handle media events.

Field Detail

UNUSED

static final int UNUSED

Deprecated.

Value to use for "eventParam" parameter values in the MediaListener.mediaEvent(java.lang.Object, int, int, java.lang.Object) method, when the parameter is not required.

See Also:

Constant Field Values

Since:

BlackBerry API 3.7.0

MEDIA_COMPLETE

static final int MEDIA_COMPLETE

Deprecated.

Sent when all scheduled media actions have been completed.

Unless the media contains no user focusable items, this event is not guaranteed to be the last event generated by the media, because the user could start an animation with one of the focusable items.

If the media has focusable items then the user can trigger another action. If the media does not have any focusable items then it turns into a static media.

See Also:

Constant Field Values

Since:

BlackBerry API 3.7.0

MEDIA_REQUESTED

static final int MEDIA_REQUESTED

Deprecated.

Sent when new content is requested.

See Also:

Constant Field Values

Since:

BlackBerry API 3.7.0

MEDIA_IO

static final int MEDIA_IO

Deprecated.

Sent by the MediaManager to notify about download progress/status.

See Also:

Constant Field Values

Since:

BlackBerry API 3.7.0

MEDIA_REALIZED

static final int MEDIA_REALIZED

Deprecated.

Sent by a MediaManager on completion of asynchronous download of media.

See Also:

Constant Field Values

Since:

BlackBerry API 3.7.0

MEDIA_LOADING_FAILED

static final int MEDIA_LOADING_FAILED

Deprecated.

Sent by a MediaManager on failure of asynchronous download of media.

See Also:

Constant Field Values

Since:

BlackBerry API 4.0.0

Method Detail

mediaEvent

void mediaEvent(Object sender,
                int event,
                int eventParam,
                Object data)

Deprecated.

Invoked to handle media events.

The particular use of the data parameter varies with the media event being handled:

Media event	data usage
MediaListener.MEDIA_COMPLETE	Points to media data
MediaListener.MEDIA_REQUESTED	Points to a string containing a URL for the requested content
MediaListener.MEDIA_IO	Points to a LoadingStatus object
MediaListener.MEDIA_REALIZED	Contains the media object returned by the downloader
MediaListener.MEDIA_LOADING_FAILED	Holds a URI for the media

Parameters:

sender - Object that initiated the event, usually a MediaPlayer.

event - Event code for the event.

eventParam - Additional parameter associated with some events; at present, third-party implementors should treat this parameter as for internal use only, and ignore any value passed in.

data - Additional data associated with the event.

Since:

BlackBerry API 3.7.0