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.

javax.tv.service.navigation
Interface ServiceComponent

All Superinterfaces:

SIElement, SIRetrievable

public interface ServiceComponent

extends SIElement

This interface represents an abstraction of an elementary stream. It provides information about individual components of a service. Generally speaking, a service component carries content such as media (e.g. as audio or video) or data. Content within a ServiceComponent may include Xlets.

See Also:

ServiceDetails.retrieveComponents(javax.tv.service.SIRequestor), ProgramEvent.retrieveComponents(javax.tv.service.SIRequestor)

Method Summary

java.lang.String	getAssociatedLanguage() Identifies the language used for the elementary stream.
java.lang.String	getName() Returns a name associated with this component.
Service	getService() Provides the Service object to which this ServiceComponent belongs.
StreamType	getStreamType() Provides the stream type of this component.

Methods inherited from interface javax.tv.service.SIElement

equals, getLocator, getServiceInformationType, hashCode

Methods inherited from interface javax.tv.service.SIRetrievable

getUpdateTime

Method Detail

getName

public java.lang.String getName()

Returns a name associated with this component. The Component Descriptor (DVB) or Component Name Descriptor (ATSC) may be used if present. A generic name (e.g., "video", "first audio", etc.) may be used otherwise.

Returns:

A string representing the component name or an empty string if no name can be associated with this component.

getAssociatedLanguage

public java.lang.String getAssociatedLanguage()

Identifies the language used for the elementary stream. The associated language is indicated using a language code. This is typically a three-character language code as specified by ISO 639.2/B, but the code may be system-dependent.

Returns:

A string representing a language code defining the language associated with this component. An empty string is returned when there is no language associated with this component.

getStreamType

public StreamType getStreamType()

Provides the stream type of this component. (For example, "video", "audio", etc.)

Returns:

Stream type of this component.

getService

public Service getService()

Provides the Service object to which this ServiceComponent belongs. The result may be null if the Service cannot be determined.

Returns:

The Service to which this ServiceComponent belongs.