为保护未成年人的上网环境，预防未成年人沉迷网络，帮助未成年人培养积极健康的用网习惯，HarmonyOS SDK 提供未成年人模式功能，在华为设备上加强对面向未成年人的产品和服务的管理。
场景介绍（应用跟随系统未成年人模式状态变化）
1.查询系统状态：建议应用跟随系统未成年人模式状态切换，随系统一同开启或关闭未成年人模式。应用启动时可以查询系统的未成年人模式是否开启。未成年人模式开启时，应用应主动切换为未成年人模式。
2.感知系统状态切换：应用可通过订阅公共事件感知未成年人模式状态变化，应用进程存在时，如果用户切换系统的未成年人模式状态（开启或关闭），应用可主动跟随系统进行切换。
3.验证家长密码：当用户在调整应用内未成年人模式设置（如内容偏好等）时，应用可调用验证未成年人模式密码接口，让用户验证未成年人模式的家长密码，验证成功后可以进行调整。
开发步骤
1.准备：导入minorsProtection模块及相关公共模块。
import { minorsProtection } from '@kit.AccountKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { BusinessError, commonEventManager } from '@kit.BasicServicesKit';
// 以上引入的模块为当前场景的全量模块，请按照具体实现按需引入
2.感知系统状态切换：创建订阅者，订阅系统未成年人模式开启/关闭事件。推荐在应用Ability的onCreate生命周期中调用。
//订阅者信息。
let subscribeInfo: commonEventManager.CommonEventSubscribeInfo = {
events: [commonEventManager.Support.COMMON_EVENT_MINORSMODE_ON,commonEventManager.Support.COMMON_EVENT_MINORSMODE_OFF]
};
let subscriber: commonEventManager.CommonEventSubscriber;
//创建订阅者。
commonEventManager.createSubscriber(subscribeInfo)
.then((commonEventSubscriber: commonEventManager.CommonEventSubscriber) => {
subscriber = commonEventSubscriber;
//订阅公共事件。
commonEventManager.subscribe(subscriber,
(error: BusinessError, data: commonEventManager.CommonEventData) => {
if (error) {
this.dealCommonEventAllError(error);
} else {
if (data.event === commonEventManager.Support.COMMON_EVENT_MINORSMODE_ON) {
// 订阅到开启事件，可以调用查询年龄段接口
}
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.查询系统状态：开发者可选择以下一种方式获取未成年人模式的开启状态，以及年龄段信息。推荐在自定义组件的aboutToAppear生命周期或者应用Ability的onCreate生命周期中调用。
当应用期望立即获取结果时，推荐使用同步方式；当应用期望使用非阻塞的方式调用接口时，推荐使用Promise异步回调方式。
使用同步方式，调用getMinorsProtectionInfoSync获取未成年人模式的开启状态，以及年龄段信息。
if (canIUse('SystemCapability.AuthenticationServices.HuaweiID.MinorsProtection')) {
const minorsProtectionInfo: minorsProtection.MinorsProtectionInfo =
minorsProtection.getMinorsProtectionInfoSync();
// 获取未成年人模式开启状态
const minorsProtectionMode: boolean = minorsProtectionInfo.minorsProtectionMode;
hilog.info(0x0000, 'testTag', 'Succeeded in getting minorsProtectionMode is: %{public}s',
minorsProtectionMode.valueOf());
// 未成年人模式已开启，获取年龄段信息
if (minorsProtectionMode) {
const ageGroup: minorsProtection.AgeGroup | undefined = minorsProtectionInfo.ageGroup;
if (ageGroup) {
hilog.info(0x0000, 'testTag', 'Succeeded in getting lowerAge is: %{public}s', ageGroup.lowerAge.toString());
hilog.info(0x0000, 'testTag', 'Succeeded in getting upperAge is: %{public}s', ageGroup.upperAge.toString());
}
} else {
// 未成年人模式未开启，建议应用跟随系统未成年人模式,展示正常内容
}
} 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')) {
minorsProtection.getMinorsProtectionInfo()
.then((minorsProtectionInfo: minorsProtection.MinorsProtectionInfo) => {
// 获取未成年人模式开启状态
const minorsProtectionMode: boolean = minorsProtectionInfo.minorsProtectionMode;
hilog.info(0x0000, 'testTag', 'Succeeded in getting minorsProtectionMode is: %{public}s',
minorsProtectionMode.valueOf());
// 未成年人模式已开启，获取年龄段信息
if (minorsProtectionMode) {
const ageGroup: minorsProtection.AgeGroup | undefined = minorsProtectionInfo.ageGroup;
if (ageGroup) {
hilog.info(0x0000, 'testTag', 'Succeeded in getting lowerAge is: %{public}s', ageGroup.lowerAge.toString());
hilog.info(0x0000, 'testTag', 'Succeeded in getting upperAge is: %{public}s', ageGroup.upperAge.toString());
}
} else {
// 未成年人模式未开启，建议应用跟随系统未成年人模式,展示正常内容
}
})
.catch((error: BusinessError<object>) => {
this.dealGetMinorsInfoAllError(error);
});
} 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}`);
}
验证家长密码：未成年人模式开启时，如果用户需要调整应用内未成年人模式设置（如内容偏好等），可调用verifyMinorsProtectionCredential方法拉起验证未成年人模式的家长密码页面。
if (canIUse('SystemCapability.AuthenticationServices.HuaweiID.MinorsProtection')) {
minorsProtection.verifyMinorsProtectionCredential(getContext(this))
.then((result: boolean) => {
hilog.info(0x0000, 'testTag', 'Succeeded in getting verify result is: %{public}s', result.valueOf());
// 使用结果判断验密是否通过，执行后续流程
})
.catch((error: BusinessError<object>) => {
this.dealVerifyAllError(error);
});
} 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}`);
}
了解更多详情>>
获取未成年人模式服务开发指导文档
