javax.tv.service.navigation.package.html Maven / Gradle / Ivy
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.