org.davic.media

Overview | Package | Class | Use | Tree | Deprecated | Index | Help

PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES

## Package org.davic.media

Provides various extensions to the Java Media Framework for the control of TV oriented audio / video content.

See:
Description

Interface Summary
AudioLanguageControl | Audio language control
FreezeControl | This interface should be implemented to enable the application to freeze the player.
LanguageControl | This interface is the base interface for both audio and subtitling language control.
MediaTimeEventControl | This interface describes methods for the application to associate events with the media time of the current stream.
MediaTimeEventListener | This interface should be implemented by the application in order to receive the events associated to a media position by the application.
MediaTimePositionControl | This interface should be implemented to enable the application to position the media position in time (timeline control).
SubtitlingLanguageControl | Subtitling language control

Class Summary
MediaLocator | Defines a JMF `MediaLocator` which can easily be created from an instance of `org.davic.net.Locator`.
MediaPresentedEvent | Generated as soon as possible after new content is actually being presented to the user, regardless of whether a state change has taken place in the player or not.
MediaTimeEvent | The MediaTimeEvent class describes events that are associated with the stream by the application.
MediaTimePositionChangedEvent | This event is generated whenever the media position is changed (when the invocation of the setMediaPosition resulted in a change in the media position).
ResourceReturnedEvent | Generated if a Player which was stopped due to having its resources withdrawn has had those resources returned to it.
ResourceWithdrawnEvent | Generated if a Player has some or all of the resources used withdrawn for some reason.

Exception Summary
LanguageNotAvailableException | This exception indicates that a requested language was not available
MediaFreezeException | This exception indicates that either the freeze method or the resume method was unsuccessful.
NotAuthorizedException | This exception indicates that the source can not be accessed in order to reference the new content, the source has not been accepted.
NotAuthorizedMediaException | This exception indicates that the source can not be accessed in order to reference the new content, the source has not been accepted.

## Package org.davic.media Description

Provides various extensions to the Java Media Framework for the control of TV oriented audio / video content.

This javadoc has been edited to match the contents of the MHP specification.

The following classes and interfaces not required in the MHP specification have been removed.

- AccessDeniedEvent
- InvalidEventIDException
- InvalidEventNameException
- MediaTimeEvent
- MediaTimeEventControl
- MediaTimeEventListener
- ResourceIOMediaException
- StreamEvent
- StreamEventControl
- StreamEventListener
- HardwareDataSource
- StartUp

The following errata agreed in DVB have been implemented with respect to the original DAVIC work.

- MediaTimePositionChangedEvent. (DVB issue #121)

  Add the following constructor: `MediaTimePositionChangedEvent (Controller from, int previous, int current, int target, Time mediaTime)`

- FreezeControl.resume (DVB issue #754)

  The following is added to the description of this method.

  If the player is started and if decoding of the media stream is not frozen then calls to this method shall have no effect otherwise an exception is thrown.

- NotAuthorizedMediaException (DVB issue #770)

  The standard constructors for this exception, a no-argument one and one with a single 'reason' parameter have been removed and replaced with appropriate ones. The new ones enable values to be passed in for the various 'get' methods in the exception.

- FreezeControl.resume (DVB issue #2363)

  In the description of this method (as modified by DVB issue #754), replace

  If the player is started and if decoding of the media stream is not frozen then calls to this method shall have no effect otherwise an exception is thrown.

  With

  If the player is started and if decoding of the media stream is not frozen then calls to this method shall have no effect.

  If the player is not started then the exception shall be thrown.

- MediaTimePositionChangedEvent - Constructor (DVB issue #2820)

  Add the following definitions for the parameters of this constructor from - the controller whose media position was changed previous previous - the state the controller was in before this event current current - the state the controller was in at the time the event was generated target target - the state that the controller is heading to mediaTime mediaTime - the media time after the change

- NotAuthorizedMediaException - Constructors (DVB issue #770, #776, #2696, #2821, #2696)

  Existing constructors replaced by

  NotAuthorizedMediaException( org.davic.mpeg.Service, int reason )

  NotAuthorizedMediaException( org.davic.mpeg.ServiceElementaryStream[], int reason[] )

  NotAuthorizedMediaException( org.davic.mpeg.ElementaryStream[], int[], int[] )

  NotAuthorizedMediaException(Service, int major_reason,int minor_reason)

- LanguageControl (DVB issue #2281) The following description of semantics is considered to be present:

  If more than one stream with the same language exists, the behaviour of selectLanguage(String)is to select the first listed in the network signalling. NOTE:This is equivalent to item b under 11.4.2.3,"Default media player behaviour".

Overview | Package | Class | Use | Tree | Deprecated | Index | Help

PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES