Package javax.tv.service.selection

Provides a mechanism to select a Service for presentation.

See: Description

Interface Summary

Interface	Description
ServiceContentHandler	A ServiceContentHandler represents a mechanism for presenting, processing or playing portions of a service.
ServiceContext	A ServiceContext represents an environment in which services are presented in a broadcast receiver.
ServiceContextListener	The ServiceContextListener interface is implemented by applications wishing to receive events related to service contexts.
ServiceMediaHandler	ServiceMediaHandler represents an handler of service components that are real time media sharing the same clock.

Class Summary

Class	Description
AlternativeContentEvent	AlternativeContentEvent is generated to indicate that "alternative" content is being presented during the presentation of a service.
NormalContentEvent	NormalContentEvent is generated to indicate that the normal content of a service is being presented.
PresentationChangedEvent	PresentationChangedEvent indicates that the content being presented in the ServiceContext has changed.
PresentationTerminatedEvent	PresentationTerminatedEvent is generated when the presentation of a service terminates.
SelectionFailedEvent	SelectionFailedEvent is generated when a service selection operation fails.
SelectPermission	SelectPermission represents permission to perform a select() operation on a ServiceContext.
ServiceContextDestroyedEvent	ServiceContextDestroyedEvent is generated when a ServiceContext is destroyed via its destroy() method.
ServiceContextEvent	The parent class for service context events.
ServiceContextFactory	This class serves as a factory for the creation of ServiceContext objects.
ServiceContextPermission	ServiceContextPermission represents permission to control a ServiceContext.

Exception Summary

Exception	Description
InsufficientResourcesException	InsufficientResourcesException is generated when sufficient resources for an operation are not available.
InvalidServiceComponentException	This exception is thrown when one or more service components are not valid for usage in a particular context.
ServiceContextException	The base class for exceptions related to service contexts.

Package javax.tv.service.selection Description

Provides a mechanism to select a Service for presentation. The ServiceContext interface abstracts receiver resources required to tune to and present the content of a service, such a tuner, MPEG decoder, screen real estate, and interactive content handlers. The ServiceContext.select() method constitutes a high-level mechanism by which applications may cause the receiver to tune to a desired service, demultiplex the necessary service components, present the audio and video, and launch any associated applications. Applications launched by the ServiceContext.select() method are said to "run" within the ServiceContext.

Due to the scarce nature of the resources embodied by a ServiceContext, implementations may limit the total number of simultaneous ServiceContext objects to a very small number, perhaps even one. (ServiceContext objects in the destroyed state do not count toward this total.) Given appropriate security permissions, it is always possible to access (via ServiceContextFactory.getServiceContexts()) or create (via ServiceContextFactory.createServiceContext()) at least one ServiceContext instance.

See Also:

ServiceContext, ServiceContextFactory