TIF: Use XML file for representing TvContentRating

This change addresses the following API council feedback.

- Remove all constants from TvContentRating. Instead this class becomes a
  general parser for a tuple of "rating domain"+type+subtype(s).
- Instead of constants in the API, the rating definitions should come from
  parsed XML meta-data tied to a TvInputService entry in the AndroidManifest.
  This XML should define a ranked order of the rating constants along with
  @string references for displaying in the Settings UI.  Mention that the
  "rating domain" should be scoped similar to a package name, for example
  "com.youtube.ratings".
- For system-defined rating types (like US, Korea, etc) we should parse this
  same XML format, but it may come from a hard-coded XML resource (since they
  aren't tied to a single TvInputService.)
- Thoroughly document the built-in supported types in javadoc on TvContentRating.

Change-Id: I0a9526c73c8ca67fd0eeac63f3c63c05657a45e3

1 files changed, 5 insertions, 18 deletions

diff --git a/api/current.txt b/api/current.txt
index 74fdd31..a8bbeed 100644
--- a/api/current.txt
+++ b/api/current.txt
@@ -465,6 +465,7 @@ package android {
     field public static final int contentInsetLeft = 16843863; // 0x1010457
     field public static final int contentInsetRight = 16843864; // 0x1010458
     field public static final int contentInsetStart = 16843861; // 0x1010455
+    field public static final int contentRatingSystemXml = 16843957; // 0x10104b5
     field public static final int controlX1 = 16843798; // 0x1010416
     field public static final int controlX2 = 16843800; // 0x1010418
     field public static final int controlY1 = 16843799; // 0x1010417
@@ -16843,28 +16844,14 @@ package android.media.session {
 package android.media.tv {
 
   public final class TvContentRating {
-    ctor public TvContentRating(java.lang.String);
-    ctor public TvContentRating(java.lang.String, java.lang.String[]);
+    method public static android.media.tv.TvContentRating createRating(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String...);
     method public java.lang.String flattenToString();
+    method public java.lang.String getCountry();
+    method public java.lang.String getDomain();
     method public java.lang.String getMainRating();
+    method public java.lang.String getRatingSystem();
     method public java.util.List<java.lang.String> getSubRatings();
     method public static android.media.tv.TvContentRating unflattenFromString(java.lang.String);
-    field public static final java.lang.String RATING_KR_12 = "RATING_KR_12";
-    field public static final java.lang.String RATING_KR_15 = "RATING_KR_15";
-    field public static final java.lang.String RATING_KR_19 = "RATING_KR_19";
-    field public static final java.lang.String RATING_KR_7 = "RATING_KR_7";
-    field public static final java.lang.String RATING_KR_ALL = "RATING_KR_ALL";
-    field public static final java.lang.String RATING_US_TV_14 = "RATING_US_TV_14";
-    field public static final java.lang.String RATING_US_TV_G = "RATING_US_TV_G";
-    field public static final java.lang.String RATING_US_TV_MA = "RATING_US_TV_MA";
-    field public static final java.lang.String RATING_US_TV_PG = "RATING_US_TV_PG";
-    field public static final java.lang.String RATING_US_TV_Y = "RATING_US_TV_Y";
-    field public static final java.lang.String RATING_US_TV_Y7 = "RATING_US_TV_Y7";
-    field public static final java.lang.String SUBRATING_US_D = "SUBRATING_US_D";
-    field public static final java.lang.String SUBRATING_US_FV = "SUBRATING_US_FV";
-    field public static final java.lang.String SUBRATING_US_L = "SUBRATING_US_L";
-    field public static final java.lang.String SUBRATING_US_S = "SUBRATING_US_S";
-    field public static final java.lang.String SUBRATING_US_V = "SUBRATING_US_V";
   }
 
   public final class TvContract {