420f409f创建于 2025年5月16日历史提交

使用约束管控系统账号(仅对系统应用开放)

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

约束列表

预定义的账号约束条件,可以参考 :系统账号约束列表

开发准备

  1. 申请权限:ohos.permission.MANAGE_LOCAL_ACCOUNTS。申请流程请参考:申请应用权限

  2. 导入系统账号模块。

    import { osAccount } from '@kit.BasicServicesKit';
    
  3. 获取系统账号的单实例对象。

    let accountManager = osAccount.getAccountManager();
    

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

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

具体开发实例如下:

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

    let localId: number = 100;
    let constraint: string[] = [ 'constraint.wifi.set' ];
    
  2. 调用setOsAccountConstraints接口,使能系统账号100的约束。

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

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

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

具体开发实例如下:

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

    let localId: number = 100;
    let constraint: string = 'constraint.wifi.set';
    
  2. 调用isOsAccountConstraintEnabled接口,判断指定约束是否使能。

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