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





Copyright 1999-2010 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.