com.sun.dtv.media.language
Interface LanguageControl

All Superinterfaces:

Control

All Known Subinterfaces:

AudioControl, OverlayTextControl

public interface LanguageControl

extends Control

Control to query the supported languages and to set a specific language for a player. Languages must be coded in three letter abbreviations defined by ISO 639-2 and specified in ABNT NBR 15603-2 for the usage in service descriptors.

See Also:

Player

Method Summary

String	getDefaultLanguage() Returns the default language of the stream/network signaling.
String	getLanguage() Provides the currently selected language to the application.
String[]	getSupportedLanguages() Provides a list of all supported language of the current service to the application.
boolean	setLanguage(String language) Sets the language for the player, overrides all previously selected languages.

Methods inherited from interface javax.media.Control

getControlComponent

Method Detail

getSupportedLanguages

public String[] getSupportedLanguages()

Provides a list of all supported language of the current service to the application. If no language is supported the array of language is of length zero

Returns:

Array with all the language supported or null if no language support

setLanguage

public boolean setLanguage(String language)
                    throws LanguageNotSupportedException,
                           IllegalArgumentException

Sets the language for the player, overrides all previously selected languages.

Parameters:

language - to be used either for Audio or Subtitles coded as three letter String

Returns:

true if setting the language was succesful, false otherwise

Throws:

LanguageNotSupportedException - in case a language is set that is not supported by the system

IllegalArgumentException - if the language String is not three characters long

See Also:

getLanguage()

getLanguage

public String getLanguage()

Provides the currently selected language to the application.

Returns:

language code of the currently selected language or null if no language is selected

See Also:

setLanguage(java.lang.String)

getDefaultLanguage

public String getDefaultLanguage()

Returns the default language of the stream/network signaling.

Returns:

the default language code of the system or null if no default language is present