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

導(dǎo)入模塊

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

account_distributedAccount.getDistributedAccountAbility

getDistributedAccountAbility(): DistributedAccountAbility

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

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

返回值：

示例：

const accountAbility = account_distributedAccount.getDistributedAccountAbility();

DistributedAccountAbility

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

getOsAccountDistributedInfo9+

getOsAccountDistributedInfo(callback: AsyncCallback<DistributedInfo>): void

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

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

需要權(quán)限： ohos.permission.MANAGE_DISTRIBUTED_ACCOUNTS 或 ohos.permission.GET_DISTRIBUTED_ACCOUNTS 或 ohos.permission.DISTRIBUTED_DATASYNC

參數(shù)：

錯(cuò)誤碼：

示例：

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

getOsAccountDistributedInfo9+

getOsAccountDistributedInfo(): Promise<DistributedInfo>

獲取分布式帳號(hào)信息。使用Promise異步回調(diào)。

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

需要權(quán)限： ohos.permission.MANAGE_DISTRIBUTED_ACCOUNTS 或 ohos.permission.GET_DISTRIBUTED_ACCOUNTS 或 ohos.permission.DISTRIBUTED_DATASYNC

返回值：

錯(cuò)誤碼：

示例：

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

queryOsAccountDistributedInfo(deprecated)

queryOsAccountDistributedInfo(callback: AsyncCallback<DistributedInfo>): void

獲取分布式帳號(hào)信息。使用callback異步回調(diào)。

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

需要權(quán)限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.DISTRIBUTED_DATASYNC

參數(shù)：

示例：

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(deprecated)

queryOsAccountDistributedInfo(): Promise<DistributedInfo>

獲取分布式帳號(hào)信息。使用Promise異步回調(diào)。

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

需要權(quán)限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.DISTRIBUTED_DATASYNC

返回值：

示例：

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));
});

setOsAccountDistributedInfo9+

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

更新分布式帳號(hào)信息。使用callback異步回調(diào)。

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

需要權(quán)限： ohos.permission.MANAGE_DISTRIBUTED_ACCOUNTS

參數(shù)：

錯(cuò)誤碼：

示例：

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

setOsAccountDistributedInfo9+

setOsAccountDistributedInfo(accountInfo: DistributedInfo): Promise<void>

更新分布式帳號(hào)信息。使用Promise異步回調(diào)。

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

需要權(quán)限： ohos.permission.MANAGE_DISTRIBUTED_ACCOUNTS

參數(shù)：

返回值：

錯(cuò)誤碼：

示例：

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

updateOsAccountDistributedInfo(deprecated)

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

更新分布式帳號(hào)信息。使用callback異步回調(diào)。

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

需要權(quán)限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

參數(shù)：

示例：

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(deprecated)

updateOsAccountDistributedInfo(accountInfo: DistributedInfo): Promise<void>

更新分布式帳號(hào)信息。使用Promise異步回調(diào)。

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

需要權(quán)限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

參數(shù)：

返回值：

示例：

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