搜索历史

清空
搜索热词
      0
      • 聊天消息
      • 系统消息
      • 评论与回复
      查看更多
      查看更多
      查看更多
      VIP于 到期 续费
      登录后你可以
      • 下载海量资料
      • 学习在线课程
      • 观看技术视频
      • 写文章/发帖/加入社区
      会员中心
      创作中心
      发布
      创作活动

      完善资料让更多小伙伴认识你，还能领取20积分哦，立即完善>

      3天内不再提示

      鸿蒙开发管理：ohos.account.osAccount 系统帐号管理

      jf_46214456 • 来源：jf_46214456 • 作者：jf_46214456 • 2024-07-08 09:54 • 次阅读

      系统帐号管理

      本模块提供管理系统帐号的一些基础能力，包括系统帐号的添加、删除、查询、设置、订阅、启动等功能，提供系统帐号数据落盘的能力。

      icon-note.gif说明： 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 开发前请熟悉鸿蒙开发指导文档 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

      导入模块

      import account_osAccount from '@ohos.account.osAccount';

      account_osAccount.getAccountManager

      getAccountManager(): AccountManager

      获取系统帐号能力的实例。

      系统能力： SystemCapability.Account.OsAccount

      返回值：

      类型说明
      [AccountManager]获取系统帐号能力的实例。

      示例：

      const accountManager = account_osAccount.getAccountManager();

      OsAccountType

      枚举，系统帐号类型。

      系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount。

      参数默认值说明
      ADMIN0管理员帐号。
      NORMAL1普通帐号。
      GUEST2访客帐号。

      AccountManager

      管理系统帐号能力的类。

      activateOsAccount

      activateOsAccount(localId: number, callback: AsyncCallback): void

      激活指定系统帐号，使用callback回调异步返回结果。

      此接口为系统接口，三方应用不支持调用。

      需要权限： ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS_EXTENSION

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      localIdnumber是要激活的系统帐号ID。
      callbackAsyncCallback是回调结果。

      **示例：**激活ID为100的系统帐号

      const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.activateOsAccount(localId, (err)= >{
  console.log("activateOsAccount err:" + JSON.stringify(err));
});

      activateOsAccount

      activateOsAccount(localId: number): Promise

      激活指定系统帐号，使用Promise方式异步返回结果。

      此接口为系统接口，三方应用不支持调用。

      需要权限： ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS_EXTENSION

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      localIdnumber是要激活的系统帐号ID。

      返回值：

      类型说明
      PromisePromise实例，用于获取异步返回结果。

      **示例：**激活ID为100的系统帐号

      const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.activateOsAccount(localId).then(() = > {
  console.log("activateOsAccount success");
}).catch((err) = > {
  console.log("activateOsAccount err:" + JSON.stringify(err));
});

      isMultiOsAccountEnable

      isMultiOsAccountEnable(callback: AsyncCallback): void

      判断是否支持多系统帐号，使用callback回调异步返回结果。

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      callbackAsyncCallback是回调结果，支持多系统帐号则返回true，否则返回false。

      示例：

      const accountManager = account_osAccount.getAccountManager();
accountManager.isMultiOsAccountEnable((err, isEnabled) = > {
  console.log("isMultiOsAccountEnable err: " + JSON.stringify(err));
  console.log('isMultiOsAccountEnable isEnabled: ' + isEnabled);
});

      isMultiOsAccountEnable

      isMultiOsAccountEnable(): Promise

      判断是否支持多系统帐号，使用Promise方式异步返回结果。

      系统能力： SystemCapability.Account.OsAccount

      返回值：

      类型说明
      PromisePromise实例，用于获取异步返回结果，支持多系统帐号则返回true，否则返回false。

      示例：

      const accountManager = account_osAccount.getAccountManager();
accountManager.isMultiOsAccountEnable().then((isEnabled) = > {
  console.log('isMultiOsAccountEnable, isEnabled: ' + isEnabled);
}).catch((err) = > {
  console.log("isMultiOsAccountEnable err: "  + JSON.stringify(err));
});

      isOsAccountActived

      isOsAccountActived(localId: number, callback: AsyncCallback): void

      判断指定系统帐号是否处于激活状态，使用callback回调异步返回结果。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      localIdnumber是系统帐号ID。
      callbackAsyncCallback是回调结果，处于激活状态则返回true，否则返回false。

      **示例：**判断ID为100的系统帐号是否处于激活状态

      const accountManager = account_osAccount.getAccountManager();
var osLocalId = 100;
accountManager.isOsAccountActived(osLocalId, (err, isActive)= >{
  console.log("isOsAccountActived err:" + JSON.stringify(err));
  console.log("isOsAccountActived isActive:" + isActive);
});

      isOsAccountActived

      isOsAccountActived(localId: number): Promise

      判断指定系统帐号是否处于激活状态，使用Promise方式异步返回结果。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      localIdnumber是系统帐号ID。

      返回值：

      类型说明
      PromisePromise实例，用于获取异步返回结果，处于激活状态则返回true，否则返回false。

      **示例：**判断ID为100的系统帐号是否处于激活状态

      const accountManager = account_osAccount.getAccountManager();
var osLocalId = 100;
accountManager.isOsAccountActived(osLocalId).then((isActive) = > {
  console.log('isOsAccountActived, isActive: ' + isActive);
}).catch((err) = > {
  console.log("isOsAccountActived err: "  + JSON.stringify(err));
});

      isOsAccountConstraintEnable

      isOsAccountConstraintEnable(localId: number, constraint: string, callback: AsyncCallback): void

      判断指定系统帐号是否具有指定约束，使用callback回调异步返回结果。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      localIdnumber是指定的系统帐号ID。
      constraintstring是指定的[约束])名称。
      callbackAsyncCallback是回调结果，具有指定约束则返回true，否则返回false。

      **示例：**判断ID为100的系统帐号是否有禁止使用wifi的约束

      const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.isOsAccountConstraintEnable(localId, "constraint.wifi", (err, isConstraintEnabled)= >{
  console.log("isOsAccountConstraintEnable err:" + JSON.stringify(err));
  console.log("isOsAccountConstraintEnable isConstraintEnabled:" + isConstraintEnabled);
});

      isOsAccountConstraintEnable

      isOsAccountConstraintEnable(localId: number, constraint: string): Promise

      判断指定系统帐号是否具有指定约束，使用Promise方式异步返回结果。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      localIdnumber是指定的系统帐号ID。
      constraintstring是指定的[约束]名称。

      返回值：

      类型说明
      PromisePromise实例，用于获取异步返回结果，具有指定约束则返回true，否则返回false。

      **示例：**判断ID为100的系统帐号是否有禁止使用wifi的约束

      const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.isOsAccountConstraintEnable(localId, "constraint.wifi").then((isConstraintEnabled) = > {
  console.log('isOsAccountConstraintEnable, isConstraintEnabled: ' + isConstraintEnabled);
}).catch((err) = > {
  console.log("isOsAccountConstraintEnable err: "  + JSON.stringify(err));
});

      isTestOsAccount

      isTestOsAccount(callback: AsyncCallback): void

      检查当前系统帐号是否为测试帐号，使用callback回调异步返回结果。

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      callbackAsyncCallback是回调结果，是测试帐号则返回true，否则返回false。

      示例：

      const accountManager = account_osAccount.getAccountManager();
accountManager.isTestOsAccount((err, isTest) = > {
  console.log("isTestOsAccount err: " + JSON.stringify(err));
  console.log('isTestOsAccount isTest: ' + isTest);
});

      isTestOsAccount

      isTestOsAccount(): Promise

      检查当前系统帐号是否为测试帐号，使用Promise方式异步返回结果。

      系统能力： SystemCapability.Account.OsAccount

      返回值：

      类型说明
      PromisePromise实例，用于获取异步返回结果，是测试帐号则返回true，否则返回false。

      示例：

      const accountManager = account_osAccount.getAccountManager();
accountManager.isTestOsAccount().then((isTest) = > {
  console.log('isTestOsAccount, isTest: ' + isTest);
}).catch((err) = > {
  console.log("isTestOsAccount err: "  + JSON.stringify(err));
});

      isOsAccountVerified

      isOsAccountVerified(callback: AsyncCallback): void

      检查当前系统帐号是否已验证，使用callback回调异步返回结果。

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      callbackAsyncCallback是回调结果，已验证则返回true，否则返回false。

      示例：

      const accountManager = account_osAccount.getAccountManager();
accountManager.isOsAccountVerified((err, isVerified) = > {
  console.log("isOsAccountVerified err: " + JSON.stringify(err));
  console.log('isOsAccountVerified isVerified: ' + isVerified);
});

      isOsAccountVerified

      isOsAccountVerified(localId: number, callback: AsyncCallback): void

      检查指定系统帐号是否已验证，使用callback回调异步返回结果。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      localIdnumber否指定的系统帐号ID。
      callbackAsyncCallback是回调结果，已验证则返回true，否则返回false。

      示例：

      const accountManager = account_osAccount.getAccountManager();
accountManager.isOsAccountVerified((err, isVerified) = > {
  console.log("isOsAccountVerified err: " + JSON.stringify(err));
  console.log('isOsAccountVerified isVerified: ' + isVerified);
});

      isOsAccountVerified

      isOsAccountVerified(localId?: number): Promise

      检查指定系统帐号是否已验证，使用Promise方式异步返回结果。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      localIdnumber否指定的系统帐号ID。

      返回值：

      类型说明
      PromisePromise实例，用于获取异步返回结果，已验证则返回true，否则返回false。

      示例：

      const accountManager = account_osAccount.getAccountManager();
accountManager.isOsAccountVerified().then((isVerified) = > {
  console.log('isOsAccountVerified, isVerified: ' + isVerified);
}).catch((err) = > {
  console.log("isOsAccountVerified err: "  + JSON.stringify(err));
});

      removeOsAccount

      removeOsAccount(localId: number, callback: AsyncCallback): void

      删除指定系统帐号，使用callback回调异步返回结果。

      此接口为系统接口，三方应用不支持调用。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      localIdnumber是要删除的系统帐号ID。
      callbackAsyncCallback是回调结果。

      示例：

      const accountManager = account_osAccount.getAccountManager();
var createIocalId;
osAccountManager.createOsAccount("testAccountName", osaccount.OsAccountType.NORMAL, (err, osAccountInfo)= >{
  createIocalId = osAccountInfo.localId;
});
accountManager.removeOsAccount(createIocalId, (err)= >{
  console.log("removeOsAccount err:" + JSON.stringify(err));
});

      removeOsAccount

      removeOsAccount(localId: number): Promise

      删除指定系统帐号，使用Promise方式异步返回结果。

      此接口为系统接口，三方应用不支持调用。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      localIdnumber是要删除的系统帐号ID。

      返回值：

      类型说明
      PromisePromise实例，用于获取异步返回结果。

      示例：

      const accountManager = account_osAccount.getAccountManager();
var createIocalId;
osAccountManager.createOsAccount("testAccountName", osaccount.OsAccountType.NORMAL, (err, osAccountInfo)= >{
  createIocalId = osAccountInfo.localId;
});
createIocalId = osAccount.localId;
accountManager.removeOsAccount(createIocalId).then(() = > {
  console.log('removeOsAccount Success');
}).catch(() = > {
  console.log("removeOsAccount err: "  + JSON.stringify(err));
});

      setOsAccountConstraints

      setOsAccountConstraints(localId: number, constraints: Array, enable: boolean,callback: AsyncCallback): void

      为指定系统帐号设置/删除约束，使用callback回调异步返回结果。

      此接口为系统接口，三方应用不支持调用。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      localIdnumber是系统帐号ID。
      constraintsArray是待设置/删除的[约束]列表。
      enableboolean是设置(true)/删除(false)
      callbackAsyncCallback是回调结果。

      **示例：**给ID为100的系统帐号设置禁止使用wifi的约束

      const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.setOsAccountConstraints(localId, ["constraint.wifi"], true, (err)= >{
  console.log("setOsAccountConstraints err:" + JSON.stringify(err));
});

      setOsAccountConstraints

      setOsAccountConstraints(localId: number, constraints: Array, enable: boolean): Promise

      为指定系统帐号设置/删除约束，使用Promise方式异步返回结果。

      此接口为系统接口，三方应用不支持调用。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      localIdnumber是系统帐号ID。
      constraintsArray是待设置/删除的[约束]列表。
      enableboolean是设置(true)/删除(false)。

      返回值：

      类型说明
      PromisePromise实例，用于获取异步返回结果。

      **示例：**删除ID为100的系统帐号的禁止使用wifi的约束

      const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.setOsAccountConstraints(localId, ["constraint.location.set"], false).then(() = > {
  console.log('setOsAccountConstraints Success');
}).catch((err) = > {
  console.log("setOsAccountConstraints err: "  + JSON.stringify(err));
});

      setOsAccountName

      setOsAccountName(localId: number, localName: string, callback: AsyncCallback): void

      设置指定系统帐号的帐号名，使用callback回调异步返回结果。

      此接口为系统接口，三方应用不支持调用。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      localIdnumber是系统帐号ID。
      localNamestring是帐号名。
      callbackAsyncCallback是回调结果。

      **示例：**将ID为100的系统帐号的帐号名设置成demoName

      const accountManager = account_osAccount.getAccountManager();
var localId = 100;
var newName = "demoName";
accountManager.setOsAccountName(localId, newName, (err)= >{
  console.debug("setOsAccountName err:" + JSON.stringify(err));
});

      setOsAccountName

      setOsAccountName(localId: number, localName: string): Promise

      设置指定系统帐号的帐号名，使用Promise方式异步返回结果。

      此接口为系统接口，三方应用不支持调用。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      localIdnumber是系统帐号ID。
      localNamestring是帐号名。

      返回值：

      类型说明
      PromisePromise实例，用于获取异步返回结果。

      **示例：**将ID为100的系统帐号的帐号名设置成demoName

      const accountManager = account_osAccount.getAccountManager();
var localId = 100;
var nameLimit = "demoName";
accountManager.setOsAccountName(localId, nameLimit).then(() = > {
  console.log('setOsAccountName Success');
}).catch((err) = > {
  console.log("setOsAccountName err: "  + JSON.stringify(err));
});

      getCreatedOsAccountsCount

      getCreatedOsAccountsCount(callback: AsyncCallback): void

      获取已创建的系统帐号数量，使用callback回调异步返回结果。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      callbackAsyncCallback是回调结果，返回的是已创建的系统帐号的数量。

      示例：

      const accountManager = account_osAccount.getAccountManager();
accountManager.getCreatedOsAccountsCount((err, accountCnt)= >{
  console.log("obtains the number of all os accounts created err:" + JSON.stringify(err));
  console.log("obtains the number of all os accounts created accountCnt:" + accountCnt);
});

      getCreatedOsAccountsCount

      getCreatedOsAccountsCount(): Promise

      获取已创建的系统帐号数量，使用Promise方式异步返回结果。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      返回值：

      类型说明
      PromisePromise实例，用于获取异步返回结果，返回的是已创建的系统帐号的数量。

      示例：

      const accountManager = account_osAccount.getAccountManager();
accountManager.getCreatedOsAccountsCount().then((accountCnt) = > {
  console.log('getCreatedOsAccountsCount, accountCnt: ' + accountCnt);
}).catch((err) = > {
  console.log("getCreatedOsAccountsCount err: "  + JSON.stringify(err));
});

      getOsAccountLocalIdFromProcess

      getOsAccountLocalIdFromProcess(callback: AsyncCallback): void

      获取当前进程所属的系统帐号的帐号ID，使用callback回调异步返回结果。

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      callbackAsyncCallback是回调结果，返回的是当前进程所属的系统帐号的帐号ID。

      示例：

      const accountManager = account_osAccount.getAccountManager();
accountManager.getOsAccountLocalIdFromProcess((err, accountID) = > {
  console.log("getOsAccountLocalIdFromProcess err: " + JSON.stringify(err));
  console.log('getOsAccountLocalIdFromProcess accountID: ' + accountID);
});

      getOsAccountLocalIdFromProcess

      getOsAccountLocalIdFromProcess(): Promise

      获取当前进程所属的系统帐号的帐号ID，使用Promise方式异步返回结果。

      系统能力： SystemCapability.Account.OsAccount

      返回值：

      类型说明
      PromisePromise实例，用于获取异步返回结果，返回的是当前进程所属的系统帐号的帐号ID。

      示例：

      const accountManager = account_osAccount.getAccountManager();
accountManager.getOsAccountLocalIdFromProcess().then((accountID) = > {
  console.log('getOsAccountLocalIdFromProcess, accountID: ' + accountID);
}).catch((err) = > {
  console.log("getOsAccountLocalIdFromProcess err: "  + JSON.stringify(err));
});

      getOsAccountLocalIdFromUid

      getOsAccountLocalIdFromUid(uid: number, callback: AsyncCallback): void

      从进程uid中获取该uid所属的系统帐号的帐号ID，使用callback回调异步返回结果。

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      uidnumber是进程uid。
      callbackAsyncCallback是回调结果，返回的是uid所属的系统帐号的帐号ID。

      **示例：**查询值为12345678的uid所属的系统帐号的帐号ID

      const accountManager = account_osAccount.getAccountManager();
let uid = 12345678;
accountManager.getOsAccountLocalIdFromUid(uid, (err, accountID) = > {
  console.log("getOsAccountLocalIdFromUid err: " + JSON.stringify(err));
  console.log('getOsAccountLocalIdFromUid: ' + accountID);
});

      getOsAccountLocalIdFromUid

      getOsAccountLocalIdFromUid(uid: number): Promise

      从进程uid中获取该uid所属的系统帐号的帐号ID，使用Promise方式异步返回结果。

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      uidnumber是进程uid。

      返回值：

      类型说明
      PromisePromise实例，用于获取异步返回结果，返回的是uid所属的系统帐号的帐号ID。

      **示例：**查询值为12345678的uid所属的系统帐号的帐号ID

      const accountManager = account_osAccount.getAccountManager();
let uid = 12345678;
accountManager.getOsAccountLocalIdFromUid(uid).then((accountID) = > {
  console.log('getOsAccountLocalIdFromUid: ' + accountID);
}).catch((err) = > {
  console.log("getOsAccountLocalIdFromUid err: "  + JSON.stringify(err));
});

      getOsAccountLocalIdFromDomain8+

      getOsAccountLocalIdFromDomain(domainInfo: DomainAccountInfo, callback: AsyncCallback): void

      根据域帐号信息，获取与其关联的系统帐号的帐号ID。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      domainInfo[DomainAccountInfo]是域帐号信息。
      callbackAsyncCallback是回调结果，返回的是和域帐号关联的系统帐号ID。

      示例：

      var domainInfo = {domain: "testDomain", accountName: "testAccountName"};
const accountManager = account_osAccount.getAccountManager();
accountManager.getOsAccountLocalIdFromDomain(domainInfo, (err, accountID) = > {
  console.log("getOsAccountLocalIdFromDomain: " + JSON.stringify(err));
  console.log('getOsAccountLocalIdFromDomain: ' + accountID);
});

      getOsAccountLocalIdFromDomain8+

      getOsAccountLocalIdFromDomain(domainInfo: DomainAccountInfo): Promise

      根据域帐号信息，获取与其关联的系统帐号的帐号ID，使用Promise方式异步返回结果。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      domainInfo[DomainAccountInfo]是域帐号信息。

      返回值：

      类型说明
      PromisePromise实例，用于获取异步返回结果，返回的是和域帐号关联的系统帐号ID。

      示例：

      const accountManager = account_osAccount.getAccountManager();
var domainInfo = {domain: "testDomain", accountName: "testAccountName"};
accountManager.getOsAccountLocalIdFromDomain(domainInfo).then((accountID) = > {
  console.log('getOsAccountLocalIdFromDomain: ' + accountID);
}).catch((err) = > {
  console.log("getOsAccountLocalIdFromDomain err: "  + JSON.stringify(err));
});

      queryMaxOsAccountNumber

      queryMaxOsAccountNumber(callback: AsyncCallback): void

      查询允许创建的系统帐号的最大数量，使用callback回调异步返回结果。

      此接口为系统接口，三方应用不支持调用。

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      callbackAsyncCallback是回调结果，返回的是允许创建的系统帐号的最大数量。

      示例：

      const accountManager = account_osAccount.getAccountManager();
accountManager.queryMaxOsAccountNumber((err, maxCnt)= >{
  console.log("queryMaxOsAccountNumber err:" + JSON.stringify(err));
  console.log("queryMaxOsAccountNumber maxCnt:" + maxCnt);
});

      queryMaxOsAccountNumber

      queryMaxOsAccountNumber(): Promise

      查询允许创建的系统帐号的最大数量，使用Promise方式异步返回结果。

      此接口为系统接口，三方应用不支持调用。

      系统能力： SystemCapability.Account.OsAccount

      返回值：

      类型说明
      PromisePromise实例，用于获取异步返回结果，返回的是允许创建的系统帐号的最大数量。

      示例：

      const accountManager = account_osAccount.getAccountManager();
accountManager.queryMaxOsAccountNumber().then((maxCnt) = > {
  console.log('queryMaxOsAccountNumber, maxCnt: ' + maxCnt);
}).catch((err) = > {
  console.log("queryMaxOsAccountNumber err: "  + JSON.stringify(err));
});

      getOsAccountAllConstraints

      getOsAccountAllConstraints(localId: number, callback: AsyncCallback>): void

      获取指定系统帐号的全部约束，使用callback回调异步返回结果。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      localIdnumber是系统帐号ID。
      callbackAsyncCallback>是回调结果，返回的是该系统帐号的全部[约束]。

      **示例：**获取ID为100的系统帐号的全部约束

      const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.getOsAccountAllConstraints(localId, (err, constraints)= >{
  console.log("getOsAccountAllConstraints err:" + JSON.stringify(err));
  console.log("getOsAccountAllConstraints:" + JSON.stringify(constraints));
});

      getOsAccountAllConstraints

      getOsAccountAllConstraints(localId: number): Promise>

      获取指定系统帐号的全部约束，使用Promise方式异步返回结果。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      localIdnumber是系统帐号ID。

      返回值：

      类型说明
      Promise>Promise实例，用于获取异步返回结果，返回的是该系统帐号的全部[约束]。

      **示例：**获取ID为100的系统帐号的全部约束

      const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.getOsAccountAllConstraints(localId).then((constraints) = > {
  console.log("getOsAccountAllConstraints, constraints: " + constraints);
}).catch((err) = > {
  console.log("getOsAccountAllConstraints err: "  + JSON.stringify(err));
});

      queryAllCreatedOsAccounts

      queryAllCreatedOsAccounts(callback: AsyncCallback>): void

      查询已创建的所有系统帐号的信息列表，使用callback回调异步返回结果。

      此接口为系统接口，三方应用不支持调用。

      系统能力： SystemCapability.Account.OsAccount

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

      参数：

      参数名类型必填说明
      callbackAsyncCallback>是回调结果，返回的是已创建的所有系统帐号的信息列表。

      示例：

      const accountManager = account_osAccount.getAccountManager();
accountManager.queryAllCreatedOsAccounts((err, accountArr)= >{
  console.log("queryAllCreatedOsAccounts err:" + JSON.stringify(err));
  console.log("queryAllCreatedOsAccounts accountArr:" + JSON.stringify(accountArr));
});

      queryAllCreatedOsAccounts

      queryAllCreatedOsAccounts(): Promise>

      查询已创建的所有系统帐号的信息列表，使用Promise方式异步返回结果。

      此接口为系统接口，三方应用不支持调用。

      系统能力： SystemCapability.Account.OsAccount

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

      返回值：

      类型说明
      Promise>Promise实例，用于获取异步返回结果，返回的是已创建的所有系统帐号的信息列表。

      示例：

      const accountManager = account_osAccount.getAccountManager();
accountManager.queryAllCreatedOsAccounts().then((accountArr) = > {
  console.log('queryAllCreatedOsAccounts, accountArr: ' + JSON.stringify(accountArr));
}).catch((err) = > {
  console.log("queryAllCreatedOsAccounts err: "  + JSON.stringify(err));
});

      queryActivatedOsAccountIds8+

      queryActivatedOsAccountIds(callback: AsyncCallback>): void

      查询当前处于激活状态的系统帐号的ID列表，使用callback回调异步返回结果。

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      callbackAsyncCallback>是回调结果，返回的是当前处于激活状态的系统帐号的ID列表。

      示例：

      const accountManager = account_osAccount.getAccountManager();
accountManager.queryActivatedOsAccountIds((err, idArray)= >{
  console.log("queryActivatedOsAccountIds err:" + JSON.stringify(err));
  console.log("queryActivatedOsAccountIds idArray length:" + idArray.length);
  for(var i=0;i< idArray.length;i++) {
    console.info("activated os account id: " + idArray[i]);
  }
});

      queryActivatedOsAccountIds8+

      queryActivatedOsAccountIds(): Promise>

      查询当前处于激活状态的系统帐号的ID列表，使用Promise方式异步返回结果。

      系统能力： SystemCapability.Account.OsAccount

      返回值：

      类型说明
      Promise>Promise实例，用于获取异步返回结果，返回的是当前处于激活状态的系统帐号的ID列表。

      示例：

      const accountManager = account_osAccount.getAccountManager();
accountManager.queryActivatedOsAccountIds().then((idArray) = > {
  console.log('queryActivatedOsAccountIds, idArray: ' + idArray);
}).catch((err) = > {
  console.log("queryActivatedOsAccountIds err: "  + JSON.stringify(err));
});

      createOsAccount

      createOsAccount(localName: string, type: OsAccountType, callback: AsyncCallback): void

      创建一个系统帐号，使用callback回调异步返回结果。

      此接口为系统接口，三方应用不支持调用。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      localNamestring是创建的系统帐号的名称。
      type[OsAccountType]是创建的系统帐号的类型。
      callbackAsyncCallback<[OsAccountInfo]>是回调结果，返回的是新创建的系统帐号的信息。

      示例：

      const accountManager = account_osAccount.getAccountManager();
accountManager.createOsAccount("testName", osaccount.OsAccountType.NORMAL, (err, osAccountInfo)= >{
  console.log("createOsAccount err:" + JSON.stringify(err));
  console.log("createOsAccount osAccountInfo:" + JSON.stringify(osAccountInfo));
});

      createOsAccount

      createOsAccount(localName: string, type: OsAccountType): Promise

      创建一个系统帐号，使用Promise方式异步返回结果。

      此接口为系统接口，三方应用不支持调用。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      localNamestring是创建的系统帐号的名称。
      type[OsAccountType]是创建的系统帐号的类型。

      返回值：

      类型说明
      Promise<[OsAccountInfo]>Promise实例，用于获取异步返回结果，返回的是新创建的系统帐号的信息。

      示例：

      const accountManager = account_osAccount.getAccountManager();
accountManager.createOsAccount("testAccountName", osaccount.OsAccountType.NORMAL).then((accountInfo) = > {
  console.log("createOsAccount, accountInfo: " + JSON.stringify(accountInfo));
}).catch((err) = > {
  console.log("createOsAccount err: "  + JSON.stringify(err));
});

      createOsAccountForDomain8+

      createOsAccountForDomain(type: OsAccountType, domainInfo: DomainAccountInfo, callback: AsyncCallback): void

      根据域帐号信息，创建一个系统帐号并将其与域帐号关联，使用callback回调异步返回结果。

      此接口为系统接口，三方应用不支持调用。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      type[OsAccountType]是创建的系统帐号的类型。
      domainInfo[DomainAccountInfo]是域帐号信息。
      callbackAsyncCallback<[OsAccountInfo]>是回调结果，返回的是新创建的系统帐号的信息。

      示例：

      const accountManager = account_osAccount.getAccountManager();
var domainInfo = {domain: "testDomain", accountName: "testAccountName"};
accountManager.createOsAccountForDomain(osaccount.OsAccountType.NORMAL, domainInfo, (err, osAccountInfo)= >{
  console.log("createOsAccountForDomain err:" + JSON.stringify(err));
  console.log("createOsAccountForDomain osAccountInfo:" + JSON.stringify(osAccountInfo));
});

      createOsAccountForDomain8+

      createOsAccountForDomain(type: OsAccountType, domainInfo: DomainAccountInfo): Promise

      根据传入的域帐号信息，创建与其关联的系统帐号，使用Promise方式异步返回结果。

      此接口为系统接口，三方应用不支持调用。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      type[OsAccountType]是创建的系统帐号的类型。
      domainInfo[DomainAccountInfo]是域帐号信息。

      返回值：

      类型说明
      Promise<[OsAccountInfo]>Promise实例，用于获取异步返回结果，返回的是新创建的系统帐号的信息。

      示例：

      const accountManager = account_osAccount.getAccountManager();
var domainInfo = {domain: "testDomain", accountName: "testAccountName"};
accountManager.createOsAccountForDomain(osaccount.OsAccountType.NORMAL, domainInfo).then((accountInfo) = > {
  console.log("createOsAccountForDomain, account info: " + JSON.stringify(accountInfo));
}).catch((err) = > {
  console.log("createOsAccountForDomain err: "  + JSON.stringify(err));
});

      queryCurrentOsAccount

      queryCurrentOsAccount(callback: AsyncCallback): void

      查询当前进程所属的系统帐号的信息，使用callback回调异步返回结果。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      callbackAsyncCallback<[OsAccountInfo]>是回调结果，返回的是当前进程所属的系统帐号信息。

      示例：

      const accountManager = account_osAccount.getAccountManager();
accountManager.queryCurrentOsAccount((err, curAccountInfo)= >{
  console.log("queryCurrentOsAccount err:" + JSON.stringify(err));
  console.log("queryCurrentOsAccount curAccountInfo:" + JSON.stringify(curAccountInfo));
});

      queryCurrentOsAccount

      queryCurrentOsAccount(): Promise

      查询当前进程所属的系统帐号的信息，使用Promise方式异步返回结果。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      返回值：

      类型说明
      Promise<[OsAccountInfo]>Promise实例，用于获取异步返回结果，返回的是当前进程所属的系统帐号信息。

      示例：

      const accountManager = account_osAccount.getAccountManager();
accountManager.queryCurrentOsAccount().then((accountInfo) = > {
  console.log("queryCurrentOsAccount, accountInfo: " + JSON.stringify(accountInfo));
}).catch((err) = > {
  console.log("queryCurrentOsAccount err: "  + JSON.stringify(err));
});

      queryOsAccountById

      queryOsAccountById(localId: number, callback: AsyncCallback): void

      查询指定系统帐号的信息，使用callback回调异步返回结果。

      此接口为系统接口，三方应用不支持调用。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS_EXTENSION

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      localIdnumber是要查询的系统帐号的ID
      callbackAsyncCallback<[OsAccountInfo]>是回调结果，返回的是查到的系统帐号的信息。

      **示例：**查询ID为100的系统帐号信息

      const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.queryOsAccountById(localId, (err, accountInfo)= >{
  console.log("queryOsAccountById err:" + JSON.stringify(err));
  console.log("queryOsAccountById accountInfo:" + JSON.stringify(accountInfo));
});

      queryOsAccountById

      queryOsAccountById(localId: number): Promise

      查询指定系统帐号的信息，使用Promise方式异步返回结果。

      此接口为系统接口，三方应用不支持调用。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS_EXTENSION

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      localIdnumber是要查询的系统帐号的ID

      返回值：

      类型说明
      Promise<[OsAccountInfo]>Promise实例，用于获取异步返回结果，返回的是查到的系统帐号的信息。

      **示例：**查询ID为100的系统帐号信息

      const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.queryOsAccountById(localId).then((accountInfo) = > {
  console.log("queryOsAccountById, accountInfo: " + JSON.stringify(accountInfo));
}).catch((err) = > {
  console.log("queryOsAccountById err: "  + JSON.stringify(err));
});

      getOsAccountTypeFromProcess

      getOsAccountTypeFromProcess(callback: AsyncCallback): void

      查询当前进程所属的系统帐号的帐号类型，使用callback回调异步返回结果。

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      callbackAsyncCallback<[OsAccountType]>是回调结果，返回的是当前进程所属的系统帐号的帐号类型。

      示例：

      const accountManager = account_osAccount.getAccountManager();
accountManager.getOsAccountTypeFromProcess((err, accountType) = > {
  console.log("getOsAccountTypeFromProcess err: " + JSON.stringify(err));
  console.log('getOsAccountTypeFromProcess accountType: ' + accountType);
});

      getOsAccountTypeFromProcess

      getOsAccountTypeFromProcess(): Promise

      查询当前进程所属的系统帐号的帐号类型，使用Promise方式异步返回结果。

      系统能力： SystemCapability.Account.OsAccount

      返回值：

      类型说明
      Promise<[OsAccountType]>Promise实例，用于获取异步返回结果，返回的是当前进程所属的系统帐号的帐号类型。

      示例：

      const accountManager = account_osAccount.getAccountManager();
accountManager.getOsAccountTypeFromProcess().then((accountType) = > {
  console.log('getOsAccountTypeFromProcess, accountType: ' + accountType);
}).catch((err) = > {
  console.log("getOsAccountTypeFromProcess err: "  + JSON.stringify(err));
});

      getDistributedVirtualDeviceId

      getDistributedVirtualDeviceId(callback: AsyncCallback): void

      获取分布式虚拟设备ID，使用callback回调异步返回结果。

      需要权限： ohos.permission.DISTRIBUTED_DATASYNC 或 ohos.permission.MANAGE_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      callbackAsyncCallback是回调结果，返回的是分布式虚拟设备ID。

      示例：

      const accountManager = account_osAccount.getAccountManager();
accountManager.getDistributedVirtualDeviceId((err, virtualID) = > {
  console.log("getDistributedVirtualDeviceId err: " + JSON.stringify(err));
  console.log('getDistributedVirtualDeviceId virtualID: ' + virtualID);
});

      getDistributedVirtualDeviceId

      getDistributedVirtualDeviceId(): Promise

      获取分布式虚拟设备ID，使用Promise方式异步返回结果。

      需要权限： ohos.permission.DISTRIBUTED_DATASYNC 或 ohos.permission.MANAGE_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      返回值：

      类型说明
      PromisePromise实例，用于获取异步返回结果，返回的是分布式虚拟设备ID。

      示例：

      const accountManager = account_osAccount.getAccountManager();
accountManager.getDistributedVirtualDeviceId().then((virtualID) = > {
  console.log('getDistributedVirtualDeviceId, virtualID: ' + virtualID);
}).catch((err) = > {
  console.log("getDistributedVirtualDeviceId err: "  + JSON.stringify(err));
});

      getOsAccountProfilePhoto

      getOsAccountProfilePhoto(localId: number, callback: AsyncCallback): void

      获取指定系统帐号的头像信息，使用callback回调异步返回结果。

      此接口为系统接口，三方应用不支持调用。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      localIdnumber是系统帐号ID。
      callbackAsyncCallback是回调结果，返回的是该系统帐号的头像信息。

      **示例：**获取ID为100的系统帐号的头像

      const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.getOsAccountProfilePhoto(localId, (err, photo)= >{
  console.log("getOsAccountProfilePhoto err:" + JSON.stringify(err));
  console.log("get photo:" + photo + " by localId: " + localId);
});

      getOsAccountProfilePhoto

      getOsAccountProfilePhoto(localId: number): Promise

      获取指定系统帐号的头像信息，使用Promise方式异步返回结果。

      此接口为系统接口，三方应用不支持调用。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      localIdnumber是系统帐号ID。

      返回值：

      类型说明
      PromisePromise实例，用于获取异步返回结果，返回的是该系统帐号的头像信息。

      **示例：**获取ID为100的系统帐号的头像

      const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.getOsAccountProfilePhoto(localId).then((photo) = > {
  console.log("getOsAccountProfilePhoto: " + photo);
}).catch((err) = > {
  console.log("getOsAccountProfilePhoto err: "  + JSON.stringify(err));
});

      setOsAccountProfilePhoto

      setOsAccountProfilePhoto(localId: number, photo: string, callback: AsyncCallback): void

      为指定系统帐号设置头像信息，使用callback回调异步返回结果。

      此接口为系统接口，三方应用不支持调用。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      localIdnumber是系统帐号ID。
      photostring是头像信息。
      callbackAsyncCallback是回调结果。

      **示例：**给ID为100的系统帐号设置头像

      const accountManager = account_osAccount.getAccountManager();
var localId = 100;
var photo = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA0AAAAPCAYAAAA/I0V3AAAAAXNSR0IArs4c6QAAAARnQU1BAA"+
"Cxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAACwSURBVDhPvZLBDYMwDEV/ugsXRjAT0EHCOuFIBwkbdIRewi6unbiAyoGgSn1SFH85+Y"+
"q/4ljARW62X+LHS8uIzjm4dXUYF+utzBikB52Jo5e5iEPKqpACk7R9NM2RvWm5tIkD2czLCUFNKLD6IjdMHFHDzws285MgGrT0xCtp3WOKHo"+
"+7q0mP0DZW9pNmoEFUzrQjp5cCnaen2kSJXLFD8ghbXyZCMQf/8e8Ns1XVAG/XAgqKzVnJFAAAAABJRU5ErkJggg=="
osAccountManager.setOsAccountProfilePhoto(localId, photo, (err)= >{
  console.log("setOsAccountProfilePhoto err:" + JSON.stringify(err));
});

      setOsAccountProfilePhoto

      setOsAccountProfilePhoto(localId: number, photo: string): Promise

      为指定系统帐号设置头像信息，使用Promise方式异步返回结果。

      此接口为系统接口，三方应用不支持调用。

      需要权限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      localIdnumber是系统帐号ID。
      photostring是头像信息。

      返回值：

      类型说明
      PromisePromise实例，用于获取异步返回结果。

      **示例：**给ID为100的系统帐号设置头像

      const accountManager = account_osAccount.getAccountManager();
var localId = 100;
var photo = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA0AAAAPCAYAAAA/I0V3AAAAAXNSR0IArs4c6QAAAARnQU1BAA"+
"Cxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAACwSURBVDhPvZLBDYMwDEV/ugsXRjAT0EHCOuFIBwkbdIRewi6unbiAyoGgSn1SFH85+Y"+
"q/4ljARW62X+LHS8uIzjm4dXUYF+utzBikB52Jo5e5iEPKqpACk7R9NM2RvWm5tIkD2czLCUFNKLD6IjdMHFHDzws285MgGrT0xCtp3WOKHo"+
"+7q0mP0DZW9pNmoEFUzrQjp5cCnaen2kSJXLFD8ghbXyZCMQf/8e8Ns1XVAG/XAgqKzVnJFAAAAABJRU5ErkJggg=="
accountManager.setOsAccountProfilePhoto(localId, photo).then(() = > {
  console.log("setOsAccountProfilePhoto success");
}).catch((err) = > {
  console.log("setOsAccountProfilePhoto err: "  + JSON.stringify(err));
});

      getOsAccountLocalIdBySerialNumber8+

      getOsAccountLocalIdBySerialNumber(serialNumber: number, callback: AsyncCallback): void

      通过SN码查询与其关联的系统帐号的帐号ID，使用callback回调异步返回结果。

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      serialNumbernumber是帐号SN码。
      callbackAsyncCallback是回调结果，返回的是与SN码关联的系统帐号的帐号ID。

      **示例：**查询与SN码12345关联的系统帐号的ID

      const accountManager = account_osAccount.getAccountManager();
var serialNumber = 12345;
accountManager.getOsAccountLocalIdBySerialNumber(serialNumber, (err, localId)= >{
  console.log("ger localId err:" + JSON.stringify(err));
  console.log("get localId:" + localId + " by serialNumber: " + serialNumber);
});

      getOsAccountLocalIdBySerialNumber8+

      getOsAccountLocalIdBySerialNumber(serialNumber: number): Promise

      通过SN码查询与其关联的系统帐号的帐号ID，使用Promise方式异步返回结果。

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      serialNumbernumber是帐号SN码。

      返回值：

      类型说明
      PromisePromise实例，用于获取异步返回结果，返回的是与SN码关联的系统帐号的帐号ID。

      **示例：**查询与SN码12345关联的系统帐号的ID

      const accountManager = account_osAccount.getAccountManager();
var serialNumber = 12345;
accountManager.getOsAccountLocalIdBySerialNumber(serialNumber).then((localId) = > {
  console.log("getOsAccountLocalIdBySerialNumber localId: " + localId);
}).catch((err) = > {
  console.log("getOsAccountLocalIdBySerialNumber err: "  + JSON.stringify(err));
});

      getSerialNumberByOsAccountLocalId8+

      getSerialNumberByOsAccountLocalId(localId: number, callback: AsyncCallback): void

      通过系统帐号ID获取与该系统帐号关联的SN码，使用callback回调异步返回结果。

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      localIdnumber是系统帐号ID。
      callbackAsyncCallback是回调结果，返回的是与该系统帐号关联的SN码。

      **示例：**获取ID为100的系统帐号关联的SN码

      const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.getSerialNumberByOsAccountLocalId(localId, (err, serialNumber)= >{
  console.log("ger serialNumber err:" + JSON.stringify(err));
  console.log("get serialNumber:" + serialNumber + " by localId: " + localId);
});

      getSerialNumberByOsAccountLocalId8+

      getSerialNumberByOsAccountLocalId(localId: number): Promise

      通过系统帐号ID获取与该系统帐号关联的SN码，使用Promise方式异步返回结果。

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      localIdnumber是系统帐号ID。

      返回值：

      类型说明
      PromisePromise实例，用于获取异步返回结果，返回的是与该系统帐号关联的SN码。

      **示例：**获取ID为100的系统帐号关联的SN码

      const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.getSerialNumberByOsAccountLocalId(localId).then((serialNumber) = > {
  console.log("getSerialNumberByOsAccountLocalId serialNumber: " + serialNumber);
}).catch((err) = > {
  console.log("getSerialNumberByOsAccountLocalId err: "  + JSON.stringify(err));
});

      on

      on(type: 'activate' | 'activating', name: string, callback: Callback): void

      订阅系统帐号的变动信息，使用callback回调异步返回结果。

      此接口为系统接口，三方应用不支持调用。

      需要权限： ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS_EXTENSION

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      type'activate''activating'是
      namestring是订阅名称，可自定义，要求非空且长度不超过1024字节。
      callbackCallback是订阅系统帐号变动信息的回调，表示当前事件对应的系统帐号ID。

      示例：

      const accountManager = account_osAccount.getAccountManager();
function onCallback(receiveLocalId){
  console.log("receive localId:" + receiveLocalId);
}
accountManager.on("activating", "osAccountOnOffNameA", onCallback);

      off

      off(type: 'activate' | 'activating', name: string, callback?: Callback): void

      取消订阅系统帐号的变动信息，使用callback回调异步返回结果。

      此接口为系统接口，三方应用不支持调用。

      需要权限： ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS_EXTENSION

      系统能力： SystemCapability.Account.OsAccount

      参数：

      参数名类型必填说明
      type'activate''activating'是
      namestring是订阅名称，可自定义，，要求非空且长度不超过1024字节，需要与订阅接口传入的值保持一致。
      callbackCallback否取消订阅系统帐号变化的回调，默认返回0。

      示例：

      const accountManager = account_osAccount.getAccountManager();
function offCallback(){
  console.log("off enter")
}
accountManager.off("activating", "osAccountOnOffNameA", offCallback);

      OsAccountInfo

      系统帐号信息。

      系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount。

      参数名类型必填说明
      localIdnumber是系统帐号ID。
      localNamestring是系统帐号名称。
      type[OsAccountType]是系统帐号类型
      constraintsArray否系统帐号[约束]
      isVerified8+boolean是帐号是否锁屏
      photo8+string否系统帐号头像
      createTime8+number是系统帐号创建时间
      lastLoginTime8+number否系统帐号最后一次登录时间
      serialNumber8+number是系统帐号SN码
      isActived8+boolean是系统帐号激活状态
      isCreateCompleted8+boolean是系统帐号创建是否完整
      distributedInfo[distributedAccount.DistributedInfo]否分布式帐号信息
      domainInfo8+[DomainAccountInfo]否域帐号信息

      DomainAccountInfo8+

      域帐号信息。

      系统能力： 以下各项对应的系统能力均为SystemCapability.Account.OsAccount。

      参数名类型必填说明
      domainstring是域名。
      accountNamestring是域帐号名。HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿

      QQ截图20240705210937.png

      系统帐号约束列表

      约束说明
      constraint.wifi禁止使用wifi
      constraint.wifi.set禁止配置wifi
      constraint.locale.set禁止配置设备语言
      constraint.app.accounts禁止添加和删除应用帐号
      constraint.apps.install禁止安装应用
      constraint.apps.uninstall禁止卸载应用
      constraint.location.shared禁止打开位置共享
      constraint.unknown.sources.install禁止安装未知来源的应用
      constraint.global.unknown.app.install禁止所有用户安装未知来源的应用
      constraint.bluetooth.set禁止配置蓝牙
      constraint.bluetooth禁止使用蓝牙
      constraint.bluetooth.share禁止共享使用蓝牙
      constraint.usb.file.transfer禁止通过USB传输文件
      constraint.credentials.set禁止配置用户凭据
      constraint.os.account.remove禁止删除用户
      constraint.managed.profile.remove禁止删除此用户的托管配置文件
      constraint.debug.features.useJ禁止启用或访问调试功能
      constraint.vpn.set禁止配置VPN
      constraint.date.time.set禁止配置日期时间和时区
      constraint.tethering.config禁止配置Tethering
      constraint.network.reset禁止重置网络设置
      constraint.factory.reset禁止出厂设置
      constraint.os.account.create禁止创建新用户
      constraint.add.managed.profile禁止添加托管配置文件
      constraint.apps.verify.disable强制应用程序验证
      constraint.cell.oadcasts.set禁止配置小区广播
      constraint.mobile.networks.set禁止配置移动网络
      constraint.control.apps禁止在设置或启动模块中修改应用程序
      constraint.physical.media禁止装载物理外部介质
      constraint.microphone禁止使用麦克风
      constraint.microphone.unmute禁止取消麦克风静音
      constraint.volume.adjust禁止调整音量
      constraint.calls.outgoing禁止拨打外呼电话
      constraint.sms.use禁止发送或接收短信
      constraint.fun禁止享受乐趣
      constraint.windows.create禁止创建应用程序窗口以外的窗口
      constraint.system.error.dialogs禁止显示崩溃或无响应应用程序的系统错误对话框
      constraint.cross.profile.copy.paste禁止通过将数据粘贴到其他用户或配置文件来导出剪贴板内容
      constraint.beam.outgoing禁止使用NFC从应用程序传送数据
      constraint.wallpaper禁止管理壁纸
      constraint.safe.boot禁止进入安全引导模式
      constraint.parent.profile.app.linking允许父配置文件中的应用程序处理来自托管配置文件的Web链接
      constraint.audio.record禁止录制音频
      constraint.camera.use禁止使用摄像机
      constraint.os.account.background.run禁止在后台运行
      constraint.data.roam禁止漫游通话时使用蜂窝数据
      constraint.os.account.set.icon禁止修改用户头像
      constraint.wallpaper.set禁止设置壁纸
      constraint.oem.unlock禁止启用oem解锁
      constraint.device.unmute禁止取消设备静音
      constraint.password.unified禁止托管配置文件与主用户进行统一锁屏质询
      constraint.autofill禁止使用自动填充服务
      constraint.content.capture禁止捕获用户屏幕
      constraint.content.suggestions禁止接收内容建议
      constraint.os.account.start禁止切换用户
      constraint.location.set禁止配置位置服务
      constraint.airplane.mode.set禁止飞行模式
      constraint.ightness.set禁止配置亮度
      constraint.share.into.profile禁止将主要用户的文件/图片/数据共享到托管配置文件中
      constraint.ambient.display禁止显示环境
      constraint.screen.timeout.set禁止配置屏幕关闭的超时
      constraint.print禁止打印
      constraint.private.dns.set禁止配置专用DNS

      审核编辑 黄宇

      声明：本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人，不代表电子发烧友网立场。文章及其配图仅供工程师学习之用，如有内容侵权或者其他违规问题，请联系本站处理。 举报投诉
      • 鸿蒙
        鸿蒙
        +关注

        关注

        56

        文章

        2267

        浏览量

        42480
      收藏 人收藏

        评论

        相关推荐

        鸿蒙OS开发：【一次开发，多端部署】（资源管理器）解析

        ，使用[@ohos.resourceManager.d.ts] 中的接口，展示了格式化字符串查询、基于指定屏幕分辨率查询媒体资源、获取系统资源管理对象等基础功能，以及展示了资源静态overlay以及运行时overlay的特性功能。
        的头像 发表于 05-21 15:59 •850次阅读
        <b class='flag-5'>鸿蒙</b>OS<b class='flag-5'>开发</b>：【一次<b class='flag-5'>开发</b>，多端部署】（资源<b class='flag-5'>管理</b>器）解析

        鸿蒙开发接口媒体：【@ohos.multimedia.audio (音频管理)】

        音频管理提供管理音频的一些基础能力，包括对音频音量、音频设备的管理，以及对音频数据的采集和渲染等。
        的头像 发表于 05-31 09:53 •1820次阅读
        <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b>接口媒体：【@<b class='flag-5'>ohos</b>.multimedia.audio (音频<b class='flag-5'>管理</b>)】

        鸿蒙实战项目开发：【短信服务】

        数据管理 电话服务 分布式应用开发 通知与窗口管理 多媒体技术 安全技能 任务管理 WebGL 国际化开发 应用测试 DFX面向未来设计
        发表于 03-03 21:29

        鸿蒙原生应用开发-网络管理模块总述

        进行数据传输。 二、约束与限制 使用网络管理模块的相关功能时，需要请求相应的权限。 三、具体权限名与说明 ohos.permission.GET_NETWORK_INFO获取网络连接信息
        发表于 04-08 09:45

        《鸿蒙设备学习菜鸟指南》之 【五、搭建开发环境】

        全套开发环境• Linux系统：同上 开发环境建立后，我们要做的第一件事情，就是在建立一个目录，名字叫做OHOS，后面我们的开发文件，都放在
        发表于 10-30 13:59

        sdk5鸿蒙利用文件管理器获取文件Uri的过程

        )); } 捕捉（异常e）{系统。出.println(e.toString()); }}} }}文件最大可以选择500个，它返回的uri好像是安卓的uri，所以需要转换成鸿蒙的，这样子就到了看路径的形式，他应该是把文件弄到了文件管理
        发表于 04-27 11:03

        鸿蒙开发实战：【文件管理】

        文件管理相关的功能，使用[@ohos.multimedia.medialibrary]、[@ohos.filemanagement.userFileManager] 、[@ohos
        的头像 发表于 03-20 21:57 •506次阅读
        <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b>实战：【文件<b class='flag-5'>管理</b>】

        HarmonyOS开发实例：【app帐号管理】

        本示例选择应用进行注册/登录，并设置帐号相关信息，简要说明应用帐号管理相关功能。
        的头像 发表于 04-14 09:46 •309次阅读
        HarmonyOS<b class='flag-5'>开发</b>实例：【app<b class='flag-5'>帐号</b><b class='flag-5'>管理</b>】

        鸿蒙开发接口安全：【@ohos.abilityAccessCtrl (访问控制管理)】

        访问控制管理：获取访问控制模块对象。
        的头像 发表于 06-05 09:16 •445次阅读
        <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b>接口安全：【@<b class='flag-5'>ohos</b>.abilityAccessCtrl (访问控制<b class='flag-5'>管理</b>)】

        鸿蒙开发文件管理：【@ohos.fileio (文件管理)】

        该模块提供文件存储管理能力，包括文件基本管理、文件目录管理、文件信息统计、文件流式读写等常用功能。
        的头像 发表于 06-12 18:12 •892次阅读
        <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b>文件<b class='flag-5'>管理</b>：【@<b class='flag-5'>ohos</b>.fileio (文件<b class='flag-5'>管理</b>)】

        鸿蒙开发系统基础能力：ohos.screenLock 锁屏管理

        锁屏管理服务是OpenHarmony中系统服务，为锁屏应用提供注册亮屏、灭屏、开启屏幕、结束休眠、退出动画、请求解锁结果监听，并提供回调结果给锁屏应用。锁屏管理服务向三方应用提供请求解锁、查询锁屏状态、查询是否设置锁屏密码的能力
        的头像 发表于 06-27 11:41 •452次阅读
        <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b><b class='flag-5'>系统</b>基础能力：<b class='flag-5'>ohos</b>.screenLock 锁屏<b class='flag-5'>管理</b>

        鸿蒙开发设备管理：ohos.thermal 热管理

        该模块提供热管理相关的接口，包括热档位查询及注册回调等功能。
        的头像 发表于 07-05 09:53 •167次阅读
        <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b>设备<b class='flag-5'>管理</b>：<b class='flag-5'>ohos</b>.thermal 热<b class='flag-5'>管理</b>

        鸿蒙开发设备管理：ohos.usb USB管理

        本模块主要提供管理USB设备的相关功能，包括查询USB设备列表、批量数据传输、控制命令传输、权限控制等。
        的头像 发表于 07-05 17:34 •425次阅读
        <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b>设备<b class='flag-5'>管理</b>：<b class='flag-5'>ohos</b>.usb USB<b class='flag-5'>管理</b>

        鸿蒙开发设备管理：ohos.account.appAccount 应用帐号管理

        应用帐号管理：获取应用帐号模块对象。
        的头像 发表于 07-06 10:43 •547次阅读
        <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b>设备<b class='flag-5'>管理</b>：<b class='flag-5'>ohos.account</b>.appAccount 应用<b class='flag-5'>帐号</b><b class='flag-5'>管理</b>

        鸿蒙开发管理：ohos.account.distributedAccount 分布式帐号管理

        获取分布式帐号单实例对象。
        的头像 发表于 07-08 10:03 •163次阅读
        <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b><b class='flag-5'>管理</b>：<b class='flag-5'>ohos.account</b>.distributedAccount 分布式<b class='flag-5'>帐号</b><b class='flag-5'>管理</b>
        华秋（原“华强聚丰”）：
        电子发烧友
        华秋开发
        华秋电路(原"华强PCB")
        华秋商城(原"华强芯城")
        华秋智造
        My ElecFans
        APP
        网站地图
        设计技术
        可编程逻辑
        电源/新能源
        MEMS/传感技术
        测量仪表
        嵌入式技术
        制造/封装
        模拟技术
        RF/无线
        接口/总线/驱动
        处理器/DSP
        EDA/IC设计
        存储技术
        光电显示
        EMC/EMI设计
        连接器
        行业应用
        LEDs
        汽车电子
        音视频及家电
        通信网络
        医疗电子
        人工智能
        虚拟现实
        可穿戴设备
        机器人
        安全设备/系统
        军用/航空电子
        移动通信
        工业控制
        便携设备
        触控感测
        物联网
        智能电网
        区块链
        新科技
        特色内容
        专栏推荐
        学院
        设计资源
        设计技术
        电子百科
        电子视频
        元器件知识
        工具箱
        VIP会员
        最新技术文章
        社区
        小组
        论坛
        问答
        评测试用
        企业服务
        产品
        资料
        文章
        方案
        企业
        供应链服务
        硬件开发
        华秋电路
        华秋商城
        华秋智造
        nextPCB
        BOM配单
        媒体服务
        网站广告
        在线研讨会
        活动策划
        新闻发布
        新品发布
        小测验
        设计大赛
        华秋
        关于我们
        投资关系
        新闻动态
        加入我们
        联系我们
        举报投诉
        社交网络
        微博
        移动端
        发烧友APP
        硬声APP
        WAP
        联系我们
        广告合作
        王婉珠：wangwanzhu@elecfans.com
        内容合作
        黄晶晶：huangjingjing@elecfans.com
        内容合作（海外）
        张迎辉：mikezhang@elecfans.com
        供应链服务 PCB/IC/PCBA
        江良华：lanhu@huaqiu.com
        投资合作
        曾海银：zenghaiyin@huaqiu.com
        社区合作
        刘勇：liuyong@huaqiu.com

        • 关注我们的微信

          关注我们的微信

        • 下载发烧友APP

          下载发烧友APP

        • 电子发烧友观察

          电子发烧友观察
        华秋发烧友
        电子工程师社区
        华秋电路
        1-32层PCB打样·中小批量
        华秋商城
        元器件现货·全球代购·SmartBOM
        华秋智造
        SMT贴片·PCBA加工
        NextPCB
        PCB Manufacturer

        版权所有 © 湖南华秋数字科技有限公司

        长沙市望城经济技术开发区航空路6号手机智能终端产业园2号厂房3层（0731-88081133）

        电子发烧友 （电路图） 湘公网安备43011202000918 工商网监认证工商网监 湘ICP备2023018690号-1