分布式帐号管理


分布式帐号管理

本模块提供管理分布式帐号的一些基础功能,主要包括查询和更新帐号登录状态。

icon-note.gif 说明: 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

导入模块

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

account_distributedAccount.getDistributedAccountAbility

getDistributedAccountAbility(): DistributedAccountAbility

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

系统能力: SystemCapability.Account.OsAccount

返回值:

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

示例:

const accountAbility = account_distributedAccount.getDistributedAccountAbility();
1

DistributedAccountAbility

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

getOsAccountDistributedInfo9+

getOsAccountDistributedInfo(callback: AsyncCallback<DistributedInfo>): void

获取分布式帐号信息,使用callback异步回调。

系统能力: SystemCapability.Account.OsAccount

需要权限: ohos.permission.MANAGE_DISTRIBUTED_ACCOUNTS 或 ohos.permission.GET_DISTRIBUTED_ACCOUNTS 或 ohos.permission.DISTRIBUTED_DATASYNC。

参数:

参数名 类型 必填 说明
callback AsyncCallback<DistributedInfo> 回调参数。当获取分布式帐号信息成功,err为undefined,data为获取到的分布式帐号信息对象;否则为错误对象。

错误码:

错误码ID 错误信息
12300001 System service exception.

示例:

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));
}
1
2
3
4
5
6
7
8
9
10

getOsAccountDistributedInfo9+

getOsAccountDistributedInfo(): Promise<DistributedInfo>

获取分布式帐号信息。使用Promise异步回调。

系统能力: SystemCapability.Account.OsAccount

需要权限: ohos.permission.MANAGE_DISTRIBUTED_ACCOUNTS 或 ohos.permission.GET_DISTRIBUTED_ACCOUNTS 或 ohos.permission.DISTRIBUTED_DATASYNC。

返回值:

类型 说明
Promise<DistributedInfo> Promise对象。返回分布式帐号信息对象。

错误码:

错误码ID 错误信息
12300001 System service exception.

示例:

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));
}
1
2
3
4
5
6
7
8
9
10
11

queryOsAccountDistributedInfo(deprecated)

queryOsAccountDistributedInfo(callback: AsyncCallback<DistributedInfo>): void

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

说明: 从API version 9开始废弃,建议使用getOsAccountDistributedInfo

从 API version 7开始支持。

系统能力: SystemCapability.Account.OsAccount

需要权限: ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.DISTRIBUTED_DATASYNC。

参数:

参数名 类型 必填 说明
callback AsyncCallback<DistributedInfo> 回调函数。当获取分布式帐号信息成功,err为undefined,data为获取到的分布式帐号信息对象;否则为错误对象。

示例:

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);
});
1
2
3
4
5
6

queryOsAccountDistributedInfo(deprecated)

queryOsAccountDistributedInfo(): Promise<DistributedInfo>

获取分布式帐号信息。使用Promise异步回调。

说明: 从API version 9开始废弃,建议使用getOsAccountDistributedInfo

从 API version 7开始支持。

系统能力: SystemCapability.Account.OsAccount

需要权限: ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.DISTRIBUTED_DATASYNC。

返回值:

类型 说明
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));
});
1
2
3
4
5
6
7

setOsAccountDistributedInfo9+

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

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

系统能力: SystemCapability.Account.OsAccount

需要权限: ohos.permission.MANAGE_DISTRIBUTED_ACCOUNTS。

参数:

参数名 类型 必填 说明
accountInfo DistributedInfo 分布式帐号信息。
callback AsyncCallback<void> 回调函数。当更新分布式帐号信息成功时,err为undefined,否则为错误对象。

错误码:

错误码ID 错误信息
12300001 System service exception.
12300002 invalid accountInfo.

示例:

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));
}
1
2
3
4
5
6
7
8
9

setOsAccountDistributedInfo9+

setOsAccountDistributedInfo(accountInfo: DistributedInfo): Promise<void>

更新分布式帐号信息。使用Promise异步回调。

系统能力: SystemCapability.Account.OsAccount

需要权限: ohos.permission.MANAGE_DISTRIBUTED_ACCOUNTS。

参数:

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

返回值:

类型 说明
Promise<void> Promise对象。无返回结果的Promise对象。

错误码:

错误码ID 错误信息
12300001 System service exception.
12300002 invalid accountInfo.

示例:

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));
}
1
2
3
4
5
6
7
8
9
10
11

updateOsAccountDistributedInfo(deprecated)

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

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

说明: 从API version 9开始废弃,建议使用setOsAccountDistributedInfo

从 API version 7开始支持。

系统能力: SystemCapability.Account.OsAccount

需要权限: ohos.permission.MANAGE_LOCAL_ACCOUNTS。

参数:

参数名 类型 必填 说明
accountInfo DistributedInfo 分布式帐号信息。
callback AsyncCallback<void> 回调函数。当更新分布式帐号信息成功时,err为undefined,否则为错误对象。

示例:

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));
});
1
2
3
4
5

updateOsAccountDistributedInfo(deprecated)

updateOsAccountDistributedInfo(accountInfo: DistributedInfo): Promise<void>

更新分布式帐号信息。使用Promise异步回调。

说明: 从API version 9开始废弃,建议使用setOsAccountDistributedInfo

从 API version 7开始支持。 系统能力: SystemCapability.Account.OsAccount

需要权限: ohos.permission.MANAGE_LOCAL_ACCOUNTS。

参数:

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

返回值:

类型 说明
Promise<void> Promise对象。无返回结果的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));
});
1
2
3
4
5
6
7

DistributedInfo

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

系统能力: SystemCapability.Account.OsAccount

参数名 类型 必填 说明
name string 分布式帐号名称,非空字符串。
id string 分布式帐号UID,非空字符串。
event string 分布式帐号登录状态,包括登录、登出、Token失效和注销,分别对应以下字符串:
- Ohos.account.event.LOGIN
- Ohos.account.event.LOGOUT
- Ohos.account.event.TOKEN_INVALID
- Ohos.account.event.LOGOFF
nickname9+ string 分布式帐号的昵称,非空字符串。
avatar9+ string 分布式帐号的头像,非空字符串。
scalableData object 分布式帐号扩展信息,根据业务所需,以k-v形式传递定制化信息。
说明:该参数是预留的可选项,目前查询和更新的方法实现中未使用。