Package javax.tv.service.navigation

Provides APIs to navigate through services and hierarchical service information.

See: Description

Interface Summary

Interface	Description
CAIdentification	This interface associates information related to the conditional access (CA) subsystem with certain SI objects.
FavoriteServicesName	This interface represents the name of a preference describing a set of favorite services.
ServiceComponent	This interface represents an abstraction of an elementary stream.
ServiceComponentChangeListener	This interface is implemented by applications wishing to receive notification of changes to ServiceComponent data.
ServiceDescription	This interface provides a textual description of a Service.
ServiceDetails	This interface provides access to service meta-data.
ServiceIterator	ServiceIterator permits iteration over an ordered list of Service objects.
ServiceList	ServiceList represents an ordered list of Service objects based on a specific grouping rule defined by a ServiceFilter.
ServiceProviderInformation	This interface is used to report additional information concerning the provider of a service.

Class Summary

Class	Description
DeliverySystemType	This class represents values of various types of delivery systems, for example, satellite, cable, etc.
LocatorFilter	LocatorFilter represents a ServiceFilter based on a set of locators.
PreferenceFilter	PreferenceFilter represents a ServiceFilter based on a user preference for favorite services.
ServiceComponentChangeEvent	A ServiceComponentChangeEvent notifies an ServiceComponentChangeListener of changes to a ServiceComponent detected in a ServiceDetails.
ServiceDetailsSIChangeEvent	A ServiceDetailsSIChangeEvent notifies an SIChangeListener of changes to a ServiceDetails.
ServiceFilter	This class represents a set filtering criteria used to generate a ServiceList.
ServiceTypeFilter	ServiceTypeFilter represents a ServiceFilter based on a particular ServiceType.
SIElementFilter	SIElementFilter represents a ServiceFilter based on a particular SIElement (such as a TransportStream or ProgramEvent).
StreamType	This class represents values of ServiceComponent stream types (e.g., "video", "audio", "subtitles", "data", "sections", etc.).

Exception Summary

Exception	Description
FilterNotSupportedException	This exception indicates that the specified ServiceFilter is not supported.
SortNotAvailableException	This exception indicates that the requested sorting method is not available for the particular ServiceList, for example, sorting by service numbers.

Package javax.tv.service.navigation Description

Provides APIs to navigate through services and hierarchical service information. The Navigation package serves two main functions:

• It provides access to detailed SI data about each Service.
• It provides a mechanism to group Services based on various filtering criteria.

Additional information about a service can be obtained through the ServiceDetails object. In contrast to the Service interface, ServiceDetails represents service meta-data that exists in the broadcast. It provides such information as the description of the service, the service type and the service components.

A ServiceComponent represents an individual media or data element associated with a Service. It can also be associated with a ProgramEvent if such information is available. The current ProgramEvent will provide ServiceComponent objects belonging to the Service on which it is carried.

The SIManager can also be used to generate a collection of services called a ServiceList based on filtering criteria represented by a ServiceFilter object. The filtering criterion may be a specific network, transport stream, bouquet, user favorite services, Locator, etc. A resulting ServiceList can be used to sort by service names or numbers and to navigate through the Service objects it contains. The base class ServiceFilter is extended to support predefined filters such as the SIElementFilter, LocatorFilter, PreferenceFilter, etc., which can used to create ServiceList objects based on various filtering criteria. Applications may define custom filters by extending the ServiceFilter class and overriding its accept() method. If no ServiceFilter is specified for the filtering operation, a default collection representing all services known to the receiver (the "installed services") will be generated.