org.dvb.media
Interface DVBMediaSelectControl
- All Superinterfaces:
- javax.media.Control, javax.tv.media.MediaSelectControl
- public interface DVBMediaSelectControl
- extends javax.tv.media.MediaSelectControl
DVBMediaSelectControl extends MediaSelectControl
allowing
the selection of different kinds of content in a running Player
.
The extension is to allow the selection in a single operation of all the
media service components in a service without needing knowledge about which
media service components are present in that service.
- Since:
- MHP 1.0.2
- See Also:
MediaSelectControl
Method Summary |
void |
selectServiceMediaComponents(javax.tv.locator.Locator l)
Selects for presentation the media service components from a service.
|
Methods inherited from interface javax.tv.media.MediaSelectControl |
add, addMediaSelectListener, getCurrentSelection, remove, removeMediaSelectListener, replace, select, select |
Methods inherited from interface javax.media.Control |
getControlComponent |
selectServiceMediaComponents
public void selectServiceMediaComponents(javax.tv.locator.Locator l)
throws javax.tv.locator.InvalidLocatorException,
javax.tv.service.selection.InvalidServiceComponentException,
javax.tv.service.selection.InsufficientResourcesException
- Selects for presentation the media service components from a service.
If some content is currently playing, it is replaced in its entirety
by the media service components from the specified service.
This is an asynchronous operation that is completed upon receipt of a
MediaSelectEvent. Note that for most selections that imply a different
time base or otherwise change synchronization relationships, a
RestartingEvent will be posted by the Player. The rules for deciding which
media service components shall be presented are defined in the main body
of the present document.
- Parameters:
l
- the locator for a service
- Throws:
javax.tv.locator.InvalidLocatorException
- If the locator provided does not reference
a service.
javax.tv.service.selection.InvalidServiceComponentException
- If the locator provided does not
reference a service which contains at least one media service component
javax.tv.service.selection.InsufficientResourcesException
- If the operation cannot be completed
due to a lack of system resources.