应用内开启/关闭系统未成年人模式-未成年人模式-Account Kit（华为账号服务）-应用服务

场景介绍

应用可以查询系统的未成年人模式信息。
1. 应用可在刚启动时订阅公共事件感知未成年人模式的状态变化。
2. 应用可查询系统的未成年人模式是否开启。
应用可在本应用内增加引导开启/关闭系统未成年人模式的入口。
1. 当应用需要展示关闭未成年人模式页面时，则应用调用leadToTurnOffMinorsMode引导用户关闭未成年人模式。
2. 当应用需要展示开启未成年人模式页面时，则应用调用leadToTurnOnMinorsMode引导用户开启未成年人模式。
同时开发者需要注意以下场景：
1. 当应用跟随系统切换未成年人模式状态时，开发者需关注应用后台行为是否需要中断，例如是否需要中断后台播放的音视频内容等，避免未成年人绕过限制，继续访问非适龄内容。
2. 当应用处于前台时，用户可通过下拉控制中心，点击未成年人模式开关，开启系统的未成年人模式。开发者需关注此场景下，应用仍处于前台时的内容刷新时机。

说明

开启未成年人模式需要设置密码，家长在关闭未成年人模式或调整应用内未成年人模式设置（如内容偏好、使用时长等）时需要验证该密码，避免未成年人绕过相关限制。
建议先调用canIUse接口和supportMinorsMode接口来判断当前设备环境是否支持未成年人模式，否则在不支持的设备环境上调用未成年人模式相关接口，会造成程序崩溃。
1. 调用canIUse接口需要传入参数为未成年人模式的syscap：SystemCapability.AuthenticationServices.HuaweiID.MinorsProtection，在设备类型为phone或tablet上会返回true，其他设备类型返回false。
2. 当登录海外华为账号或用户空间为隐私空间时调用supportMinorsMode接口均会返回false，其他场景均为true。
3. 当canIUse接口和supportMinorsMode接口返回为true时，表明该设备支持系统的未成年人模式，应用可通过本章节描述的相关能力，与系统进行未成年人模式的联动。
4. 当canIUse接口或supportMinorsMode接口返回为false时，表明该设备暂未支持系统的未成年人模式以及相关联动能力，应用需构建自己的未成年人模式或关闭应用的未成年人模式入口。
以上图片为该场景的界面流程图，部分界面可能与实际界面存在差异，请以实际界面为准。

业务流程

流程说明：

用户打开应用时，应用通过订阅公共事件感知未成年人模式的状态变化。可以调用getMinorsProtectionInfoSync或getMinorsProtectionInfo获取系统未成年人模式信息。
当系统未成年人模式已开启，且用户需要在应用内关闭未成年人模式时，应用需要调用leadToTurnOffMinorsMode引导用户关闭未成年人模式，当应用订阅到未成年人模式关闭事件，调整应用展示内容不做限制。
当系统未成年人模式未开启，且用户需要在应用内开启未成年人模式时，应用需要调用leadToTurnOnMinorsMode引导用户开启未成年人模式，当应用订阅到未成年人模式开启事件，调用getMinorsProtectionInfoSync或getMinorsProtectionInfo获取系统未成年人模式年龄段信息，根据年龄段信息进行内容分级。当用户需要调整应用内未成年人模式设置（如内容偏好等）时调用验证未成年人模式密码接口，验证成功后才能进行调整。

接口说明

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

展开

接口名	描述
leadToTurnOnMinorsMode(context: common.Context): Promise<void>	调用该方法进行开启未成年人模式流程。
leadToTurnOffMinorsMode(context: common.Context): Promise<void>	调用该方法进行关闭未成年人模式流程。
getMinorsProtectionInfoSync(): MinorsProtectionInfo	同步接口，获取未成年人模式的开启状态，以及年龄段信息。
getMinorsProtectionInfo(): Promise<MinorsProtectionInfo>	异步接口，获取未成年人模式的开启状态，以及年龄段信息。
verifyMinorsProtectionCredential(context: common.Context): Promise<boolean>	调用该方法拉起验证未成年人模式密码页面。

注意

leadToTurnOnMinorsMode接口不支持海外账号开启未成年人模式，在开启过程中登录海外账号会返回错误码1009900007。
verifyMinorsProtectionCredential、leadToTurnOnMinorsMode、leadToTurnOffMinorsMode接口需在页面或自定义组件生命周期内调用。
verifyMinorsProtectionCredential接口调用前提是未成年人模式已开启，如果在未开启未成年人模式时调用此接口会返回错误码1009900002。
当未成年人模式开启时，当前设备的开发者调试模式会被禁用，开发者可以进入设置-系统-开发者选项，点击USB调试开关，会校验健康使用设备密码，校验成功后可解除开发者调试模式限制。
如开发者重新开启USB调试开关后，发现DevEco Studio工具上hilog日志未恢复到断连之前，请执行“hdc shell hilog -G 16M”来扩大hilog日志缓存区，若hilog日志仍无法完全展示，可取出hilog日志本地查看。更多命令请参见hilog。
在应用内调用开启/关闭系统未成年人模式接口，如应用需弹出toast或弹框告知用户“未成年人模式已开启/关闭”，须在接口执行完成之后，在接口的then方法里面弹出toast或弹框，否则可能出现因系统页面未完全关闭，导致toast无法正常展示的情况。
如开发者有频繁使用到未成年人模式开启状态或者年龄段的场景，建议开发者在获取到该结果后做缓存，然后通过订阅未成年人模式公共事件来刷新未成年人模式开启状态或者年龄段，避免重复调用接口，增加时延。
当设备处于开机未解锁状态下，开发者调用getMinorsProtectionInfoSync接口会返回false。

事件说明

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

展开

事件名称	值	描述
COMMON_EVENT_MINORSMODE_ON	usual.event.MINORSMODE_ON	表示未成年人模式开启动作。
COMMON_EVENT_MINORSMODE_OFF	usual.event.MINORSMODE_OFF	表示未成年人模式关闭动作。

开发步骤

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

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

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

创建订阅者，订阅系统未成年人模式开启/关闭事件。推荐在应用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}`);
}

选择以下一种方式获取未成年人模式的开启状态，以及年龄段信息。当应用期望立即获取结果，推荐使用同步方式，当应用期望使用非阻塞的方式调用接口，推荐使用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}`);
}

当系统未成年人模式已开启，且用户主动关闭应用内未成年人模式时，应用需要调用leadToTurnOffMinorsMode引导用户关闭未成年人模式。

if (canIUse('SystemCapability.AuthenticationServices.HuaweiID.MinorsProtection')) {
  try {
    if (minorsProtection.supportMinorsMode()) {
      minorsProtection.leadToTurnOffMinorsMode(getContext(this))
        .then(() => {
          // 接口调用完成，如需显示弹窗，请在此处处理
        })
        .catch((error: BusinessError<Object>) => {
          this.dealTurnOffAllError(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 leadToTurnOffMinorsMode interface.');
}

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

当系统未成年人模式未开启，且用户主动开启应用内未成年人模式时，应用需要调用leadToTurnOnMinorsMode引导用户开启未成年人模式。开启未成年人模式后，应用会订阅到未成年人模式开启事件，开发者可调用getMinorsProtectionInfoSync或getMinorsProtectionInfo获取系统未成年人模式年龄段信息，根据年龄段信息进行内容分级，详细的订阅步骤可参考开发步骤第2步。

if (canIUse('SystemCapability.AuthenticationServices.HuaweiID.MinorsProtection')) {
  try {
    if (minorsProtection.supportMinorsMode()) {
      minorsProtection.leadToTurnOnMinorsMode(getContext(this))
        .then(() => {
          // 接口调用完成，如需显示弹窗，请在此处处理
        })
        .catch((error: BusinessError<Object>) => {
          this.dealTurnOnAllError(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 leadToTurnOnMinorsMode interface.');
}

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

当未成年人模式已开启，用户需要调整应用内未成年人模式设置（如内容偏好等）时调用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}`);
}