TvContentRating Class

Definition

[Android.Runtime.Register("android/media/tv/TvContentRating", DoNotGenerateAcw=true)]
public sealed class TvContentRating : Java.Lang.Object

[<Android.Runtime.Register("android/media/tv/TvContentRating", DoNotGenerateAcw=true)>]
type TvContentRating = class
    inherit Object

Inheritance

Object

Object

TvContentRating

Attributes

RegisterAttribute

Remarks

A class representing a TV content rating. When a TV input service inserts the content rating information on a program into the database, this class can be used to generate the formatted string for TvContract.Programs#COLUMN_CONTENT_RATING TvContract.Programs.COLUMN_CONTENT_RATING. To create a TvContentRating object, use the #createRating TvContentRating.createRating method with valid rating system string constants.

It is possible for an application to define its own content rating system by supplying a content rating system definition XML resource (see example below) and declaring a broadcast receiver that filters TvInputManager#ACTION_QUERY_CONTENT_RATING_SYSTEMS in its manifest.

<h3> Example: Rating system definition for the TV Parental Guidelines</h3> The following XML example shows how the TV Parental Guidelines in the United States can be defined:

{@literal
<rating-system-definitions xmlns:android="http://schemas.android.com/apk/res/android"
                android:versionCode="1">
<rating-system-definition android:name="US_TV"
                    android:country="US"
                    android:description="@string/description_us_tv">
<sub-rating-definition android:name="US_TV_D"
                        android:title="D"
                        android:description="@string/description_us_tv_d" />
<sub-rating-definition android:name="US_TV_L"
                        android:title="L"
                        android:description="@string/description_us_tv_l" />
<sub-rating-definition android:name="US_TV_S"
                        android:title="S"
                        android:description="@string/description_us_tv_s" />
<sub-rating-definition android:name="US_TV_V"
                        android:title="V"
                        android:description="@string/description_us_tv_v" />
<sub-rating-definition android:name="US_TV_FV"
                        android:title="FV"
                        android:description="@string/description_us_tv_fv" />

<rating-definition android:name="US_TV_Y"
                        android:title="TV-Y"
                        android:description="@string/description_us_tv_y"
                        android:icon="@drawable/icon_us_tv_y"
                        android:contentAgeHint="0" />
<rating-definition android:name="US_TV_Y7"
                        android:title="TV-Y7"
                        android:description="@string/description_us_tv_y7"
                        android:icon="@drawable/icon_us_tv_y7"
                        android:contentAgeHint="7">
<sub-rating android:name="US_TV_FV" />
</rating-definition>
<rating-definition android:name="US_TV_G"
                        android:title="TV-G"
                        android:description="@string/description_us_tv_g"
                        android:icon="@drawable/icon_us_tv_g"
                        android:contentAgeHint="0" />
<rating-definition android:name="US_TV_PG"
                        android:title="TV-PG"
                        android:description="@string/description_us_tv_pg"
                        android:icon="@drawable/icon_us_tv_pg"
                        android:contentAgeHint="14">
<sub-rating android:name="US_TV_D" />
<sub-rating android:name="US_TV_L" />
<sub-rating android:name="US_TV_S" />
<sub-rating android:name="US_TV_V" />
</rating-definition>
<rating-definition android:name="US_TV_14"
                        android:title="TV-14"
                        android:description="@string/description_us_tv_14"
                        android:icon="@drawable/icon_us_tv_14"
                        android:contentAgeHint="14">
<sub-rating android:name="US_TV_D" />
<sub-rating android:name="US_TV_L" />
<sub-rating android:name="US_TV_S" />
<sub-rating android:name="US_TV_V" />
</rating-definition>
<rating-definition android:name="US_TV_MA"
                        android:title="TV-MA"
                        android:description="@string/description_us_tv_ma"
                        android:icon="@drawable/icon_us_tv_ma"
                        android:contentAgeHint="17">
<sub-rating android:name="US_TV_L" />
<sub-rating android:name="US_TV_S" />
<sub-rating android:name="US_TV_V" />
</rating-definition>
<rating-order>
<rating android:name="US_TV_Y" />
<rating android:name="US_TV_Y7" />
</rating-order>
<rating-order>
<rating android:name="US_TV_G" />
<rating android:name="US_TV_PG" />
<rating android:name="US_TV_14" />
<rating android:name="US_TV_MA" />
</rating-order>
</rating-system-definition>
</rating-system-definitions>}

<h3>System defined rating strings</h3> The following strings are defined by the system to provide a standard way to create TvContentRating objects.

For example, to create an object that represents TV-PG rating with suggestive dialogue and coarse language from the TV Parental Guidelines in the United States, one can use the following code snippet:

TvContentRating rating = TvContentRating.createRating(
                    "com.android.tv",
                    "US_TV",
                    "US_TV_PG",
                    "US_TV_D", "US_TV_L");

<h4>System defined string for domains</h4> <table> <tr> <th>Constant Value</th> <th>Description</th> </tr> <tr> <td>com.android.tv</td> <td>Used for creating system defined content ratings</td> </tr> </table>

<h4>System defined strings for rating systems</h4> <table> <tr> <th>Constant Value</th> <th>Description</th> </tr> <tr> <td>AR_TV</td> <td>TV content rating system for Argentina</td> </tr> <tr> <td>AU_TV</td> <td>TV content rating system for Australia</td> </tr> <tr> <td>BR_TV</td> <td>TV content rating system for Brazil</td> </tr> <tr> <td>CA_TV_EN</td> <td>TV content rating system for Canada (English)</td> </tr> <tr> <td>CA_TV_FR</td> <td>TV content rating system for Canada (French)</td> </tr> <tr> <td>DTMB</td> <td>DTMB content rating system</td> </tr> <tr> <td>DVB</td> <td>DVB content rating system</td> </tr> <tr> <td>ES_DVB</td> <td>DVB content rating system for Spain</td> </tr> <tr> <td>FR_DVB</td> <td>DVB content rating system for France</td> </tr> <tr> <td>ISDB</td> <td>ISDB content rating system</td> </tr> <tr> <td>KR_TV</td> <td>TV content rating system for South Korea</td> </tr> <tr> <td>NZ_TV</td> <td>TV content rating system for New Zealand</td> </tr> <tr> <td>SG_TV</td> <td>TV content rating system for Singapore</td> </tr> <tr> <td>TH_TV</td> <td>TV content rating system for Thailand</td> </tr> <tr> <td>US_MV</td> <td>Movie content rating system for the United States</td> </tr> <tr> <td>US_TV</td> <td>TV content rating system for the United States</td> </tr> </table>

<h4>System defined strings for ratings</h4> <table> <tr> <th>Rating System</th> <th>Constant Value</th> <th>Description</th> </tr> <tr> <td valign="top" rowspan="4">AR_TV</td> <td>AR_TV_ATP</td> <td>Suitable for all audiences. Programs may contain mild violence, language and mature situations</td> </tr> <tr> <td>AR_TV_SAM_13</td> <td>Suitable for ages 13 and up. Programs may contain mild to moderate language and mild violence and sexual references</td> </tr> <tr> <td>AR_TV_SAM_16</td> <td>Suitable for ages 16 and up. Programs may contain more intensive violence and coarse language, partial nudity and moderate sexual references</td> </tr> <tr> <td>AR_TV_SAM_18</td> <td>Suitable for mature audiences only. Programs contain strong violence, coarse language and explicit sexual references</td> </tr> <tr> <td valign="top" rowspan="8">AU_TV</td> <td>AU_TV_P</td> <td>Recommended for younger children aged between 2 and 11 years</td> </tr> <tr> <td>AU_TV_C</td> <td>Recommended for older children aged between 5 and 14 years</td> </tr> <tr> <td>AU_TV_G</td> <td>Recommended for all ages</td> </tr> <tr> <td>AU_TV_PG</td> <td>Parental guidance is recommended for young viewers under 15</td> </tr> <tr> <td>AU_TV_M</td> <td>Recommended for mature audiences aged 15 years and over</td> </tr> <tr> <td>AU_TV_MA</td> <td>Not suitable for children and teens under 15, due to sexual descriptions, course language, adult themes or drug use</td> </tr> <tr> <td>AU_TV_AV</td> <td>Not suitable for children and teens under 15. This category is used specifically for violent programs</td> </tr> <tr> <td>AU_TV_R</td> <td>Not for children under 18. Content may include graphic violence, sexual situations, coarse language and explicit drug use</td> </tr> <tr> <td valign="top" rowspan="6">BR_TV</td> <td>BR_TV_L</td> <td>Content is suitable for all audiences</td> </tr> <tr> <td>BR_TV_10</td> <td>Content suitable for viewers over the age of 10</td> </tr> <tr> <td>BR_TV_12</td> <td>Content suitable for viewers over the age of 12</td> </tr> <tr> <td>BR_TV_14</td> <td>Content suitable for viewers over the age of 14</td> </tr> <tr> <td>BR_TV_16</td> <td>Content suitable for viewers over the age of 16</td> </tr> <tr> <td>BR_TV_18</td> <td>Content suitable for viewers over the age of 18</td> </tr> <tr> <td valign="top" rowspan="7">CA_TV_EN</td> <td>CA_TV_EN_EXEMPT</td> <td>Exempt from ratings</td> </tr> <tr> <td>CA_TV_EN_C</td> <td>Suitable for children ages 2&#8211;7</td> </tr> <tr> <td>CA_TV_EN_C8</td> <td>Suitable for children ages 8 and older</td> </tr> <tr> <td>CA_TV_EN_G</td> <td>Suitable for the entire family</td> </tr> <tr> <td>CA_TV_EN_PG</td> <td>May contain moderate violence, profanity, nudity, and sexual references</td> </tr> <tr> <td>CA_TV_EN_14</td> <td>Intended for viewers ages 14 and older</td> </tr> <tr> <td>CA_TV_EN_18</td> <td>Intended for viewers ages 18 and older</td> </tr> <tr> <td valign="top" rowspan="6">CA_TV_FR</td> <td>CA_TV_FR_E</td> <td>Exempt from ratings</td> </tr> <tr> <td>CA_TV_FR_G</td> <td>Appropriate for all ages</td> </tr> <tr> <td>CA_TV_FR_8</td> <td>Appropriate for children 8</td> </tr> <tr> <td>CA_TV_FR_13</td> <td>Suitable for children 13</td> </tr> <tr> <td>CA_TV_FR_16</td> <td>Recommended for children over the age of 16</td> </tr> <tr> <td>CA_TV_FR_18</td> <td>Only to be viewed by adults</td> </tr> <tr> <td valign="top" rowspan="15">DTMB</td> <td>DTMB_4</td> <td>Recommended for ages 4 and over</td> </tr> <tr> <td>DTMB_5</td> <td>Recommended for ages 5 and over</td> </tr> <tr> <td>DTMB_6</td> <td>Recommended for ages 6 and over</td> </tr> <tr> <td>DTMB_7</td> <td>Recommended for ages 7 and over</td> </tr> <tr> <td>DTMB_8</td> <td>Recommended for ages 8 and over</td> </tr> <tr> <td>DTMB_9</td> <td>Recommended for ages 9 and over</td> </tr> <tr> <td>DTMB_10</td> <td>Recommended for ages 10 and over</td> </tr> <tr> <td>DTMB_11</td> <td>Recommended for ages 11 and over</td> </tr> <tr> <td>DTMB_12</td> <td>Recommended for ages 12 and over</td> </tr> <tr> <td>DTMB_13</td> <td>Recommended for ages 13 and over</td> </tr> <tr> <td>DTMB_14</td> <td>Recommended for ages 14 and over</td> </tr> <tr> <td>DTMB_15</td> <td>Recommended for ages 15 and over</td> </tr> <tr> <td>DTMB_16</td> <td>Recommended for ages 16 and over</td> </tr> <tr> <td>DTMB_17</td> <td>Recommended for ages 17 and over</td> </tr> <tr> <td>DTMB_18</td> <td>Recommended for ages 18 and over</td> </tr> <tr> <td valign="top" rowspan="15">DVB</td> <td>DVB_4</td> <td>Recommended for ages 4 and over</td> </tr> <tr> <td>DVB_5</td> <td>Recommended for ages 5 and over</td> </tr> <tr> <td>DVB_6</td> <td>Recommended for ages 6 and over</td> </tr> <tr> <td>DVB_7</td> <td>Recommended for ages 7 and over</td> </tr> <tr> <td>DVB_8</td> <td>Recommended for ages 8 and over</td> </tr> <tr> <td>DVB_9</td> <td>Recommended for ages 9 and over</td> </tr> <tr> <td>DVB_10</td> <td>Recommended for ages 10 and over</td> </tr> <tr> <td>DVB_11</td> <td>Recommended for ages 11 and over</td> </tr> <tr> <td>DVB_12</td> <td>Recommended for ages 12 and over</td> </tr> <tr> <td>DVB_13</td> <td>Recommended for ages 13 and over</td> </tr> <tr> <td>DVB_14</td> <td>Recommended for ages 14 and over</td> </tr> <tr> <td>DVB_15</td> <td>Recommended for ages 15 and over</td> </tr> <tr> <td>DVB_16</td> <td>Recommended for ages 16 and over</td> </tr> <tr> <td>DVB_17</td> <td>Recommended for ages 17 and over</td> </tr> <tr> <td>DVB_18</td> <td>Recommended for ages 18 and over</td> </tr> <tr> <td valign="top" rowspan="18">ES_DVB</td> <td>ES_DVB_ALL</td> <td>Recommended for all ages</td> </tr> <tr> <td>ES_DVB_C</td> <td>Recommended for children</td> </tr> <tr> <td>ES_DVB_X</td> <td>Recommended for adults</td> </tr> <tr> <td>ES_DVB_4</td> <td>Recommended for ages 4 and over</td> </tr> <tr> <td>ES_DVB_5</td> <td>Recommended for ages 5 and over</td> </tr> <tr> <td>ES_DVB_6</td> <td>Recommended for ages 6 and over</td> </tr> <tr> <td>ES_DVB_7</td> <td>Recommended for ages 7 and over</td> </tr> <tr> <td>ES_DVB_8</td> <td>Recommended for ages 8 and over</td> </tr> <tr> <td>ES_DVB_9</td> <td>Recommended for ages 9 and over</td> </tr> <tr> <td>ES_DVB_10</td> <td>Recommended for ages 10 and over</td> </tr> <tr> <td>ES_DVB_11</td> <td>Recommended for ages 11 and over</td> </tr> <tr> <td>ES_DVB_12</td> <td>Recommended for ages 12 and over</td> </tr> <tr> <td>ES_DVB_13</td> <td>Recommended for ages 13 and over</td> </tr> <tr> <td>ES_DVB_14</td> <td>Recommended for ages 14 and over</td> </tr> <tr> <td>ES_DVB_15</td> <td>Recommended for ages 15 and over</td> </tr> <tr> <td>ES_DVB_16</td> <td>Recommended for ages 16 and over</td> </tr> <tr> <td>ES_DVB_17</td> <td>Recommended for ages 17 and over</td> </tr> <tr> <td>ES_DVB_18</td> <td>Recommended for ages 18 and over</td> </tr> <tr> <td valign="top" rowspan="16">FR_DVB</td> <td>FR_DVB_U</td> <td>Recommended for all ages</td> </tr> <tr> <td>FR_DVB_4</td> <td>Recommended for ages 4 and over</td> </tr> <tr> <td>FR_DVB_5</td> <td>Recommended for ages 5 and over</td> </tr> <tr> <td>FR_DVB_6</td> <td>Recommended for ages 6 and over</td> </tr> <tr> <td>FR_DVB_7</td> <td>Recommended for ages 7 and over</td> </tr> <tr> <td>FR_DVB_8</td> <td>Recommended for ages 8 and over</td> </tr> <tr> <td>FR_DVB_9</td> <td>Recommended for ages 9 and over</td> </tr> <tr> <td>FR_DVB_10</td> <td>Recommended for ages 10 and over</td> </tr> <tr> <td>FR_DVB_11</td> <td>Recommended for ages 11 and over</td> </tr> <tr> <td>FR_DVB_12</td> <td>Recommended for ages 12 and over</td> </tr> <tr> <td>FR_DVB_13</td> <td>Recommended for ages 13 and over</td> </tr> <tr> <td>FR_DVB_14</td> <td>Recommended for ages 14 and over</td> </tr> <tr> <td>FR_DVB_15</td> <td>Recommended for ages 15 and over</td> </tr> <tr> <td>FR_DVB_16</td> <td>Recommended for ages 16 and over</td> </tr> <tr> <td>FR_DVB_17</td> <td>Recommended for ages 17 and over</td> </tr> <tr> <td>FR_DVB_18</td> <td>Recommended for ages 18 and over</td> </tr> <tr> <td valign="top" rowspan="17">ISDB</td> <td>ISDB_4</td> <td>Recommended for ages 4 and over</td> </tr> <tr> <td>ISDB_5</td> <td>Recommended for ages 5 and over</td> </tr> <tr> <td>ISDB_6</td> <td>Recommended for ages 6 and over</td> </tr> <tr> <td>ISDB_7</td> <td>Recommended for ages 7 and over</td> </tr> <tr> <td>ISDB_8</td> <td>Recommended for ages 8 and over</td> </tr> <tr> <td>ISDB_9</td> <td>Recommended for ages 9 and over</td> </tr> <tr> <td>ISDB_10</td> <td>Recommended for ages 10 and over</td> </tr> <tr> <td>ISDB_11</td> <td>Recommended for ages 11 and over</td> </tr> <tr> <td>ISDB_12</td> <td>Recommended for ages 12 and over</td> </tr> <tr> <td>ISDB_13</td> <td>Recommended for ages 13 and over</td> </tr> <tr> <td>ISDB_14</td> <td>Recommended for ages 14 and over</td> </tr> <tr> <td>ISDB_15</td> <td>Recommended for ages 15 and over</td> </tr> <tr> <td>ISDB_16</td> <td>Recommended for ages 16 and over</td> </tr> <tr> <td>ISDB_17</td> <td>Recommended for ages 17 and over</td> </tr> <tr> <td>ISDB_18</td> <td>Recommended for ages 18 and over</td> </tr> <tr> <td>ISDB_19</td> <td>Recommended for ages 19 and over</td> </tr> <tr> <td>ISDB_20</td> <td>Recommended for ages 20 and over</td> </tr> <tr> <td valign="top" rowspan="5">KR_TV</td> <td>KR_TV_ALL</td> <td>Appropriate for all ages</td> </tr> <tr> <td>KR_TV_7</td> <td>May contain material inappropriate for children younger than 7, and parental discretion should be used</td> </tr> <tr> <td>KR_TV_12</td> <td>May deemed inappropriate for those younger than 12, and parental discretion should be used</td> </tr> <tr> <td>KR_TV_15</td> <td>May be inappropriate for children under 15, and that parental discretion should be used</td> </tr> <tr> <td>KR_TV_19</td> <td>For adults only</td> </tr> <tr> <td valign="top" rowspan="3">NZ_TV</td> <td>NZ_TV_G</td> <td>Programmes which exclude material likely to be unsuitable for children. Programmes may not necessarily be designed for child viewers but should not contain material likely to alarm or distress them</td> </tr> <tr> <td>NZ_TV_PGR</td> <td>Programmes containing material more suited for mature audiences but not necessarily unsuitable for child viewers when subject to the guidance of a parent or an adult</td> </tr> <tr> <td>NZ_TV_AO</td> <td>Programmes containing adult themes and directed primarily at mature audiences</td> </tr> <tr> <td valign="top" rowspan="6">SG_TV</td> <td>SG_TV_G</td> <td>Suitable for all ages</td> </tr> <tr> <td>SG_TV_PG</td> <td>Suitable for all but parents should guide their young</td> </tr> <tr> <td>SG_TV_PG13</td> <td>Suitable for persons aged 13 and above but parental guidance is advised for children below 13</td> </tr> <tr> <td>SG_TV_NC16</td> <td>Suitable for persons aged 16 and above</td> </tr> <tr> <td>SG_TV_M18</td> <td>Suitable for persons aged 18 and above</td> </tr> <tr> <td>SG_TV_R21</td> <td>Suitable for adults aged 21 and above</td> </tr> <tr> <td valign="top" rowspan="6">TH_TV</td> <td>TH_TV_4</td> <td>Suitable for audiences 3 to 5 years of age</td> </tr> <tr> <td>TH_TV_6</td> <td>Suitable for audiences 6 to 12 years of age</td> </tr> <tr> <td>TH_TV_10</td> <td>Suitable for all audiences</td> </tr> <tr> <td>TH_TV_13</td> <td>Parental guidance suggested for viewers age below 13</td> </tr> <tr> <td>TH_TV_18</td> <td>Parental guidance suggested for viewers age below 18</td> </tr> <tr> <td>TH_TV_19</td> <td>Not suitable for children and teenagers</td> </tr> <tr> <td valign="top" rowspan="5">US_MV</td> <td>US_MV_G</td> <td>General audiences</td> </tr> <tr> <td>US_MV_PG</td> <td>Parental guidance suggested</td> </tr> <tr> <td>US_MV_PG13</td> <td>Parents strongly cautioned</td> </tr> <tr> <td>US_MV_R</td> <td>Restricted, under 17 requires accompanying parent or adult guardian</td> </tr> <tr> <td>US_MV_NC17</td> <td>No one 17 and under admitted</td> </tr> <tr> <td valign="top" rowspan="6">US_TV</td> <td>US_TV_Y</td> <td>This program is designed to be appropriate for all children</td> </tr> <tr> <td>US_TV_Y7</td> <td>This program is designed for children age 7 and above</td> </tr> <tr> <td>US_TV_G</td> <td>Most parents would find this program suitable for all ages</td> </tr> <tr> <td>US_TV_PG</td> <td>This program contains material that parents may find unsuitable for younger children </td> </tr> <tr> <td>US_TV_14</td> <td>This program contains some material that many parents would find unsuitable for children under 14 years of age</td> </tr> <tr> <td>US_TV_MA</td> <td>This program is specifically designed to be viewed by adults and therefore may be unsuitable for children under 17</td> </tr> </table>

<h4>System defined strings for sub-ratings</h4> <table> <tr> <th>Rating System</th> <th>Constant Value</th> <th>Description</th> </tr> <tr> <td valign="top" rowspan="3">BR_TV</td> <td>BR_TV_D</td> <td>Drugs<br/>Applicable to BR_TV_L, BR_TV_10, BR_TV_12, BR_TV_14, BR_TV_16, and BR_TV_18 </td> </tr> <tr> <td>BR_TV_S</td> <td>Sex<br/>Applicable to BR_TV_L, BR_TV_10, BR_TV_12, BR_TV_14, BR_TV_16, and BR_TV_18 </td> </tr> <tr> <td>BR_TV_V</td> <td>Violence<br/>Applicable to BR_TV_L, BR_TV_10, BR_TV_12, BR_TV_14, BR_TV_16, and BR_TV_18</td> </tr> <tr> <td valign="top" rowspan="5">US_TV</td> <td>US_TV_D</td> <td>Suggestive dialogue (Usually means talks about sex)<br/>Applicable to US_TV_PG, and US_TV_14</td> </tr> <tr> <td>US_TV_L</td> <td>Coarse language<br/>Applicable to US_TV_PG, US_TV_14, and US_TV_MA</td> </tr> <tr> <td>US_TV_S</td> <td>Sexual content<br/>Applicable to US_TV_PG, US_TV_14, and US_TV_MA</td> </tr> <tr> <td>US_TV_V</td> <td>Violence<br/>Applicable to US_TV_PG, US_TV_14, and US_TV_MA</td> </tr> <tr> <td>US_TV_FV</td> <td>Fantasy violence (Children's programming only)<br/>Applicable to US_TV_Y7</td> </tr> </table>

Java documentation for android.media.tv.TvContentRating.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Properties

Methods

Explicit Interface Implementations

Extension Methods

Applies to