org.ocap.media
Class AlternativeMediaPresentationEvent

java.lang.Object
  java.util.EventObject
      javax.media.ControllerEvent
          javax.media.TransitionEvent
              org.ocap.media.MediaPresentationEvent
                  org.ocap.media.AlternativeMediaPresentationEvent

All Implemented Interfaces:

Serializable, MediaEvent, NotPresentedMediaInterface

public abstract class AlternativeMediaPresentationEvent
extends MediaPresentationEvent
implements NotPresentedMediaInterface

AlternativeMediaPresentationEvent is a JMF event generated to indicate that an "alternative" content is presented during the media presentation of a service.

Alternative content is defined as content that is not actually part of the service.

AlternativeMediaPresentationEvent notification is generated :

When alternative media content presentation begins;

During the presentation of a service, if any of the service components presented are replaced by alternative content;

During the presentation of a service, if an alternative media content was presented and an evaluation leads to a new alternative media content presentation.

See Also:

Serialized Form

Field Summary

Fields inherited from class java.util.EventObject

source

Constructor Summary

protected

AlternativeMediaPresentationEvent(Controller from, int previous, int current, int target) Constructor of MediaPresentationEvent

Method Summary

ElementaryStream[]	getNotPresentedStreams()
int	getReason(ElementaryStream es)

Methods inherited from class org.ocap.media.MediaPresentationEvent

getPresentedStreams, getSourceURL, getTrigger, isSourceDigital

Methods inherited from class javax.media.TransitionEvent

getCurrentState, getPreviousState, getTargetState

Methods inherited from class javax.media.ControllerEvent

getSource, getSourceController

Methods inherited from class java.util.EventObject

toString

Methods inherited from class java.lang.Object

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

Constructor Detail

AlternativeMediaPresentationEvent

protected AlternativeMediaPresentationEvent(Controller from,
                                            int previous,
                                            int current,
                                            int target)

Constructor of MediaPresentationEvent

See Also:

MediaPresentationEvent

Method Detail

getNotPresentedStreams

public ElementaryStream[] getNotPresentedStreams()

Specified by:

getNotPresentedStreams in interface NotPresentedMediaInterface

Returns:

Returns the subset of explicitly (by Application request) or implicitly (by the Player itself) service components that were selected and which presentation was not possible.

getReason

public int getReason(ElementaryStream es)

Specified by:

getReason in interface NotPresentedMediaInterface

Parameters:

es - a not presented service component.

Returns:

Returns a bit mask of reasons that lead to the non presentation of the given service component. The reasons are defined in AlternativeMediaPresentationReason)interface.