为保护未成年人的上网环境，预防未成年人沉迷网络，帮助未成年人培养积极健康的用网习惯，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}`);}
复制代码
了解更多详情>>
获取未成年人模式服务开发指导文档
评论