应用跟随系统未成年人模式（推荐）

场景介绍

当应用期望跟随系统未成年人模式时，应用可在刚启动时订阅公共事件感知未成年人模式的状态变化，且直接查询系统的未成年人模式是否开启。

1. 如系统已开启未成年人模式，应用需跟随系统主动切换为未成年人模式，并且根据返回的年龄段信息做内容分级，当用户需要调整应用内未成年人模式设置（如内容偏好等）时调用验证未成年人模式密码接口，验证成功后才能进行调整。
2. 如系统未开启未成年人模式，应用的展示内容不做限制。

同时开发者需要注意以下场景：

1. 当应用跟随系统切换未成年人模式状态时，开发者需关注应用后台行为是否需要中断，例如是否需要中断后台播放的音视频内容等，避免未成年人绕过限制，继续访问非适龄内容。
2. 当应用处于前台时，用户可通过下拉控制中心，点击未成年人模式开关，开启系统的未成年人模式。开发者需关注此场景下，应用仍处于前台时的内容刷新时机。

业务流程

流程说明：

1. 用户打开应用时，应用通过订阅公共事件感知未成年人模式的状态变化。如果订阅到未成年人模式开启事件，则开启应用的未成年人模式，如果订阅到未成年人模式关闭事件，则展示内容不做限制。
2. 调用getMinorsProtectionInfoSync或getMinorsProtectionInfo获取未成年人模式的开启状态和年龄段信息，如果未成年人模式未开启，则展示应用内容。如果未成年人模式已开启，则需要根据返回的年龄段做内容分级。
3. 当用户需要调整应用内未成年人模式设置时，调用verifyMinorsProtectionCredential接口验证未成年人模式密码，验证通过才可进行调整。

接口说明

以下是应用跟随系统未成年人模式相关接口说明，更多接口及使用方法请参见API参考。

事件说明

以下是未成年人模式开启/关闭发送的广播事件。

开发步骤

在进行代码开发前，请先确认您已完成配置Client ID工作。

1. 导入minorsProtection模块及相关公共模块。

   import { minorsProtection } from '@kit.AccountKit';
   import { hilog } from '@kit.PerformanceAnalysisKit';
   import { BusinessError, commonEventManager } from '@kit.BasicServicesKit';
   // 以上引入的模块为当前场景的全量模块，请按照具体实现按需引入

2. 创建订阅者，订阅系统未成年人模式开启/关闭事件。推荐在应用Ability的onCreate生命周期中调用。

   //订阅者信息
   const subscribeInfo: commonEventManager.CommonEventSubscribeInfo = {
     events: [commonEventManager.Support.COMMON_EVENT_MINORSMODE_ON,commonEventManager.Support.COMMON_EVENT_MINORSMODE_OFF]
   };
   // 如开发者使用await改写createSubscriber方法，需要把此变量定义到全局(struct外层)
   let subscriber: commonEventManager.CommonEventSubscriber;
   //创建订阅者
   commonEventManager.createSubscriber(subscribeInfo)
     .then((commonEventSubscriber: commonEventManager.CommonEventSubscriber) => {
       // 这里获取到commonEventSubscriber对象需要暂存，用于后续事件回调。不可直接使用，否则会出现事件回调不生效的情况
       subscriber = commonEventSubscriber;
       //订阅公共事件
       commonEventManager.subscribe(subscriber,
         (error: BusinessError, data: commonEventManager.CommonEventData) => {
           if (error) {
             this.dealCommonEventAllError(error);
             return;
           }
           if (data.event === commonEventManager.Support.COMMON_EVENT_MINORSMODE_ON) {
             // 订阅到开启事件，可以调用获取年龄段的接口，根据年龄段刷新内容展示，同时如开发者有缓存年龄段或未成年人模式开启状态，则需要刷新缓存
             return;
           }
           if (data.event === commonEventManager.Support.COMMON_EVENT_MINORSMODE_OFF) {
             // 订阅到关闭事件，关闭当前应用的未成年人模式，刷新应用内容展示，取消年龄限制，如开发者有缓存未成年人模式开启状态，则需要刷新缓存
           }
         });
     })
     .catch((error: BusinessError) => {
       this.dealCommonEventAllError(error);
     });

   dealCommonEventAllError(error: BusinessError): void {
     hilog.error(0x0000, 'testTag', `Failed to subscribe. Code: ${error.code}, message: ${error.message}`);
   }

3. 选择以下一种方式获取未成年人模式的开启状态，以及年龄段信息。当应用期望立即获取结果，推荐使用同步方式，当应用期望使用非阻塞的方式调用接口，推荐使用Promise异步回调方式。推荐在自定义组件的aboutToAppear生命周期或者应用Ability的onCreate生命周期中调用，如开发者有频繁使用到未成年人模式开启状态或年龄段信息，开发者则需把获取到的未成年人模式开启状态或年龄段缓存下来，通过订阅未成年人模式公共事件来刷新未成年人模式开启状态或年龄段。
   • 通过同步方式，调用getMinorsProtectionInfoSync获取未成年人模式的开启状态，以及年龄段信息。

     if (canIUse('SystemCapability.AuthenticationServices.HuaweiID.MinorsProtection')) {
       try {
         if (minorsProtection.supportMinorsMode()) {
           const minorsProtectionInfo: minorsProtection.MinorsProtectionInfo =
             minorsProtection.getMinorsProtectionInfoSync();
           // 获取未成年人模式开启状态
           const minorsProtectionMode: boolean = minorsProtectionInfo.minorsProtectionMode;
           hilog.info(0x0000, 'testTag', `Succeeded in getting minorsProtectionMode is: ${minorsProtectionMode.valueOf()}`);
           // 未成年人模式已开启，获取年龄段信息
           if (minorsProtectionMode) {
             const ageGroup: minorsProtection.AgeGroup | undefined = minorsProtectionInfo.ageGroup;
             // 如开发者有频繁使用到未成年人模式开启状态，这里则需缓存未成年人模式开启状态
             if (ageGroup) {
               hilog.info(0x0000, 'testTag', `Succeeded in getting lowerAge is: ${ageGroup.lowerAge}`);
               hilog.info(0x0000, 'testTag', `Succeeded in getting upperAge is: ${ageGroup.upperAge}`);
               // 根据年龄段刷新内容展示。如开发者有频繁使用到年龄段信息，这里则需缓存年龄段信息
             }
           } else {
             // 未成年人模式未开启，应用需跟随系统未成年人模式，展示内容不做限制
           }
         } else {
           hilog.info(0x0000, 'testTag',
             'The current device environment does not support the youth mode, please check the current device environment.');
         }
       } catch (error) {
         hilog.error(0x0000, 'testTag',
           `Failed to invoke supportMinorsMode or getMinorsProtectionInfoSync. errCode: ${error.code}, errMessage: ${error.message}`);
       }
     } else {
       hilog.info(0x0000, 'testTag',
         'The current device does not support the invoking of the getMinorsProtectionInfoSync interface.');
     }

   • 通过Promise异步回调方式，调用getMinorsProtectionInfo获取未成年人模式的开启状态，以及年龄段信息。

     if (canIUse('SystemCapability.AuthenticationServices.HuaweiID.MinorsProtection')) {
       try {
         if (minorsProtection.supportMinorsMode()) {
           minorsProtection.getMinorsProtectionInfo()
             .then((minorsProtectionInfo: minorsProtection.MinorsProtectionInfo) => {
               // 获取未成年人模式开启状态
               const minorsProtectionMode: boolean = minorsProtectionInfo.minorsProtectionMode;
               // 如开发者有频繁使用到未成年人模式开启状态，这里则需缓存未成年人模式开启状态
               hilog.info(0x0000, 'testTag',
                 `Succeeded in getting minorsProtectionMode is: ${minorsProtectionMode.valueOf()}`);
               // 未成年人模式已开启，获取年龄段信息
               if (minorsProtectionMode) {
                 const ageGroup: minorsProtection.AgeGroup | undefined = minorsProtectionInfo.ageGroup;
                 if (ageGroup) {
                   hilog.info(0x0000, 'testTag', `Succeeded in getting lowerAge is: ${ageGroup.lowerAge}`);
                   hilog.info(0x0000, 'testTag', `Succeeded in getting upperAge is: ${ageGroup.upperAge}`);
                   // 根据年龄段刷新内容展示。如开发者有频繁使用到年龄段信息，这里则需缓存年龄段信息
                 }
               } else {
                 // 未成年人模式未开启，应用需跟随系统未成年人模式，展示内容不做限制
               }
             })
             .catch((error: BusinessError<Object>) => {
               this.dealGetMinorsInfoAllError(error);
             });
         } else {
           hilog.info(0x0000, 'testTag',
             'The current device environment does not support the youth mode, please check the current device environment.');
         }
       } catch (error) {
         hilog.error(0x0000, 'testTag',
           `Failed to invoke supportMinorsMode. errCode: ${error.code}, errMessage: ${error.message}`);
       }
     } else {
       hilog.info(0x0000, 'testTag',
         'The current device does not support the invoking of the getMinorsProtectionInfo interface.');
     }

     dealGetMinorsInfoAllError(error: BusinessError<Object>): void {
       hilog.error(0x0000, 'testTag', `Failed to getMinorsProtectionInfo. Code: ${error.code}, message: ${error.message}`);
     }

4. 当未成年人模式已开启，用户需要调整应用内未成年人模式设置（如内容偏好等）时调用verifyMinorsProtectionCredential方法拉起验证未成年人模式密码页面。

   if (canIUse('SystemCapability.AuthenticationServices.HuaweiID.MinorsProtection')) {
     try {
       if (minorsProtection.supportMinorsMode()) {
         minorsProtection.verifyMinorsProtectionCredential(getContext(this))
           .then((result: boolean) => {
             hilog.info(0x0000, 'testTag', `Succeeded in getting verify result is: ${result.valueOf()}`);
             // 使用结果判断验密是否通过，执行后续流程
           })
           .catch((error: BusinessError<Object>) => {
             this.dealVerifyAllError(error);
           });
       } else {
         hilog.info(0x0000, 'testTag',
           'The current device environment does not support the youth mode, please check the current device environment.');
       }
     } catch (error) {
       hilog.error(0x0000, 'testTag',
         `Failed to invoke supportMinorsMode. errCode: ${error.code}, errMessage: ${error.message}`);
     }
   } else {
     hilog.info(0x0000, 'testTag',
       'The current device does not support the invoking of the verifyMinorsProtectionCredential interface.');
   }

   dealVerifyAllError(error: BusinessError<Object>): void {
     hilog.error(0x0000, 'testTag', `Failed to verify. Code: ${error.code}, message: ${error.message}`);
   }