harmony 鸿蒙使用约束管控系统账号（仅对系统应用开放）

2025-06-12
浏览 (4)

使用约束管控系统账号（仅对系统应用开放）

账号管理模块提供了基于角色的访问控制机制，用户可以为系统账号设置约束，以限制目标账号的行为。

约束列表

预定义的账号约束条件，可以参考：系统账号约束列表。

开发准备

申请权限：ohos.permission.MANAGE_LOCAL_ACCOUNTS。申请流程请参考：申请应用权限。
导入系统账号模块。

   import { osAccount } from '@kit.BasicServicesKit';

获取系统账号的单实例对象。

   let accountManager = osAccount.getAccountManager();

设置指定系统账号的约束列表

设备所有者可以给指定系统账号设置约束，以限制该账号的行为。例如在家长模式下，家长可能禁止儿童打开WIFI、安装应用等。

具体开发实例如下：

指定系统账号标识和待使能的约束集合。

   let localId: number = 100;
   let constraint: string[] = [ 'constraint.wifi.set' ];

调用setOsAccountConstraints接口，使能系统账号100的约束。

   try {
     accountManager.setOsAccountConstraints(localId, constraint, true);
     console.log('setOsAccountConstraints successfully');
   } catch (err) {
     console.error('setOsAccountConstraints failed, error: ' + JSON.stringify(err));
   }

判断目标系统账号的指定约束是否使能

业务应用需要判断目标系统账号的指定约束是否使能，以此来决策是否对目标系统账号的行为做管控。开发者可以使用isOsAccountConstraintEnabled接口完成此操作。

具体开发实例如下：

指定系统账号标识和约束名称。

   let localId: number = 100;
   let constraint: string = 'constraint.wifi.set';

调用isOsAccountConstraintEnabled接口，判断指定约束是否使能。

   accountManager.isOsAccountConstraintEnabled(localId, constraint).then((isEnabled: boolean) => {
     if (isEnabled) {
        // your business logic
     }
   });