Use is subject to License Terms. Your use of this web site or any of its content or software indicates your agreement to be bound by these License Terms.

Copyright © 2006 Sun Microsystems, Inc. All rights reserved.

JSR-927 (Maintenance Release)

Package javax.tv.service.selection

Provides a mechanism to select a Service for presentation.

See:
          Description

Interface Summary
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
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
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

JSR-927 (Maintenance Release)

Copyright © 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to License Terms. Your use of this web site or any of its content or software indicates your agreement to be bound by these License Terms.

For more information, please consult the JSR 927 specification.