前端低代码开发_网站手机端设计_百度宣传推广费用_快速学电脑培训班

为保护未成年人的上网环境，预防未成年人沉迷网络，帮助未成年人培养积极健康的用网习惯，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) =&gt; {// 获取未成年人模式开启状态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>) =&gt; {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) =&gt; {hilog.info(0x0000, 'testTag', 'Succeeded in getting verify result is: %{public}s', result.valueOf());// 使用结果判断验密是否通过，执行后续流程}).catch((error: BusinessError<object>) =&gt; {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}`);
}

了解更多详情>>

获取未成年人模式服务开发指导文档