org.dvb.media
Class PresentationChangedEvent

java.lang.Object
  extended by java.util.EventObject
      extended by javax.media.ControllerEvent
          extended by org.dvb.media.PresentationChangedEvent
All Implemented Interfaces:
java.io.Serializable, javax.media.MediaEvent

public class PresentationChangedEvent
extends javax.media.ControllerEvent

This event is generated whenever the content being presented by a player changes for reasons outside the control of the application. The state of the player does not change - only the content being presented.

See Also:
Serialized Form

Field Summary
static int CA_FAILURE
          Presentation changed due an action by the CA subsystem.
static int CA_RETURNED
          Presentation changed due to an action by the CA subsystem.
static int STREAM_UNAVAILABLE
          The stream being presented is no longer available in the transport stream.
 
Fields inherited from class java.util.EventObject
source
 
Constructor Summary
PresentationChangedEvent(javax.media.Controller source, javax.media.MediaLocator stream, int reason)
          Constructor for the event
 
Method Summary
 int getReason()
          This method returns the reason why access has been withdrawn.
 javax.media.MediaLocator getStream()
          This method returns the locator for the stream now being presented.
 
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
 

Field Detail

STREAM_UNAVAILABLE

public static final int STREAM_UNAVAILABLE
The stream being presented is no longer available in the transport stream.

See Also:
getReason(), Constant Field Values

CA_FAILURE

public static final int CA_FAILURE
Presentation changed due an action by the CA subsystem. Alternate content is being played, not the content selected by the user (e.g. adverts in place of a scrambled service)

See Also:
getReason(), Constant Field Values

CA_RETURNED

public static final int CA_RETURNED
Presentation changed due to an action by the CA subsystem. Normal content is now being presented as requested by the user. This reason code is used when the CA subsystem commands the MHP terminal to switch back to the normal presentation after having previously selected an alternate content.

See Also:
getReason(), Constant Field Values
Constructor Detail

PresentationChangedEvent

public PresentationChangedEvent(javax.media.Controller source,
                                javax.media.MediaLocator stream,
                                int reason)
Constructor for the event

Parameters:
source - the controller whose presentation changed
stream - the stream now being presented.
reason - the reason for the change encoded as one of the constants in this class
Method Detail

getStream

public javax.media.MediaLocator getStream()
This method returns the locator for the stream now being presented.

Returns:
the locator for the stream now being presented

getReason

public int getReason()
This method returns the reason why access has been withdrawn.

Returns:
the reason for the change specified when the event was constructed