net.rim.plazmic.mediaengine
Interface MediaListener

public interface MediaListener

The listener interface for all media events.

Since:

JDE 3.7.0

Field Summary

static int	MEDIA_COMPLETE Sent when all scheduled media actions have been completed.
static int	MEDIA_IO Sent by the MediaLoader to notify about download progress/status.
static int	MEDIA_REALIZED Sent by a MediaManager to return downloaded media.
static int	MEDIA_REQUESTED Sent when new content is requested.
static int	UNUSED Value for eventParam when it's not required.

Method Summary

void	mediaEvent(Object sender, int event, int eventParam, Object data) The listen method.

Field Detail

UNUSED

public static final int UNUSED

Value for eventParam when it's not required.

Since:

JDE 3.7.0

MEDIA_COMPLETE

public static final int MEDIA_COMPLETE

Sent when all scheduled media actions have been completed.

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.

Since:

JDE 3.7.0

MEDIA_REQUESTED

public static final int MEDIA_REQUESTED

Sent when new content is requested.

In this case data will point to a string containing a url to requested content.

Since:

JDE 3.7.0

MEDIA_IO

public static final int MEDIA_IO

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

In this case data will point to a LoadingStatus.

Since:

JDE 3.7.0

MEDIA_REALIZED

public static final int MEDIA_REALIZED

Sent by a MediaManager to return downloaded media.

When the downloader has completed its download, it fires this event and returns the MediaModel in the data field.

Since:

JDE 3.7.0

Method Detail

mediaEvent

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

The listen method.

Parameters:

sender - The object that initiated the event, usually MediaPlayer.

event - An integer representing the event code.

eventParam - An additional parameter that is associated with the event.

data - Additional data that is associated with the event.

Since:

JDE 3.7.0