javax.tv.service

Interface RatingDimension

public interface RatingDimension

The RatingDimension interface represents an individual content rating scheme against which program events are rated. Each rating region may support multiple rating dimensions. One dimension in the U.S. rating region, for example, is used to describe the MPAA list. The dimension name for such a case may be defined as "MPAA". Another example of a rating dimension may be an age-based DVB rating.

See Also:

ProgramEvent, ContentRatingAdvisory

Method Summary

Methods

Modifier and Type	Method and Description
String	getDimensionName() Returns a string which represents the dimension name being described by this object.
short	getNumberOfLevels() Returns the number of levels defined for this dimension.
String[]	getRatingLevelDescription(short ratingLevel) Returns a pair of strings describing the specified rating level for this dimension.

Method Detail

getDimensionName

String getDimensionName()

Returns a string which represents the dimension name being described by this object. One dimension in the U.S. rating region, for example, is used to describe the MPAA list. The dimension name for such a case may be defined as "MPAA".

Returns:

A string representing the name of this rating dimension.

getNumberOfLevels

short getNumberOfLevels()

Returns the number of levels defined for this dimension.

Returns:

The number of levels in this dimension.

getRatingLevelDescription

String[] getRatingLevelDescription(short ratingLevel)
                                   throws SIException

Returns a pair of strings describing the specified rating level for this dimension.

Parameters:

ratingLevel - The rating level for which to retrieve the textual description.

Returns:

A pair of strings representing the names for the specified rating level. The first string represents the abbreviated name for the rating level. The second string represents the full name for the rating level.

Throws:

SIException - If ratingLevel is not valid for this RatingDimension.

See Also:

ContentRatingAdvisory.getRatingLevel(java.lang.String)