org.dvb.media.DVBMediaSelectControl Maven / Gradle / Ivy
package org.dvb.media;
import javax.tv.locator.InvalidLocatorException;
import javax.tv.service.selection.InvalidServiceComponentException;
import javax.tv.service.selection.InsufficientResourcesException;
import javax.tv.locator.Locator;
/**
* 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.
* @see javax.tv.media.MediaSelectControl
* @since MHP 1.0.2
*/
public interface DVBMediaSelectControl extends javax.tv.media.MediaSelectControl
{
/**
* 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.
* @param l the locator for a service
* @throws InvalidLocatorException If the locator provided does not reference
* a service.
* @throws InvalidServiceComponentException If the locator provided does not
* reference a service which contains at least one media service component
* @throws InsufficientResourcesException If the operation cannot be completed
* due to a lack of system resources.
*/
public void selectServiceMediaComponents(Locator l) throws
InvalidLocatorException,InvalidServiceComponentException,
InsufficientResourcesException;
}