The ParentalRating class
Support in HbbTV
Available since: HbbTV 1.0 (ETSI TS 102 796 V1.1.1, OIPF DAE V1.1)
For instances with a scheme of “dvb-si”, the name property is a string containing an age in years, encoded as a decimal in the range “4” to “18” inclusive. For further information, see clause A.2.28.
Comment
The DVB parental rating scheme is represented in a ParentalRating object by setting the scheme property to “dvb-si”. The contents of the ParentalRating object are determined by the DVB parental_rating_descriptor, as defined in clause 8.4.4 of DAE [1]. The relationship between the rating field in the DVB parental_rating_descriptor and the ParentalRating object name and value properties is shown in Table A.4.
Table A.4: Encoding of parental rating
Value in DVB-SI rating field | ParentalRating name property | ParentalRating value property | Description |
0x01 | “4” | 4 | Recommended minimum age is 4 years old |
0x02 | “5” | 5 | Recommended minimum age is 5 years old |
0x03 | “6” | 6 | Recommended minimum age is 6 years old |
0x04 | “7” | 7 | Recommended minimum age is 7 years old |
0x05 | “8” | 8 | Recommended minimum age is 8 years old |
0x06 | “9” | 9 | Recommended minimum age is 9 years old |
0x07 | “10” | 10 | Recommended minimum age is 10 years old |
0x08 | “11” | 11 | Recommended minimum age is 11 years old |
0x09 | “12” | 12 | Recommended minimum age is 12 years old |
0x0A | “13” | 13 | Recommended minimum age is 13 years old |
0x0B | “14” | 14 | Recommended minimum age is 14 years old |
0x0C | “15” | 15 | Recommended minimum age is 15 years old |
0x0D | “16” | 16 | Recommended minimum age is 16 years old |
0x0E | “17” | 17 | Recommended minimum age is 17 years old |
0x0F | “18” | 18 | Recommended minimum age is 18 years old |
A ParentalRating object describes a parental rating value for a programme or channel. The ParentalRating object identifies both the rating scheme in use, and the parental rating value within that scheme.
In case of a BCG the values of the properties in this object will be read from the ParentalGuidance element that is the child of a programme’s BCG description.
Example usage:
<!-- This example shows a possible usage scenario for the ParentalRating
data structure, i.e. to create a new programme to record and set
parental rating to MPAA parental rating to PG-13.
-->
...
<script type="text/javascript" language="Javascript1.5">
// get a reference to the recorder object
var recorder = document.getElementById("recorder");
// create new programme to record
var myProgramme = recorder.createProgrammeObject();
// add a new parental rating value to myProgramme, in this case the
// programme is rated PG-13 for the US using the MPAA Parental rating scheme.
myProgramme.parentalRatings.addParentalRating(
"urn:mpeg:mpeg7:cs:MPAAParentalRatingCS:2001", "PG-13", 2, 0, "US"
);
</script>
...
<object id="recorder" type="application/oipfRecordingScheduler"/>
Properties
readonly String name |
The string representation of the parental rating value for the respective rating scheme denoted by property scheme. Valid strings include: · if the value of property scheme represents one of the parental rating classification scheme names identified by [MPEG-7]: the string representation of one of the parental rating values as defined by one of the <Name> elements. · if the value of property scheme is ”urn:oipf:GermanyFSKCS” , the string representation of one the values for the GermanyFSK rating scheme as defined in [OIPF_META2]. · if the value of property scheme is equal to “dvb-si”, this means that the scheme of a minimum recommended age encoded as per ratings 0x01 to 0x0f in the parental rating descriptor from [EN 300 468], which corresponds to rating_type 0 in [IEC62455]. NOTE: If the broadcaster defined range from 0x10 to 0xff is used then that would be a different parental rating scheme and not “dvb-si”. An example of a valid parental rating value is “PG-13”. |
readonly String scheme |
Unique name identifying the parental rating guidance scheme to which this parental rating value refers. Valid strings include: · the URI of one of the MPEG-7 classification schemes representing a parental rating scheme as defined by the “uri” attribute of one of the parental rating <ClassificationScheme> elements in [MPEG-7]. · the string value “urn:oipf:GermanyFSKCS” to represent the GermanyFSK rating scheme as defined in [OIPF_META2]. · the string value “dvb-si”: this means that the scheme of a minimum recommended age encoded as per [EN 300 468], is used to represent the parental rating values. |
readonly Integer value |
The parental rating value represented as an index into the set of values defined as part of the ParentalRatingScheme identified through property “scheme”. If an associated ParentalRatingScheme object can be found by calling method getParentalRatingScheme() on property parentalRatingSchemes of the application/oipfParentalControlManager object and the value of property scheme is not equal to “dvb-si”, then the value property SHALL represent the index of the parental rating value inside the ParentalRatingScheme object, or -1 if the value cannot be found. If the value of property scheme is equal to “dvb-si”, then this property SHALL be the integer representation of the string value of ParentalRating property name. If no associated ParentalRatingScheme object can be found by calling method getParentalRatingScheme on property parentalRatingSchemes of the application/oipfParentalControlManager object, then the value property SHALL have value undefined. |
readonly String region |
The region to which the parental rating value applies as an alpha-2 region code as defined in ISO 3166-1. Returns undefined if no specific region has been defined. |