分布式帐号管理

说明： 从API Version 7 开始支持。

导入模块

import account_distributedAccount from '@ohos.account.distributedAccount';

account_distributedAccount.getDistributedAccountAbility

getDistributedAccountAbility(): DistributedAccountAbility

获取分布式帐号单实例对象。

• 返回值：

  类型	说明
  DistributedAccountAbility	返回一个实例，实例提供查询和更新分布式帐号登录状态方法。

• 示例：

  const accountAbility = account_distributedAccount.getDistributedAccountAbility();

DistributedAccountAbility

提供查询和更新分布式帐号登录状态方法(需要先获取分布式帐号的单实例对象)。

queryOsAccountDistributedInfo

queryOsAccountDistributedInfo(callback: AsyncCallback<DistributedInfo>): void

获取分布式帐号信息，使用callback回调异步返回结果。

需要权限：ohos.permission.MANAGE_LOCAL_ACCOUNTS，该权限仅供系统应用使用。

• 参数：

  参数名	类型	必填	说明
  callback	AsyncCallback<DistributedInfo>	是	获取分布式帐号信息的回调。

• 示例：

  const accountAbility = account_distributedAccount.getDistributedAccountAbility();
  accountAbility.queryOsAccountDistributedInfo((err, data) => { 
      console.log("queryOsAccountDistributedInfo err: " + JSON.stringify(err));
      console.log('Query account info name: ' + data.name);
      console.log('Query account info id: ' + data.id);
  });

queryOsAccountDistributedInfo

queryOsAccountDistributedInfo(): Promise<DistributedInfo>

获取分布式帐号信息，使用Promise方式异步返回结果。

需要权限：ohos.permission.MANAGE_LOCAL_ACCOUNTS，该权限仅供系统应用使用。

• 返回值：

  类型	说明
  Promise<DistributedInfo>	Promise实例，用于获取异步返回结果。

• 示例：

  const accountAbility = account_distributedAccount.getDistributedAccountAbility();
  accountAbility.queryOsAccountDistributedInfo().then((data) => { 
      console.log('Query account info name: ' + data.name);
      console.log('Query account info id: ' + data.id);
  }).catch((err) => {
      console.log("queryOsAccountDistributedInfoerr: "  + JSON.stringify(err));
  });

updateOsAccountDistributedInfo

updateOsAccountDistributedInfo(accountInfo: DistributedInfo, callback: AsyncCallback<void>): void

更新分布式帐号信息，使用callback回调异步返回结果。

需要权限：ohos.permission.MANAGE_LOCAL_ACCOUNTS，该权限仅供系统应用使用。

• 参数：

  参数名	类型	必填	说明
  accountInfo	DistributedInfo	是	分布式帐号信息。
  callback	AsyncCallback<void>	是	更新分布式帐号信息的回调。

• 示例：

  const accountAbility = account_distributedAccount.getDistributedAccountAbility();
  let accountInfo = {id: '12345', name: 'ZhangSan', event: 'Ohos.account.event.LOGIN'};
  accountAbility.updateOsAccountDistributedInfo(accountInfo, (err) => { 
      console.log("queryOsAccountDistributedInfo err: " + JSON.stringify(err));
  });

updateOsAccountDistributedInfo

updateOsAccountDistributedInfo(accountInfo: DistributedInfo): Promise<void>

更新分布式帐号信息，使用Promise方式异步返回结果。

需要权限：ohos.permission.MANAGE_LOCAL_ACCOUNTS，该权限仅供系统应用使用。

• 参数：

  参数名	类型	必填	说明
  accountInfo	DistributedInfo	是	分布式帐户信息。

• 返回值：

  类型	说明
  Promise<void>	Promise实例，用于获取异步返回结果。

• 示例：

  const accountAbility = account_distributedAccount.getDistributedAccountAbility();
  let accountInfo = {id: '12345', name: 'ZhangSan', event: 'Ohos.account.event.LOGIN'};
  accountAbility.updateOsAccountDistributedInfo(accountInfo).then(() => {
      console.log('updateOsAccountDistributedInfo Success');
   }).catch((err) => {
      console.log("updateOsAccountDistributedInfo err: "  + JSON.stringify(err));
  });

DistributedInfo

提供操作系统帐户的分布式信息。