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 fieldParentalRating name propertyParentalRating value propertyDescription
0x01“4”4Recommended minimum age is 4 years old
0x02“5”5Recommended minimum age is 5 years old
0x03“6”6Recommended minimum age is 6 years old
0x04“7”7Recommended minimum age is 7 years old
0x05“8”8Recommended minimum age is 8 years old
0x06“9”9Recommended minimum age is 9 years old
0x07“10”10Recommended minimum age is 10 years old
0x08“11”11Recommended minimum age is 11 years old
0x09“12”12Recommended minimum age is 12 years old
0x0A“13”13Recommended minimum age is 13 years old
0x0B“14”14Recommended minimum age is 14 years old
0x0C“15”15Recommended minimum age is 15 years old
0x0D“16”16Recommended minimum age is 16 years old
0x0E“17”17Recommended minimum age is 17 years old
0x0F“18”18Recommended 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 Integer labels

The labels property represents a set of parental advisory flags that may provide additional information about the rating.

The value of this field is a 32 bit integer value that represents a binary mask corresponding to the sum of zero or more label values defined in the table below. If no labels have been explicitly set, the value for the “labels” property SHALL be 0.

Valid labels include:

Value

Description

1

Indicates that a content item features sexual suggestive dialog.

2

Indicates that a content item features strong language.

4

Indicates that a content item features sexual situations.

8

Indicates that a content item features violence.

16

Indicates that a content item features fantasy violence.

32

Indicates that a content item features disturbing scenes.

64

Indicates that a content item features portrayals of discrimination.

128

Indicates that a content item features scenes of illegal drug use.

256

Indicates that a content item features strobing that could impact viewers suffering from Photosensitive epilepsy

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.