org.dvb.media.monitoring
Class BufferingStatusEvent

java.lang.Object
  extended by java.util.EventObject
      extended by org.dvb.media.monitoring.MonitoringEvent
          extended by org.dvb.media.monitoring.BufferingStatusEvent
All Implemented Interfaces:
java.io.Serializable

public class BufferingStatusEvent
extends MonitoringEvent

Event is signalling a change in the buffer status.

Events are sent when a JMF Player is in the Started state.

To prevent implementation from being overloaded BUFFERING_STATUS_UNDERRUN and BUFFERING_STATUS_BACK_TO_NORMAL events should not be sent faster than one per seconds.

See Also:
Serialized Form

Field Summary
static int BUFFERING_STATUS_BACK_TO_NORMAL
          Indicates that buffering status back to a normal state from BUFFERING_STATUS_UNDERRUN or BUFFERING_STATUS_STOPPED states.
static int BUFFERING_STATUS_STOPPED
          Indicates that buffering has been stopped.
static int BUFFERING_STATUS_UNDERRUN
          Indicates that buffering status is underrun.
 
Constructor Summary
BufferingStatusEvent(java.lang.Object source, int bufferingStatus)
          Construct the event.
 
Method Summary
 int getBufferingStatus()
          Get buffering status.
 
Methods inherited from class java.util.EventObject
getSource, toString
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

BUFFERING_STATUS_BACK_TO_NORMAL

public static final int BUFFERING_STATUS_BACK_TO_NORMAL
Indicates that buffering status back to a normal state from BUFFERING_STATUS_UNDERRUN or BUFFERING_STATUS_STOPPED states.

See Also:
Constant Field Values

BUFFERING_STATUS_UNDERRUN

public static final int BUFFERING_STATUS_UNDERRUN
Indicates that buffering status is underrun. It means that coding rate is too high compared with network line rate.

See Also:
Constant Field Values

BUFFERING_STATUS_STOPPED

public static final int BUFFERING_STATUS_STOPPED
Indicates that buffering has been stopped. It means that network connection has been lost.

See Also:
Constant Field Values
Constructor Detail

BufferingStatusEvent

public BufferingStatusEvent(java.lang.Object source,
                            int bufferingStatus)
                     throws java.lang.IllegalArgumentException
Construct the event.

Parameters:
source - the source of the event. The platform shall always pass in the JMF Player presenting the media whose property has been changed
bufferingStatus - the status of the buffer
Throws:
java.lang.IllegalArgumentException - thrown if bufferingStatus is out of range
Method Detail

getBufferingStatus

public int getBufferingStatus()
Get buffering status.

Returns:
status of the buffer