Vega家长监护

​

内容评级

​

概念

​

评级系统

​

内容评级

​

内容描述符

​

构建内容评级

import { ContentMetadataComponent } from '@amazon-devices/kepler-media-content-metadata';

// 在MPA评级系统中定义PG的内容评级。
const contentRating = await ContentMetadataComponent.makeContentRatingBuilder()
  .ratingsSystem('US_TV')
  .rating('US_TV_Y7')
  // 内容描述符数组是可选的。您可以传递一个空数组，或者
  // 直接省略这个设值函数的调用。
  .contentDescriptors(['US_TV_FV'])
  .build();

import { ContentMetadataComponent } from '@amazon-devices/kepler-media-content-metadata';

interface VideoData {
  contentRating: string;
}

// 模拟可能从目录服务器中返回的内容。
// 在此示例中，buildContentRating将对
// 评级TV::PG和MPA::X返回undefined（未评级），因为我们的翻译器未能识别它们。
async function fetchVideoData(): Promise<VideoData[]> {
  return [
    { contentRating: 'MPA::G' },
    { contentRating: 'MPA::PG' },
    { contentRating: 'MPA::PG-13' },
    { contentRating: 'TV::PG' }, // 无法识别的评级
    { contentRating: 'MPA::R' },
    { contentRating: 'MPA::NC-17' },
    { contentRating: 'MPA::X' }, // 无法识别的评级
  ]
}

// 这个函数的用途是将来自目录服务器的这些
// 评级字符串翻译成标准Vega评级字符串。
// 在本例中，我们只知道如何翻译MPA评级。
async function buildContentRating(videoData: VideoData): Promise<ContentRating|undefined> {
  let ratingsSystem: string = '';
  let rating: string = '';
  const [catalogRatingSystem, catalogRating] = videoData.contentRating.split('::');
  switch (catalogRatingSystem) {
    case 'MPA':
      ratingsSystem = 'US_MV';
      switch (catalogRating) {
        case 'G':
          rating = 'US_MV_G';
          break;
          case 'PG':
            rating = 'US_MV_PG';
            break;
          case 'PG-13':
            rating = 'US_MV_PG13';
            break;
          case 'R':
            rating = 'US_MV_R';
            break;
          case 'NC-17':
            rating = 'US_MV_NC17';
            break;
      }
  }
  // 出现错误时，我们会收到未定义的内容评级，这表示
  // 未评级的内容。如果启用了家长监护，这种情况总是会触发PIN
  // 提示。TV:: PG和MPA::X在这里会引发错误，因为
  // 传递的是构建器不允许的空字符串。
  let result;
  try {
    result = await ContentMetadataComponent.makeContentRatingBuilder()
      .ratingsSystem(ratingsSystem)
      .rating(rating)
      .build();
  } catch(e) {
    console.log(`构建内容评级失败：${videoData.contentRating} -> ${ratingsSystem}::${rating}\n${e}`);
  }
  return result;
}

​

受支持的内容评级系统和其标识符列表

​

评级系统

​

包含值和描述的评级系统

• SAMR_ALL - 所有年龄段的观众均可观看。
• SAMR_7 - 建议7岁及以上观众观看。
• SAMR_13 - 建议13岁及以上观众观看。
• SAMR_16 - 建议16岁及以上观众观看。
• SAMR_18 - 建议18岁及以上观众观看。
• SAMR_NR - 未评级。

• AR_TV - 适合所有观众观看。节目可能包含轻微的暴力、粗俗语言和成人情境。
• AR_TV_SAM_13 - 适合13岁及以上观众观看。节目可能包含轻度至中度粗俗语言以及轻度暴力和性暗示。
• AR_TV_SAM_16 - 适合16岁及以上观众观看。节目可能包含较激烈的暴力和粗俗语言、部分裸露内容和中度的性暗示。
• AR_TV_SAM_18 - 仅适合成人观众观看。节目包含重度暴力、粗俗语言和露骨的性暗示。
• AR_TV_C - 适合18岁及以上观众观看。仅限于获特别许可的场地。

• AU_TV_P - 建议年龄在2到11岁之间的年幼儿童观看。
• AU_TV_C - 建议年龄在5到14岁之间的大龄儿童观看。
• AU_TV_G - 所有年龄段的观众均可观看。
• AU_TV_PG - 建议15岁以下的年幼观众在家长指导下观看。
• AU_TV_M - 建议15岁及以上的成人观众观看。
• AU_TV_MA - 由于存在性描述、粗俗语言、成人主题或吸毒，不适合15岁以下的儿童和青少年观看。
• AU_TV_AV - 不适合15岁以下的儿童和青少年观看。该类别专门用于有暴力内容的节目。
• AU_TV_R - 不适合18岁以下的儿童观看。内容可能包含暴力画面、性情境、粗俗语言和露骨吸毒情景。
• AU_TV_X - 仅限18岁及以上观众观看。此分类是一个特殊且受法律限制的类别，仅包含性暴露内容。

• BR_TV_ER - 特别推荐儿童观看。
• BR_TV_L - 内容适合所有观众观看。
• BR_TV_10 - 内容适合10岁以上观众观看。
• BR_TV_12 - 内容适合12岁以上观众观看。
• BR_TV_14 - 内容适合14岁以上观众观看。
• BR_TV_16 - 内容适合16岁以上观众观看。
• BR_TV_18 - 内容适合18岁以上观众观看。

• CA_TV_EN_EXEMPT - 不受评级限制。
• CA_TV_EN_C - 适合2-7岁儿童观看。
• CA_TV_EN_C8 - 适合8岁及以上儿童观看。
• CA_TV_EN_G - 适合整个家庭观看。
• CA_TV_EN_PG - 可能包含中度暴力、亵渎、裸露和性内容。
• CA_TV_EN_14 - 面向14岁及以上的观众。
• CA_TV_EN_18 - 面向18岁及以上的观众。

• CA_TV_FR_E - 不受评级限制。
• CA_TV_FR_G - 适合所有年龄段的观众观看。
• CA_TV_FR_8 - 适合8岁儿童观看。
• CA_TV_FR_13 - 适合13岁儿童观看。
• CA_TV_FR_16 - 建议16岁以上观众观看。
• CA_TV_FR_18 - 仅限成人观看。

• DTMB_4 - 建议4岁及以上观众观看。
• DTMB_5 - 建议5岁及以上观众观看。
• DTMB_6 - 建议6岁及以上观众观看。
• DTMB_7 - 建议7岁及以上观众观看。
• DTMB_8 - 建议8岁及以上观众观看。
• DTMB_9 - 建议9岁及以上观众观看。
• DTMB_10 - 建议10岁及以上观众观看。
• DTMB_11 - 建议11岁及以上观众观看。
• DTMB_12 - 建议12岁及以上观众观看。
• DTMB_13 - 建议13岁及以上观众观看。
• DTMB_14 - 建议14岁及以上观众观看。
• DTMB_15 - 建议15岁及以上观众观看。
• DTMB_16 - 建议16岁及以上观众观看。
• DTMB_17 - 建议17岁及以上观众观看。
• DTMB_18 - 建议18岁及以上观众观看。

• DVB_4 - 建议4岁及以上观众观看。
• DVB_5 - 建议5岁及以上观众观看。
• DVB_6 - 建议6岁及以上观众观看。
• DVB_7 - 建议7岁及以上观众观看。
• DVB_8 - 建议8岁及以上观众观看。
• DVB_9 - 建议9岁及以上观众观看。
• DVB_10 - 建议10岁及以上观众观看。
• DVB_11 - 建议11岁及以上观众观看。
• DVB_12 - 建议12岁及以上观众观看。
• DVB_13 - 建议13岁及以上观众观看。
• DVB_14 - 建议14岁及以上观众观看。
• DVB_15 - 建议15岁及以上观众观看。
• DVB_16 - 建议16岁及以上观众观看。
• DVB_17 - 建议17岁及以上观众观看。
• DVB_18 - 建议18岁及以上观众观看。

• ES_DVB_ALL- 所有年龄段的观众均可观看。
• ES_DVB_C - 建议儿童观看。
• ES_DVB_X - 建议成人观看。
• ES_DVB_4 - 建议4岁及以上观众观看。
• ES_DVB_5 - 建议5岁及以上观众观看。
• ES_DVB_6 - 建议6岁及以上观众观看。
• ES_DVB_7 - 建议7岁及以上观众观看。
• ES_DVB_8 - 建议8岁及以上观众观看。
• ES_DVB_9 - 建议9岁及以上观众观看。
• ES_DVB_10 - 建议10岁及以上观众观看。
• ES_DVB_11 - 建议11岁及以上观众观看。
• ES_DVB_12 - 建议12岁及以上观众观看。
• ES_DVB_13 - 建议13岁及以上观众观看。
• ES_DVB_14 - 建议14岁及以上观众观看。
• ES_DVB_15 - 建议15岁及以上观众观看。
• ES_DVB_16 - 建议16岁及以上观众观看。
• ES_DVB_17 - 建议17岁及以上观众观看。
• ES_DVB_18 - 建议18岁及以上观众观看。

• FR_DVB_U- 所有年龄段的观众均可观看。
• FR_DVB_4 - 建议4岁及以上观众观看。
• FR_DVB_5 - 建议5岁及以上观众观看。
• FR_DVB_6 - 建议6岁及以上观众观看。
• FR_DVB_7 - 建议7岁及以上观众观看。
• FR_DVB_8 - 建议8岁及以上观众观看。
• FR_DVB_9 - 建议9岁及以上观众观看。
• FR_DVB_10 - 建议10岁及以上观众观看。
• FR_DVB_11 - 建议11岁及以上观众观看。
• FR_DVB_12 - 建议12岁及以上观众观看。
• FR_DVB_13 - 建议13岁及以上观众观看。
• FR_DVB_14 - 建议14岁及以上观众观看。
• FR_DVB_15 - 建议15岁及以上观众观看。
• FR_DVB_16 - 建议16岁及以上观众观看。
• FR_DVB_17 - 建议17岁及以上观众观看。
• FR_DVB_18 - 建议18岁及以上观众观看。

• ISDB_4 - 建议4岁及以上观众观看。
• ISDB_5 - 建议5岁及以上观众观看。
• ISDB_6 - 建议6岁及以上观众观看。
• ISDB_7 - 建议7岁及以上观众观看。
• ISDB_8 - 建议8岁及以上观众观看。
• ISDB_9 - 建议9岁及以上观众观看。
• ISDB_10 - 建议10岁及以上观众观看。
• ISDB_11 - 建议11岁及以上观众观看。
• ISDB_12 - 建议12岁及以上观众观看。
• ISDB_13 - 建议13岁及以上观众观看。
• ISDB_14 - 建议14岁及以上观众观看。
• ISDB_15 - 建议15岁及以上观众观看。
• ISDB_16 - 建议16岁及以上观众观看。
• ISDB_17 - 建议17岁及以上观众观看。
• ISDB_18 - 建议18岁及以上观众观看。
• ISDB_19 - 建议19岁及以上观众观看。
• 观众ISDB_20 - 建议20岁及以上观众观看。

• KR_TV_ALL - 适合所有年龄段的观众观看。
• KR_TV_7 - 可能包含不适合7岁以下儿童的素材，应由家长自行决定。
• KR_TV_12 - 可能被认为不适合12岁以下观众，应由家长自行决定。
• KR_TV_15 - 可能不适合15岁以下的儿童，应由家长自行决定。
• KR_TV_19 - 仅限成人观看。

• IN_CBFC_U - 不受限制的公开展览。
• IN_CBFC_UA - 不受限制的公共展览，但12岁以下的儿童需要在家长指导下观看。
• IN_CBFC_A - 仅限成人观看。
• IN_CBFC_S - 仅限任何特殊类别的观众观看。

• JP_EIRIN_G - 普通内容，适合所有年龄段的观众观看。
• JP_EIRIN_PG12 - 12岁以下的年幼观众需要在家长指导下观看。
• JP_EIRIN_R15 - 15岁以下观众禁止观看。
• JP_EIRIN_R18 - 18岁以下观众禁止观看。

• NZ_TV_G - 不含可能不适合儿童观看的素材的节目。节目不一定是为儿童观众而设计，但不应包含可能使其感到恐慌或痛苦的素材。
• NZ_TV_PGR - 包含更适合成人观众的素材的节目，但如果有家长或成人指导，不一定不适合儿童观众。
• NZ_TV_AO - 包含成人主题且主要面向成人观众的节目。

• SG_TV_G - 适合所有年龄段的观众观看。
• SG_TV_PG - 适合所有人，但年幼观众应在父母指导下观看。
• SG_TV_PG13 - 适合13岁及以上观众，但建议13岁以下儿童在家长指导下观看。
• SG_TV_NC16 - 适合16岁及以上观众观看。
• SG_TV_M18 - 适合18岁及以上观众观看。
• SG_TV_R21 - 适合21岁及以上成人观看。

• TH_TV_4 - 适合3至5岁观众观看。
• TH_TV_6 - 适合6至12岁观众观看。
• TH_TV_10 - 适合所有观众观看。
• TH_TV_13 - 建议13岁以下的观众在家长指导下观看。
• TH_TV_18 - 建议年龄在18岁以下的观众在家长指导下观看。
• TH_TV_19 - 不适合儿童和青少年观看。

• UK_BBFC_U -（通用内容 - 适合所有人）- 评级为U的电影应适合四岁及以上观众观看。
• UK_BBFC_PG -（家长指导）- 一般观看内容，但某些场景可能不适合年幼儿童。PG评级的电影不应让八岁或以上的儿童感到不安。
• UK_BBFC_12 -（适合12岁及以上）- 分类为12A的电影和分类为12的视频作品所含的素材通常不适合12岁以下的儿童。除非有成人陪同，否则12岁以下的观众不得在电影院看评级为12A的电影。未满12岁的观众不得租赁或购买评级为12的视频作品。
• UK_BBFC_12A -（适合12岁及以上）- 分类为12A的电影和分类为12的视频作品所含的素材通常不适合12岁以下的儿童。除非有成人陪同，否则12岁以下的观众不得在电影院看评级为12A的电影。未满12岁的观众不得租赁或购买评级为12的视频作品。
• UK_BBFC_15-（仅适合15岁及以上）- 不允许15岁以下的观众在电影院观看评级为15的电影或购买/租赁评级为15的视频。
• UK_BBFC_18 -（仅适合成人）- 18岁以下的任何观众不得在电影院看评级为18的电影或购买/租赁评级为18的视频。
• UK_BBFC_R18-（只能在获得特别许可的电影院放映，或仅在获得许可的性用品商店中提供，且仅限成人观看）- R18类别是一种特殊且受法律限制的分类，主要针对自愿性行为的露骨作品或涉及成人的重度恋物素材。电影只能在获得特别许可的电影院向成人放映，并且视频作品只能在获得许可的性用品商店向成年人提供。评级为R18的视频作品可能无法以邮购方式提供。

• US_MV_G - 面向普通观众。所有年龄段的观众均可观看。
• US_MV_PG - 建议在家长指导下观看。某些素材可能不适合儿童观看。
• US_MV_PG13 - 家长需高度谨慎。某些素材可能不适合13岁以下儿童观看。
• US_MV_R - 受限内容。17岁以下的儿童需要在父母或成年监护人陪同下观看。
• US_MV_NC17 - 17岁及以下观众禁止观看。

• US_TV_Y - 面向所有儿童。
• US_TV_Y7 - 面向大龄儿童。
• US_TV_G - 面向普通观众。
• US_TV_PG - 建议在家长指导下观看。
• US_TV_14 - 家长需高度谨慎。
• US_TV_MA - 仅限成人观众观看。

• ZA_FPB_A - 适合所有观众观看。
• ZA_FPB_PG - 须在家长指导下观看。
• ZA_FPB_7_9PG - 不适合7岁以下儿童观看。除非有成人陪同，否则禁止7-9岁儿童观看。
• ZA_FPB_10_12PG - 不适合10岁以下儿童观看。除非有成人陪同，否则禁止10–12岁儿童观看。
• ZA_FPB_13 - 不适合13岁以下儿童观看。
• ZA_FPB_16 - 不适合16岁以下观众观看。
• ZA_FPB_18 - 不适合18岁以下观众观看。
• ZA_FPB_X18 - 18岁以下观众禁止观看；仅限于获得许可的成人场所。

​

内容描述符

• US_TV_FV - 幻想式暴力。仅适用于US_TV_Y7。
• US_TV_D - 性暗示对话。适用于US_TV_PG和US_TV_14。
• US_TV_L - 粗鄙或粗俗的语言。适用于US_TV_PG、US_TV_14和US_TV_MA。
• US_TV_S - 性情境。适用于US_TV_PG、US_TV_14和US_TV_MA。
• US_TV_V - 暴力。适用于US_TV_PG、US_TV_14和US_TV_MA。

• BR_TV_D - 毒品。适用于BR_TV_L、BR_TV_10、BR_TV_12、BR_TV_14、BR_TV_16和BR_TV_18。
• BR_TV_S - 性爱。适用于BR_TV_L、BR_TV_10、BR_TV_12、BR_TV_14、BR_TV_16和BR_TV_18。
• BR_TV_V - 暴力。适用于BR_TV_L、BR_TV_10、BR_TV_12、BR_TV_14、BR_TV_16和BR_TV_18。

​

内容限制级别 (CRL)

​

以编程方式查询内容限制级别

import { ParentalControlsComponent } from '@amazon-devices/kepler-parental-controls';

const preferenceReader = ParentalControlsComponent.makePreferenceReader();
const crl = preferenceReader.getContentRestrictionLevel();
console.log(JSON.stringify(crl, undefined, 2));
/* 输出示例：
{
  "name": "com.amazon.kepler.parental_controls/content_restriction_levels/us/teen",
  "allowedContentRatings": [
    {
      "ratingLevel": {
        "ratingsSystem": "US_MV",
        "rating": "US_MV_PG13"
      },
      "contentDescriptors": []
    },
    {
      "ratingLevel": {
        "ratingsSystem": "US_TV",
        "rating": "US_TV_PG"
      },
      "contentDescriptors": []
    }
  ]
}
*/

​

集成家长监护以进行内容限制管理

​

先决条件

• 您必须有权访问视频目录的内容评级，这样才能将内容评级传递至Vega家长监护。
• 您必须有一个适用于Vega的React Native应用。
• 您必须拥有Vega SDK版本0.12或更高版本，以及Vega SDK发布说明中定义的相应设备软件。

​

为您的项目添加家长监护

{
  ...
  "dependencies": {
     ...
    "@amazon-devices/kepler-media-content-metadata": "~1.0.0",
    "@amazon-devices/kepler-parental-controls": "~1.0.0"
  }
}

​

声明家长监护权限

[[wants.service]]
id = "com.amazon.kepler.pcon.service.main"

[[needs.privilege]]
id = "com.amazon.kepler.parental_controls.gates.restricted-content-playback"

​

代码示例

import { ContentMetadataComponent } from '@amazon-devices/kepler-media-content-metadata';
import { ParentalControlsComponent } from '@amazon-devices/kepler-parental-controls';

// 这些评级字符串代表标准的Vega评级字符串。
// 有关从目录元数据翻译字符串的讨论，
// 请参阅“构建内容评级”。
interface VideoData {
  ratingsSystem: string;
  rating: string;
  ...
}

async function playVideo(videoData: VideoData) {
  // 默认设置为未定义的“未评级”内容评级。
  let contentRating;

  try {
     contentRating = await ContentMetadataComponent.makeContentRatingBuilder()
       .ratingsSystem(videoData.ratingsSystem)
       .rating(videoData.rating)
       .build();
  } catch (e) {
    // 如果评级无效，构建器可能
    // 引发异常。在该情况下，我们会直接回退到“未评级”行为（如果启用了家长监护，
    // 始终会显示PIN提示）。
    console.error(`构建内容评级失败${videoData.ratingsSystem}::${videoData.rating}: ${e}`);
  }

  // 如果内容受限，则该处将由家长监护
  // 用户界面接管。
  const response = await ParentalControlsComponent.gateContentPlayback(contentRating);

  if (response.canPlaybackProceed) {
    // 如果允许则播放视频……
    videoPlayer.play(videoData);
  } else {
     // ……否则退出。
     navigateBack();
  }
}