分布式帳號(hào)管理

本模塊提供管理分布式帳號(hào)的一些基礎(chǔ)功能，主要包括查詢和更新帳號(hào)登錄狀態(tài)。

說明： 本模塊首批接口從API version 7開始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。 開發(fā)前請(qǐng)熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

導(dǎo)入模塊

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

account_distributedAccount.getDistributedAccountAbility

getDistributedAccountAbility(): DistributedAccountAbility

獲取分布式帳號(hào)單實(shí)例對(duì)象。

系統(tǒng)能力： SystemCapability.Account.OsAccount

• 返回值：

  類型	說明
  [DistributedAccountAbility]	返回一個(gè)實(shí)例，實(shí)例提供查詢和更新分布式帳號(hào)登錄狀態(tài)方法。

• 示例：

  const accountAbility = account_distributedAccount.getDistributedAccountAbility();
  

DistributedAccountAbility

提供查詢和更新分布式帳號(hào)登錄狀態(tài)方法(需要先獲取分布式帳號(hào)的單實(shí)例對(duì)象)。

queryOsAccountDistributedInfo

queryOsAccountDistributedInfo(callback: AsyncCallback): void

獲取分布式帳號(hào)信息，使用callback回調(diào)異步返回結(jié)果。

系統(tǒng)能力： SystemCapability.Account.OsAccount

需要權(quán)限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.DISTRIBUTED_DATASYNC，該權(quán)限僅供系統(tǒng)應(yīng)用使用。

• 參數(shù)：

  參數(shù)名	類型	必填	說明
  callback	AsyncCallback<[DistributedInfo]>	是	獲取分布式帳號(hào)信息的回調(diào)。

• 示例：

  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

獲取分布式帳號(hào)信息，使用Promise方式異步返回結(jié)果。

系統(tǒng)能力： SystemCapability.Account.OsAccount

需要權(quán)限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.DISTRIBUTED_DATASYNC，該權(quán)限僅供系統(tǒng)應(yīng)用使用。

• 返回值：

  類型	說明
  Promise<[DistributedInfo]>	Promise實(shí)例，用于獲取異步返回結(jié)果。

• 示例：

  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

更新分布式帳號(hào)信息，使用callback回調(diào)異步返回結(jié)果。

系統(tǒng)能力： SystemCapability.Account.OsAccount

需要權(quán)限： ohos.permission.MANAGE_LOCAL_ACCOUNTS，該權(quán)限僅供系統(tǒng)應(yīng)用使用。

• 參數(shù)：

  參數(shù)名	類型	必填	說明
  accountInfo	[DistributedInfo]	是	分布式帳號(hào)信息。
  callback	AsyncCallback	是	更新分布式帳號(hào)信息的回調(diào)。

• 示例：

  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

更新分布式帳號(hào)信息，使用Promise方式異步返回結(jié)果。

系統(tǒng)能力： SystemCapability.Account.OsAccount

需要權(quán)限： ohos.permission.MANAGE_LOCAL_ACCOUNTS，該權(quán)限僅供系統(tǒng)應(yīng)用使用。

• 參數(shù)：

  參數(shù)名	類型	必填	說明
  accountInfo	[DistributedInfo]	是	分布式帳戶信息。

• 返回值：

  類型	說明
  Promise	Promise實(shí)例，用于獲取異步返回結(jié)果。

• 示例：

  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

提供操作系統(tǒng)帳戶的分布式信息。

系統(tǒng)能力： SystemCapability.Account.OsAccount

審核編輯 黃宇