# @ohos.account.appAccount (应用账号管理) 本模块提供应用账号信息的添加、删除、修改和查询基础能力，并支持应用间鉴权和分布式数据同步功能。 > **说明：** > > 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 ```ts import { appAccount } from '@kit.BasicServicesKit'; ``` ## appAccount.createAppAccountManager createAppAccountManager(): AppAccountManager 创建应用账号管理器对象。 **系统能力：** SystemCapability.Account.AppAccount **返回值：** | 类型 | 说明 | | ----------------- | ------------ | | AppAccountManager | 应用账号管理器对象。 | **示例：** ```ts let appAccountManager: appAccount.AppAccountManager = appAccount.createAppAccountManager(); ``` ## AppAccountManager 应用账号管理器类。 ### createAccount9+ createAccount(name: string, callback: AsyncCallback<void>): void 根据账号名创建应用账号。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------------------------- | ----- | -------------------- | | name | string | 是 | 应用账号的名称。 | | callback | AsyncCallback<void> | 是 | 回调函数。当创建成功时，err为null，否则为错误对象。 | **错误码：** | 错误码ID | 错误信息 | | ------- | ------- | | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid name. | | 12300004 | Account already exists. | | 12300007 | The number of accounts reaches the upper limit. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.createAccount('WangWu', (err: BusinessError) => { console.log('createAccount err: ' + JSON.stringify(err)); }); } catch (err) { console.log('createAccount err: ' + JSON.stringify(err)); } ``` ### createAccount9+ createAccount(name: string, options: CreateAccountOptions, callback: AsyncCallback<void>): void 根据账号名和可选项创建应用账号。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | --------- | ------------------------- | ---- | ---------------------------------------- | | name | string | 是 | 应用账号的名称。 | | options | [CreateAccountOptions](#createaccountoptions9) | 是 | 创建应用账号的选项，可提供自定义数据，但不建议包含敏感数据（如密码、Token等）。 | | callback | AsyncCallback<void> | 是 | 回调函数。当创建成功时，err为null，否则为错误对象。 | **错误码：** | 错误码ID | 错误信息 | | ------- | ------- | | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid name or options. | | 12300004 | Account already exists. | | 12300007 | The number of accounts reaches the upper limit. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; let options:appAccount.CreateAccountOptions = { customData: { age: '10' } } try { appAccountManager.createAccount('LiSi', options, (err: BusinessError) => { if (err) { console.log('createAccount failed, error: ' + JSON.stringify(err)); } else { console.log('createAccount successfully'); } }); } catch(err) { console.log('createAccount exception: ' + JSON.stringify(err)); } ``` ### createAccount9+ createAccount(name: string, options?: CreateAccountOptions): Promise<void> 根据账号名和可选项创建应用账号。使用Promise异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | --------- | ------ | ---- | ---------------------------------------- | | name | string | 是 | 应用账号的名称。 | | options | [CreateAccountOptions](#createaccountoptions9) | 否 | 创建应用账号的选项，可提供自定义数据，但不建议包含敏感数据（如密码、Token等）。不填无影响，默认为空，表示创建的该账号无额外信息需要添加。 | **返回值：** | 类型 | 说明 | | ------------------- | --------------------- | | Promise<void> | 无返回结果的Promise对象。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid name or options. | | 12300004 | Account already exists. | | 12300007 | The number of accounts reaches the upper limit. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; let options: appAccount.CreateAccountOptions = { customData: { age: '10' } } try { appAccountManager.createAccount('LiSi', options).then(() => { console.log('createAccount successfully'); }).catch((err: BusinessError) => { console.log('createAccount failed, error: ' + JSON.stringify(err)); }); } catch(err) { console.log('createAccount exception: ' + JSON.stringify(err)); } ``` ### createAccountImplicitly9+ createAccountImplicitly(owner: string, callback: AuthCallback): void 根据指定的账号所有者隐式地创建应用账号。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | --------------------- | ---- | ----------------------- | | owner | string | 是 | 应用账号所有者的包名。 | | callback | [AuthCallback](#authcallback9) | 是 | 认证器回调对象，返回创建结果。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid owner. | | 12300007 | The number of accounts reaches the upper limit. | | 12300010 | Account service busy. | | 12300113 | Authenticator service not found. | | 12300114 | Authenticator service exception. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; import { Want, common } from '@kit.AbilityKit'; let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext function onResultCallback(code: number, result?: appAccount.AuthResult): void { console.log('resultCode: ' + code); console.log('result: ' + JSON.stringify(result)); } function onRequestRedirectedCallback(request: Want): void { let wantInfo: Want = { deviceId: '', bundleName: 'com.example.accountjsdemo', action: 'ohos.want.action.viewData', entities: ['entity.system.default'], } context.startAbility(wantInfo).then(() => { console.log('startAbility successfully'); }).catch((err: BusinessError) => { console.log('startAbility err: ' + JSON.stringify(err)); }) } try { appAccountManager.createAccountImplicitly('com.example.accountjsdemo', { onResult: onResultCallback, onRequestRedirected: onRequestRedirectedCallback }); } catch (err) { console.log('createAccountImplicitly exception: ' + JSON.stringify(err)); } ``` ### createAccountImplicitly9+ createAccountImplicitly(owner: string, options: CreateAccountImplicitlyOptions, callback: AuthCallback): void 根据指定的账号所有者和可选项隐式地创建应用账号。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | --------------------- | ---- | ----------------------- | | owner | string | 是 | 应用账号所有者的包名。 | | options | [CreateAccountImplicitlyOptions](#createaccountimplicitlyoptions9) | 是 | 隐式创建账号的选项。 | | callback | [AuthCallback](#authcallback9) | 是 | 认证器回调对象，返回创建结果。 | **错误码：** | 错误码ID | 错误信息 | | ------- | ------- | | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid owner or options. | | 12300007 | The number of accounts reaches the upper limit. | | 12300010 | Account service busy. | | 12300113 | Authenticator service not found. | | 12300114 | Authenticator service exception. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; import { Want, common } from '@kit.AbilityKit'; let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext function onResultCallback(code: number, result?: appAccount.AuthResult): void { console.log('resultCode: ' + code); console.log('result: ' + JSON.stringify(result)); } function onRequestRedirectedCallback(request: Want): void { let wantInfo: Want = { deviceId: '', bundleName: 'com.example.accountjsdemo', action: 'ohos.want.action.viewData', entities: ['entity.system.default'], } context.startAbility(wantInfo).then(() => { console.log('startAbility successfully'); }).catch((err: BusinessError) => { console.log('startAbility err: ' + JSON.stringify(err)); }) } let options: appAccount.CreateAccountImplicitlyOptions = { authType: 'getSocialData', requiredLabels: [ 'student' ] }; try { appAccountManager.createAccountImplicitly('com.example.accountjsdemo', options, { onResult: onResultCallback, onRequestRedirected: onRequestRedirectedCallback }); } catch (err) { console.log('createAccountImplicitly exception: ' + JSON.stringify(err)); } ``` ### removeAccount9+ removeAccount(name: string, callback: AsyncCallback<void>): void 删除应用账号。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------------------------- | ---- | ---------------- | | name | string | 是 | 应用账号的名称。 | | callback | AsyncCallback<void> | 是 | 回调函数。当删除成功时，err为null，否则为错误对象。 | **错误码：** | 错误码ID | 错误信息 | | ------- | ------- | | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid name. | | 12300003 | Account not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.removeAccount('ZhaoLiu', (err: BusinessError) => { if (err) { console.log('removeAccount failed, error: ' + JSON.stringify(err)); } else { console.log('removeAccount successfully'); } }); } catch(err) { console.log('removeAccount exception: ' + JSON.stringify(err)); } ``` ### removeAccount9+ removeAccount(name: string): Promise<void> 删除应用账号。使用Promise异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---- | ------ | ---- | ----------- | | name | string | 是 | 应用账号的名称。 | **返回值：** | 类型 | 说明 | | :------------------ | :-------------------- | | Promise<void> | 无返回结果的Promise对象。 | **错误码：** | 错误码ID | 错误信息 | | ------- | ------- | | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid name. | | 12300003 | Account not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.removeAccount('Lisi').then(() => { console.log('removeAccount successfully'); }).catch((err: BusinessError) => { console.log('removeAccount failed, error: ' + JSON.stringify(err)); }); } catch (err) { console.log('removeAccount exception: ' + JSON.stringify(err)); } ``` ### setAppAccess9+ setAppAccess(name: string, bundleName: string, isAccessible: boolean, callback: AsyncCallback<void>): void 设置指定应用对特定账号的访问权限。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------------ | ------------------------- | ---- | --------------------------------- | | name | string | 是 | 应用账号的名称。 | | bundleName | string | 是 | 第三方应用的包名。 | | isAccessible | boolean | 是 | 是否可访问。true表示允许访问，false表示禁止访问。 | | callback | AsyncCallback<void> | 是 | 回调函数，如果设置成功，err为null，否则为错误对象。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid name or bundleName. | | 12300003 | Account not found. | | 12400005 | The size of authorization list reaches the upper limit. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.setAppAccess('ZhangSan', 'com.example.accountjsdemo', true, (err: BusinessError) => { if (err) { console.log('setAppAccess failed: ' + JSON.stringify(err)); } else { console.log('setAppAccess successfully'); } }); } catch (err) { console.log('setAppAccess exception: ' + JSON.stringify(err)); } ``` ### setAppAccess9+ setAppAccess(name: string, bundleName: string, isAccessible: boolean): Promise<void> 设置指定应用对特定账号的数据访问权限。使用Promise异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | --------- | | name | string | 是 | 应用账号的名称。 | | bundleName | string | 是 | 第三方应用的包名。 | | isAccessible | boolean | 是 | 是否可访问。true表示允许访问，false表示禁止访问。 | **返回值：** | 类型 | 说明 | | :------------------ | :-------------------- | | Promise<void> | 无返回结果的Promise对象。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid name or bundleName. | | 12300003 | Account not found. | | 12400005 | The size of authorization list reaches the upper limit. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.setAppAccess('ZhangSan', 'com.example.accountjsdemo', true).then(() => { console.log('setAppAccess successfully'); }).catch((err: BusinessError) => { console.log('setAppAccess failed: ' + JSON.stringify(err)); }); } catch (err) { console.log('setAppAccess exception: ' + JSON.stringify(err)); } ``` ### checkAppAccess9+ checkAppAccess(name: string, bundleName: string, callback: AsyncCallback<boolean>): void 检查指定应用对特定账号的数据是否可访问。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------------------------- | ---- | --------------------------------- | | name | string | 是 | 应用账号的名称。 | | bundleName | string | 是 | 第三方应用的包名。 | | callback | AsyncCallback<boolean> | 是 | 回调函数。返回true表示指定应用可访问特定账号的数据；返回false表示不可访问。 | **错误码：** | 错误码ID | 错误信息 | | ------- | ------- | | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid name or bundleName. | | 12300003 | Account not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.checkAppAccess('ZhangSan', 'com.example.accountjsdemo', (err: BusinessError, isAccessible: boolean) => { if (err) { console.log('checkAppAccess failed, error: ' + JSON.stringify(err)); } else { console.log('checkAppAccess successfully'); } }); } catch (err) { console.log('checkAppAccess exception: ' + JSON.stringify(err)); } ``` ### checkAppAccess9+ checkAppAccess(name: string, bundleName: string): Promise<boolean> 检查指定应用对特定账号的数据是否可访问。使用Promise异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | --------- | | name | string | 是 | 应用账号的名称。 | | bundleName | string | 是 | 第三方应用的包名。 | **返回值：** | 类型 | 说明 | | ------------------- | --------------------- | | Promise<boolean> | Promise对象。返回true表示指定应用可访问特定账号的数据；返回false表示不可访问。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid name or bundleName. | | 12300003 | Account not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.checkAppAccess('ZhangSan', 'com.example.accountjsdemo').then((isAccessible: boolean) => { console.log('checkAppAccess successfully, isAccessible: ' + isAccessible); }).catch((err: BusinessError) => { console.log('checkAppAccess failed, error: ' + JSON.stringify(err)); }); } catch (err) { console.log('checkAppAccess exception: ' + JSON.stringify(err)); } ``` ### setDataSyncEnabled9+ setDataSyncEnabled(name: string, isEnabled: boolean, callback: AsyncCallback<void>): void 开启或禁止指定应用账号的数据同步功能。使用callback异步回调。 **需要权限：** ohos.permission.DISTRIBUTED_DATASYNC **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------------------------- | ---- | ------------------------- | | name | string | 是 | 应用账号的名称。 | | isEnabled | boolean | 是 | 是否开启数据同步。 | | callback | AsyncCallback<void> | 是 | 回调函数。当开启或禁止成功时，err为null，否则为错误对象。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 201 | Permission denied.| | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid name. | | 12300003 | Account not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.setDataSyncEnabled('ZhangSan', true, (err: BusinessError) => { console.log('setDataSyncEnabled err: ' + JSON.stringify(err)); }); } catch (err) { console.log('setDataSyncEnabled err: ' + JSON.stringify(err)); } ``` ### setDataSyncEnabled9+ setDataSyncEnabled(name: string, isEnabled: boolean): Promise<void> 开启或禁止指定应用账号的数据同步功能。使用Promise异步回调。 **需要权限：** ohos.permission.DISTRIBUTED_DATASYNC **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------- | ---- | ----------- | | name | string | 是 | 应用账号的名称。 | | isEnabled | boolean | 是 | 是否开启数据同步。 | **返回值：** | 类型 | 说明 | | :------------------ | :-------------------- | | Promise<void> | 无返回结果的Promise对象。 | **错误码：** | 错误码ID | 错误信息 | | ------- | ------- | | 201 | Permission denied.| | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid name. | | 12300003 | Account not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager .setDataSyncEnabled('ZhangSan', true).then(() => { console.log('setDataSyncEnabled Success'); }).catch((err: BusinessError) => { console.log('setDataSyncEnabled err: ' + JSON.stringify(err)); }); } catch (err) { console.log('setDataSyncEnabled err: ' + JSON.stringify(err)); } ``` ### checkDataSyncEnabled9+ checkDataSyncEnabled(name: string, callback: AsyncCallback<boolean>): void 检查指定应用账号是否开启数据同步功能。使用callback异步回调。 **需要权限：** ohos.permission.DISTRIBUTED_DATASYNC **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------------- | ---- | --------------------- | | name | string | 是 | 应用账号的名称。 | | callback | AsyncCallback<boolean> | 是 | 回调函数。返回true表示指定应用账号已开启数据同步功能；返回false表示未开启。 | **错误码：** | 错误码ID | 错误信息 | | ------- | ------- | | 201 | Permission denied.| | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid name. | | 12300003 | Account not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.checkDataSyncEnabled('ZhangSan', (err: BusinessError, isEnabled: boolean) => { if (err) { console.log('checkDataSyncEnabled failed, err: ' + JSON.stringify(err)); } else { console.log('checkDataSyncEnabled successfully, isEnabled: ' + isEnabled); } }); } catch (err) { console.log('checkDataSyncEnabled err: ' + JSON.stringify(err)); } ``` ### checkDataSyncEnabled9+ checkDataSyncEnabled(name: string): Promise<boolean> 检查指定应用账号是否开启数据同步功能。使用Promise异步回调。 **需要权限：** ohos.permission.DISTRIBUTED_DATASYNC **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---- | ------ | ---- | ------- | | name | string | 是 | 应用账号的名称。 | **返回值：** | 类型 | 说明 | | :--------------------- | :-------------------- | | Promise<boolean> | Promise对象。返回true表示指定应用账号已开启数据同步功能；返回false表示未开启。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 201 | Permission denied.| | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid name. | | 12300003 | Account not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.checkDataSyncEnabled('ZhangSan').then((isEnabled: boolean) => { console.log('checkDataSyncEnabled successfully, isEnabled: ' + isEnabled); }).catch((err: BusinessError) => { console.log('checkDataSyncEnabled failed, err: ' + JSON.stringify(err)); }); } catch (err) { console.log('checkDataSyncEnabled err: ' + JSON.stringify(err)); } ``` ### setCredential9+ setCredential(name: string, credentialType: string, credential: string,callback: AsyncCallback<void>): void 设置指定应用账号的凭据。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------------- | ------------------------- | ---- | ------------- | | name | string | 是 | 应用账号的名称。 | | credentialType | string | 是 | 凭据类型。 | | credential | string | 是 | 凭据取值。 | | callback | AsyncCallback<void> | 是 | 回调函数。当凭据设置成功时，err为null，否则为错误对象。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid name, credentialType or credential. | | 12300003 | Account not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.setCredential('ZhangSan', 'PIN_SIX', 'xxxxxx', (err: BusinessError) => { if (err) { console.log('setCredential failed, error: ' + JSON.stringify(err)); } else { console.log('setCredential successfully'); } }); } catch (err) { console.log('setCredential exception: ' + JSON.stringify(err)); } ``` ### setCredential9+ setCredential(name: string, credentialType: string, credential: string): Promise<void> 设置指定应用账号的凭据。使用Promise异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------------- | ------ | ---- | ---------- | | name | string | 是 | 应用账号的名称。 | | credentialType | string | 是 | 凭据类型。 | | credential | string | 是 | 凭据取值。 | **返回值：** | 类型 | 说明 | | :------------------ | :-------------------- | | Promise<void> | 无返回结果的Promise对象。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid name, credentialType or credential. | | 12300003 | Account not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.setCredential('ZhangSan', 'PIN_SIX', 'xxxxxx').then(() => { console.log('setCredential successfully'); }).catch((err: BusinessError) => { console.log('setCredential failed, error: ' + JSON.stringify(err)); }); } catch (err) { console.log('setCredential exception: ' + JSON.stringify(err)); } ``` ### getCredential9+ getCredential(name: string, credentialType: string, callback: AsyncCallback<string>): void 获取指定应用账号的凭据。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------------- | --------------------------- | ---- | -------------- | | name | string | 是 | 应用账号的名称。 | | credentialType | string | 是 | 凭据类型。 | | callback | AsyncCallback<string> | 是 | 回调函数。当获取凭据成功时，err为null，data为指定应用账号的凭据；否则为错误对象。 | **错误码：** | 错误码ID | 错误信息 | | ------- | ------- | | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid name or credentialType. | | 12300003 | Account not found. | | 12300102 | Credential not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.getCredential('ZhangSan', 'PIN_SIX', (err: BusinessError, result: string) => { if (err) { console.log('getCredential failed, error: ' + JSON.stringify(err)); } else { console.log('getCredential successfully, result: ' + result); } }); } catch (err) { console.log('getCredential err: ' + JSON.stringify(err)); } ``` ### getCredential9+ getCredential(name: string, credentialType: string): Promise<string> 获取指定应用账号的凭据。使用Promise异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------------- | ------ | ---- | ---------- | | name | string | 是 | 应用账号的名称。 | | credentialType | string | 是 | 凭据类型。 | **返回值：** | 类型 | 说明 | | :-------------------- | :-------------------- | | Promise<string> | Promise对象，返回指定应用账号的凭据。 | **错误码：** | 错误码ID | 错误信息 | | ------- | ------- | | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid name or credentialType. | | 12300003 | Account not found. | | 12300102 | Credential not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.getCredential('ZhangSan', 'PIN_SIX').then((credential: string) => { console.log('getCredential successfully, credential: ' + credential); }).catch((err: BusinessError) => { console.log('getCredential failed, error: ' + JSON.stringify(err)); }); } catch (err) { console.log('getCredential exception: ' + JSON.stringify(err)); } ``` ### setCustomData9+ setCustomData(name: string, key: string, value: string, callback: AsyncCallback<void>): void 设置指定应用账号的自定义数据。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------------------------- | ---- | ----------------- | | name | string | 是 | 应用账号的名称。 | | key | string | 是 | 自定义数据的键名。 | | value | string | 是 | 自定义数据的取值。 | | callback | AsyncCallback<void> | 是 | 回调函数。当设置自定义数据成功时，err为null，否则为错误对象。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid name, key or value. | | 12300003 | Account not found. | | 12400003 | The number of custom data reaches the upper limit. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.setCustomData('ZhangSan', 'age', '12', (err: BusinessError) => { if (err) { console.log('setCustomData failed, error: ' + JSON.stringify(err)); } else { console.log('setCustomData successfully'); } }); } catch (err) { console.log('setCustomData exception: ' + JSON.stringify(err)); } ``` ### setCustomData9+ setCustomData(name: string, key: string, value: string): Promise<void> 设置指定应用账号的自定义数据。使用Promise异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ----- | ------ | ---- | ----------------- | | name | string | 是 | 应用账号的名称。 | | key | string | 是 | 自定义数据的键名。 | | value | string | 是 | 自定义数据的取值。 | **返回值：** | 类型 | 说明 | | :------------------ | :-------------------- | | Promise<void> | 无返回结果的Promise对象。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid name, key or value. | | 12300003 | Account not found. | | 12400003 | The number of custom data reaches the upper limit. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.setCustomData('ZhangSan', 'age', '12').then(() => { console.log('setCustomData successfully'); }).catch((err: BusinessError) => { console.log('setCustomData failed, error: ' + JSON.stringify(err)); }); } catch (err) { console.log('setCustomData exception: ' + JSON.stringify(err)); } ``` ### getCustomData9+ getCustomData(name: string, key: string, callback: AsyncCallback<string>): void 根据指定键名获取特定应用账号的自定义数据。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | --------------------------- | ----- | ------------------------ | | name | string | 是 | 应用账号的名称。 | | key | string | 是 | 自定义数据的键名。 | | callback | AsyncCallback<string> | 是 | 回调函数。当获取成功时，err为null，data为自定义数据的取值；否则为错误对象。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid name or key. | | 12300003 | Account not found. | | 12400002 | Custom data not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.getCustomData('ZhangSan', 'age', (err: BusinessError, data: string) => { if (err) { console.log('getCustomData failed, error: ' + err); } else { console.log('getCustomData successfully, data: ' + data); } }); } catch (err) { console.log('getCustomData exception: ' + JSON.stringify(err)); } ``` ### getCustomData9+ getCustomData(name: string, key: string): Promise<string> 根据指定键名获取特定应用账号的自定义数据。使用Promise异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---- | ------ | ---- | --------- | | name | string | 是 | 应用账号的名称。 | | key | string | 是 | 自定义数据的键名。 | **返回值：** | 类型 | 说明 | | --------------------- | --------------------- | | Promise<string> | Promise对象，返回自定义数据的取值。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid name or key. | | 12300003 | Account not found. | | 12400002 | Custom data not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.getCustomData('ZhangSan', 'age').then((data: string) => { console.log('getCustomData successfully, data: ' + data); }).catch((err: BusinessError) => { console.log('getCustomData failed, error: ' + JSON.stringify(err)); }); } catch (err) { console.log('getCustomData exception: ' + JSON.stringify(err)); } ``` ### getCustomDataSync9+ getCustomDataSync(name: string, key: string): string; 根据指定键名获取特定应用账号的自定义数据。使用同步方式返回结果。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---- | ------ | ---- | --------- | | name | string | 是 | 应用账号的名称。 | | key | string | 是 | 自定义数据的键名。 | **返回值：** | 类型 | 说明 | | --------------------- | --------------------- | | string | 自定义数据的取值。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid name or key. | | 12300003 | Account not found. | | 12400002 | Custom data not found. | **示例：** ```ts try { let value = appAccountManager.getCustomDataSync('ZhangSan', 'age'); console.info('getCustomDataSync successfully, vaue: ' + value); } catch (err) { console.error('getCustomDataSync failed, error: ' + JSON.stringify(err)); } ``` ### getAllAccounts9+ getAllAccounts(callback: AsyncCallback<Array<AppAccountInfo>>): void 获取所有可访问的应用账号信息。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------------------------- | ---- | --------- | | callback | AsyncCallback<Array<[AppAccountInfo](#appaccountinfo)>> | 是 | 回调函数。当查询成功时，err为null，data为获取到的应用账号信息列表；否则为错误对象。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.getAllAccounts((err: BusinessError, data: appAccount.AppAccountInfo[]) => { if (err) { console.debug('getAllAccounts failed, error: ' + JSON.stringify(err)); } else { console.debug('getAllAccounts successfully'); } }); } catch (err) { console.debug('getAllAccounts exception: ' + JSON.stringify(err)); } ``` ### getAllAccounts9+ getAllAccounts(): Promise<Array<AppAccountInfo>> 获取所有可访问的应用账号信息。使用Promise异步回调。 **系统能力：** SystemCapability.Account.AppAccount **返回值：** | 类型 | 说明 | | ---------------------------------------- | --------------------- | | Promise<Array<[AppAccountInfo](#appaccountinfo)>> | Promise对象，返回全部应用已授权账号信息对象。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 12300001 | System service exception. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.getAllAccounts().then((data: appAccount.AppAccountInfo[]) => { console.debug('getAllAccounts successfully'); }).catch((err: BusinessError) => { console.debug('getAllAccounts failed, error: ' + JSON.stringify(err)); }); } catch (err) { console.debug('getAllAccounts exception: ' + JSON.stringify(err)); } ``` ### getAccountsByOwner9+ getAccountsByOwner(owner: string, callback: AsyncCallback<Array<AppAccountInfo>>): void 根据应用账号所有者获取调用方可访问的应用账号列表。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------------------------- | ---- | --------- | | owner | string | 是 | 应用账号所有者的包名。 | | callback | AsyncCallback<Array<[AppAccountInfo](#appaccountinfo)>> | 是 | 回调函数。如果获取成功，err为null，data为获取到的应用账号列表；否则为错误对象。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid owner. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.getAccountsByOwner('com.example.accountjsdemo2', (err: BusinessError, data: appAccount.AppAccountInfo[]) => { if (err) { console.debug('getAccountsByOwner failed, error:' + JSON.stringify(err)); } else { console.debug('getAccountsByOwner successfully, data:' + JSON.stringify(data)); } }); } catch (err) { console.debug('getAccountsByOwner exception:' + JSON.stringify(err)); } ``` ### getAccountsByOwner9+ getAccountsByOwner(owner: string): Promise<Array<AppAccountInfo>> 根据应用账号所有者获取调用方可访问的应用账号列表。使用Promise异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ----- | ------ | ---- | ------ | | owner | string | 是 | 应用账号所有者的包名。 | **返回值：** | 类型 | 说明 | | ---------------------------------------- | --------------------- | | Promise<Array<[AppAccountInfo](#appaccountinfo)>> | Promise对象，返回获取到的应用账号列表。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid owner. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.getAccountsByOwner('com.example.accountjsdemo2').then(( data: appAccount.AppAccountInfo[]) => { console.debug('getAccountsByOwner successfully, data: ' + JSON.stringify(data)); }).catch((err: BusinessError) => { console.debug('getAccountsByOwner failed, error: ' + JSON.stringify(err)); }); } catch (err) { console.debug('getAccountsByOwner exception: ' + JSON.stringify(err)); } ``` ### on('accountChange')9+ on(type: 'accountChange', owners: Array<string>, callback: Callback<Array<AppAccountInfo>>): void 订阅指定应用的账号信息变更事件。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------------------------- | ---- | ------------------------------ | | type | 'accountChange' | 是 | 事件回调类型，支持的事件为'accountChange'，当目标应用更新账号信息时，触发该事件。 | | owners | Array<string> | 是 | 应用账号所有者的包名列表。 | | callback | Callback<Array<[AppAccountInfo](#appaccountinfo)>> | 是 | 需要注册的回调函数，返回信息为发生变更的应用账号列表。 | **错误码：** | 错误码ID | 错误信息 | | ------- | ------- | | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid type or owners. | **示例：** ```ts function changeOnCallback(data: appAccount.AppAccountInfo[]): void { console.log('receive change data:' + JSON.stringify(data)); } try{ appAccountManager.on('accountChange', ['com.example.actsaccounttest'], changeOnCallback); } catch(err) { console.error('on accountChange failed, error:' + JSON.stringify(err)); } ``` ### off('accountChange')9+ off(type: 'accountChange', callback?: Callback<Array<AppAccountInfo>>): void 取消订阅账号信息变更事件。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------------------------------- | ---- | ------------ | | type | 'accountChange' | 是 | 事件回调类型，支持的事件为'accountChange'，当账号所有者更新账号信息时，触发该事件。 | | callback | Callback<Array<[AppAccountInfo](#appaccountinfo)>> | 否 | 需要注销的回调函数，默认为空，表示取消该类型事件所有的回调。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.| | 12300001 | System service exception. | | 12300002 | Invalid type. | **示例：** ```ts function changeOnCallback(data: appAccount.AppAccountInfo[]): void { console.log('receive change data:' + JSON.stringify(data)); } try{ appAccountManager.on('accountChange', ['com.example.actsaccounttest'], changeOnCallback); } catch(err) { console.error('on accountChange failed, error:' + JSON.stringify(err)); } try{ appAccountManager.off('accountChange', changeOnCallback); } catch(err){ console.error('off accountChange failed, error:' + JSON.stringify(err)); } ``` ### auth9+ auth(name: string, owner: string, authType: string, callback: AuthCallback): void 对应用账号进行鉴权以获取授权令牌。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | --------------------- | ---- | --------------- | | name | string | 是 | 应用账号的名称。 | | owner | string | 是 | 应用账号所有者的包名。 | | authType | string | 是 | 鉴权类型。 | | callback | [AuthCallback](#authcallback9) | 是 | 回调对象，返回鉴权结果。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid name, owner or authType. | | 12300003 | Account not found. | | 12300010 | Account service busy. | | 12300113 | Authenticator service not found. | | 12300114 | Authenticator service exception. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; import { Want, common } from '@kit.AbilityKit'; let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext function onResultCallback(code: number, authResult?: appAccount.AuthResult): void { console.log('resultCode: ' + code); console.log('authResult: ' + JSON.stringify(authResult)); } function onRequestRedirectedCallback(request: Want): void { let wantInfo: Want = { deviceId: '', bundleName: 'com.example.accountjsdemo', action: 'ohos.want.action.viewData', entities: ['entity.system.default'], } context.startAbility(wantInfo).then(() => { console.log('startAbility successfully'); }).catch((err: BusinessError) => { console.log('startAbility err: ' + JSON.stringify(err)); }) } try { appAccountManager.auth('LiSi', 'com.example.accountjsdemo', 'getSocialData', { onResult: onResultCallback, onRequestRedirected: onRequestRedirectedCallback }); } catch (err) { console.log('auth exception: ' + JSON.stringify(err)); } ``` ### auth9+ auth(name: string, owner: string, authType: string, options: Record, callback: AuthCallback): void 对应用账号进行鉴权以获取授权令牌。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | --------------------- | ---- | --------------- | | name | string | 是 | 应用账号的名称。 | | owner | string | 是 | 应用账号所有者的包名。 | | authType | string | 是 | 鉴权类型。 | | options | Record | 是 | 鉴权所需的可选项。 | | callback | [AuthCallback](#authcallback9) | 是 | 回调对象，返回鉴权结果。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid name, owner, authType or options. | | 12300003 | Account not found. | | 12300010 | Account service busy. | | 12300113 | Authenticator service not found. | | 12300114 | Authenticator service exception. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; import { Want, common } from '@kit.AbilityKit'; let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext function onResultCallback(code: number, authResult?: appAccount.AuthResult): void { console.log('resultCode: ' + code); console.log('authResult: ' + JSON.stringify(authResult)); } function onRequestRedirectedCallback(request: Want): void { let wantInfo: Want = { deviceId: '', bundleName: 'com.example.accountjsdemo', action: 'ohos.want.action.viewData', entities: ['entity.system.default'], } context.startAbility(wantInfo).then(() => { console.log('startAbility successfully'); }).catch((err: BusinessError) => { console.log('startAbility err: ' + JSON.stringify(err)); }) } let options: Record = { 'password': 'xxxx', }; try { appAccountManager.auth('LiSi', 'com.example.accountjsdemo', 'getSocialData', options, { onResult: onResultCallback, onRequestRedirected: onRequestRedirectedCallback }); } catch (err) { console.log('auth exception: ' + JSON.stringify(err)); } ``` ### getAuthToken9+ getAuthToken(name: string, owner: string, authType: string, callback: AsyncCallback<string>): void 获取指定应用账号的特定鉴权类型的授权令牌。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | --------------------------- | ---- | ----------- | | name | string | 是 | 应用账号的名称。 | | owner | string | 是 | 应用账号所有者的包名。 | | authType | string | 是 | 鉴权类型。 | | callback | AsyncCallback<string> | 是 | 回调函数。当获取成功时，err为null，data为授权令牌值；否则为错误对象。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid name, owner or authType. | | 12300003 | Account not found. | | 12300107 | AuthType not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.getAuthToken('LiSi', 'com.example.accountjsdemo', 'getSocialData', (err: BusinessError, token: string) => { if (err) { console.log('getAuthToken failed, error: ' + JSON.stringify(err)); } else { console.log('getAuthToken successfully, token: ' + token); } }); } catch (err) { console.log('getAuthToken exception: ' + JSON.stringify(err)); } ``` ### getAuthToken9+ getAuthToken(name: string, owner: string, authType: string): Promise<string> 获取指定应用账号的特定鉴权类型的授权令牌。使用Promise异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------ | ---- | ----------- | | name | string | 是 | 应用账号的名称。 | | owner | string | 是 | 应用账号所有者的包名。 | | authType | string | 是 | 鉴权类型。 | **返回值：** | 类型 | 说明 | | --------------------- | --------------------- | | Promise<string> | Promise对象，返回授权令牌。 | **错误码：** | 错误码ID | 错误信息 | | ------- | ------- | | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid name, owner or authType. | | 12300003 | Account not found. | | 12300107 | AuthType not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.getAuthToken('LiSi', 'com.example.accountjsdemo', 'getSocialData').then((token: string) => { console.log('getAuthToken successfully, token: ' + token); }).catch((err: BusinessError) => { console.log('getAuthToken failed, error: ' + JSON.stringify(err)); }); } catch (err) { console.log('getAuthToken exception: ' + JSON.stringify(err)); } ``` ### setAuthToken9+ setAuthToken(name: string, authType: string, token: string, callback: AsyncCallback<void>): void 为指定应用账号设置特定鉴权类型的授权令牌。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------------------------- | ---- | -------- | | name | string | 是 | 应用账号的名称。 | | authType | string | 是 | 鉴权类型。 | | token | string | 是 | 授权令牌。 | | callback | AsyncCallback<void> | 是 | 回调函数。当设置成功时，err为null；否则为错误对象。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid name, authType or token. | | 12300003 | Account not found. | | 12400004 | The number of tokens reaches the upper limit. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.setAuthToken('LiSi', 'getSocialData', 'xxxx', (err: BusinessError) => { if (err) { console.log('setAuthToken failed, error: ' + JSON.stringify(err)); } else { console.log('setAuthToken successfully'); } }); } catch (err) { console.log('setAuthToken exception: ' + JSON.stringify(err)); } ``` ### setAuthToken9+ setAuthToken(name: string, authType: string, token: string): Promise<void> 为指定应用账号设置特定鉴权类型的授权令牌。使用Promise异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------ | ---- | -------- | | name | string | 是 | 应用账号的名称。 | | authType | string | 是 | 鉴权类型。 | | token | string | 是 | 授权令牌。 | **返回值：** | 类型 | 说明 | | ------------------- | --------------------- | | Promise<void> | 无返回结果的Promise对象。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid name, authType or token. | | 12300003 | Account not found. | | 12400004 | The number of tokens reaches the upper limit. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.setAuthToken('LiSi', 'getSocialData', 'xxxx').then(() => { console.log('setAuthToken successfully'); }).catch((err: BusinessError) => { console.log('setAuthToken failed, error: ' + JSON.stringify(err)); }); } catch (err) { console.log('setAuthToken exception: ' + JSON.stringify(err)); } ``` ### deleteAuthToken9+ deleteAuthToken(name: string, owner: string, authType: string, token: string, callback: AsyncCallback<void>): void 删除指定应用账号的特定鉴权类型的授权令牌。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------------------------- | ---- | ------------ | | name | string | 是 | 应用账号的名称。 | | owner | string | 是 | 应用账号所有者的包名。 | | authType | string | 是 | 鉴权类型。 | | token | string | 是 | 授权令牌。如果授权令牌不存在，则不执行任何操作。 | | callback | AsyncCallback<void> | 是 | 回调函数。当删除成功时，err为null；否则为错误对象。 | **错误码：** | 错误码ID | 错误信息 | | ------- | ------- | | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid name, owner, authType or token. | | 12300003 | Account not found. | | 12300107 | AuthType not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.deleteAuthToken('LiSi', 'com.example.accountjsdemo', 'getSocialData', 'xxxxx', (err: BusinessError) => { if (err) { console.log('deleteAuthToken failed, error: ' + JSON.stringify(err)); } else { console.log('deleteAuthToken successfully'); } }); } catch (err) { console.log('deleteAuthToken exception: ' + JSON.stringify(err)); } ``` ### deleteAuthToken9+ deleteAuthToken(name: string, owner: string, authType: string, token: string): Promise<void> 删除指定应用账号的特定鉴权类型的授权令牌。使用Promise异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------ | ---- | ------------ | | name | string | 是 | 应用账号的名称。 | | owner | string | 是 | 应用账号所有者的包名。 | | authType | string | 是 | 鉴权类型。 | | token | string | 是 | 授权令牌。如果授权令牌不存在，则不执行任何操作。 | **返回值：** | 类型 | 说明 | | ------------------- | --------------------- | | Promise<void> | 无返回结果的Promise对象。 | **错误码：** | 错误码ID | 错误信息 | | ------- | ------- | | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid name, owner, authType or token. | | 12300003 | Account not found. | | 12300107 | AuthType not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.deleteAuthToken('LiSi', 'com.example.accountjsdemo', 'getSocialData', 'xxxxx').then(() => { console.log('deleteAuthToken successfully'); }).catch((err: BusinessError) => { console.log('deleteAuthToken failed, error: ' + JSON.stringify(err)); }); } catch (err) { console.log('deleteAuthToken exception: ' + JSON.stringify(err)); } ``` ### setAuthTokenVisibility9+ setAuthTokenVisibility(name: string, authType: string, bundleName: string, isVisible: boolean, callback: AsyncCallback<void>): void 设置指定账号的特定鉴权类型的授权令牌对指定应用的可见性。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------------------------- | ---- | ------------------------- | | name | string | 是 | 应用账号的名称。 | | authType | string | 是 | 鉴权类型。 | | bundleName | string | 是 | 被设置可见性的应用包名。 | | isVisible | boolean | 是 | 是否可见。true表示可见，false表示不可见。 | | callback | AsyncCallback<void> | 是 | 回调函数。当设置成功时，err为null；否则为错误对象。| **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid name, authType or bundleName. | | 12300003 | Account not found. | | 12300107 | AuthType not found. | | 12400005 | The size of authorization list reaches the upper limit. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.setAuthTokenVisibility('LiSi', 'getSocialData', 'com.example.accountjsdemo', true, (err: BusinessError) => { if (err) { console.log('setAuthTokenVisibility failed, error: ' + JSON.stringify(err)); } else { console.log('setAuthTokenVisibility successfully'); } }); } catch (err) { console.log('setAuthTokenVisibility exception: ' + JSON.stringify(err)); } ``` ### setAuthTokenVisibility9+ setAuthTokenVisibility(name: string, authType: string, bundleName: string, isVisible: boolean): Promise<void> 设置指定账号的特定鉴权类型的授权令牌对指定应用的可见性。使用Promise异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------------------------- | ---- | ------------------------- | | name | string | 是 | 应用账号的名称。 | | authType | string | 是 | 鉴权类型。 | | bundleName | string | 是 | 被设置可见性的应用包名。 | | isVisible | boolean | 是 | 是否可见。true表示可见，false表示不可见。 | **返回值：** | 类型 | 说明 | | ------------------- | --------------------- | | Promise<void> | 无返回结果的Promise对象。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid name, authType or bundleName. | | 12300003 | Account not found. | | 12300107 | AuthType not found. | | 12400005 | The size of authorization list reaches the upper limit. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.setAuthTokenVisibility('LiSi', 'getSocialData', 'com.example.accountjsdemo', true).then(() => { console.log('setAuthTokenVisibility successfully'); }).catch((err: BusinessError) => { console.log('setAuthTokenVisibility failed, error: ' + JSON.stringify(err)); }); } catch (err) { console.log('setAuthTokenVisibility exception: ' + JSON.stringify(err)); } ``` ### checkAuthTokenVisibility9+ checkAuthTokenVisibility(name: string, authType: string, bundleName: string, callback: AsyncCallback<boolean>): void 检查指定应用账号的特定鉴权类型的授权令牌对指定应用的可见性。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---------- | ---------------------------- | ---- | ----------- | | name | string | 是 | 应用账号的名称。 | | authType | string | 是 | 鉴权类型。 | | bundleName | string | 是 | 检查可见性的应用包名。 | | callback | AsyncCallback<boolean> | 是 | 回调函数。当检查成功时，err为null，data为true表示可见，data为false表示不可见；否则为错误对象。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid name, authType or bundleName. | | 12300003 | Account not found. | | 12300107 | AuthType not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.checkAuthTokenVisibility('LiSi', 'getSocialData', 'com.example.accountjsdemo', (err: BusinessError, isVisible: boolean) => { if (err) { console.log('checkAuthTokenVisibility failed, error: ' + JSON.stringify(err)); } else { console.log('checkAuthTokenVisibility successfully, isVisible: ' + isVisible); } }); } catch (err) { console.log('checkAuthTokenVisibility exception: ' + JSON.stringify(err)); } ``` ### checkAuthTokenVisibility9+ checkAuthTokenVisibility(name: string, authType: string, bundleName: string): Promise<boolean> 检查指定应用账号的特定鉴权类型的授权令牌对指定应用的可见性。使用Promise异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | ------------- | | name | string | 是 | 应用账号的名称。 | | authType | string | 是 | 鉴权类型。 | | bundleName | string | 是 | 用于检查可见性的应用包名。 | **返回值：** | 类型 | 说明 | | ---------------------- | --------------------- | | Promise<boolean> | Promise对象。返回true表示授权令牌对指定应用的可见，返回false表示不可见。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid name, authType or bundleName. | | 12300003 | Account not found. | | 12300107 | AuthType not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.checkAuthTokenVisibility('LiSi', 'getSocialData', 'com.example.accountjsdemo').then(( isVisible: boolean) => { console.log('checkAuthTokenVisibility successfully, isVisible: ' + isVisible); }).catch((err: BusinessError) => { console.log('checkAuthTokenVisibility failed, error: ' + JSON.stringify(err)); }); } catch (err) { console.log('checkAuthTokenVisibility exception: ' + JSON.stringify(err)); } ``` ### getAllAuthTokens9+ getAllAuthTokens(name: string, owner: string, callback: AsyncCallback<Array<AuthTokenInfo>>): void 获取指定账号对调用方可见的所有授权令牌。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------------------------- | ---- | ----------- | | name | string | 是 | 应用账号的名称。 | | owner | string | 是 | 应用账号所有者的包名。 | | callback | AsyncCallback<Array<[AuthTokenInfo](#authtokeninfo9)>> | 是 | 回调函数。当获取成功时，err为null，data为授权令牌数组；否则为错误对象。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid name or owner. | | 12300003 | Account not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.getAllAuthTokens('LiSi', 'com.example.accountjsdemo', (err: BusinessError, tokenArr: appAccount.AuthTokenInfo[]) => { if (err) { console.log('getAllAuthTokens failed, error: ' + JSON.stringify(err)); } else { console.log('getAllAuthTokens successfully, tokenArr: ' + tokenArr); } }); } catch (err) { console.log('getAllAuthTokens exception: ' + JSON.stringify(err)); } ``` ### getAllAuthTokens9+ getAllAuthTokens(name: string, owner: string): Promise<Array<AuthTokenInfo>> 获取指定账号对调用方可见的所有授权令牌。使用Promise异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ----- | ------ | ---- | ----------- | | name | string | 是 | 应用账号的名称。 | | owner | string | 是 | 应用账号所有者的包名。 | **返回值：** | 类型 | 说明 | | ---------------------------------------- | --------------------- | | Promise<Array<[AuthTokenInfo](#authtokeninfo9)>> | Promise对象，返回授权令牌数组。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid name or owner. | | 12300003 | Account not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.getAllAuthTokens('LiSi', 'com.example.accountjsdemo').then(( tokenArr: appAccount.AuthTokenInfo[]) => { console.log('getAllAuthTokens successfully, tokenArr: ' + JSON.stringify(tokenArr)); }).catch((err: BusinessError) => { console.log('getAllAuthTokens failed, error: ' + JSON.stringify(err)); }); } catch (err) { console.log('getAllAuthTokens exception: ' + JSON.stringify(err)); } ``` ### getAuthList9+ getAuthList(name: string, authType: string, callback: AsyncCallback<Array<string>>): void 获取指定应用账号的特定鉴权类型的授权列表，即被授权的包名数组（令牌的授权列表通过[setAuthTokenVisibility](#setauthtokenvisibility9)来设置）。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------------------------- | ---- | ----------------------- | | name | string | 是 | 应用账号的名称。 | | authType | string | 是 | 鉴权类型。 | | callback | AsyncCallback<Array<string>> | 是 | 回调函数。当获取成功时，err为null，data为被授权的包名数组；否则为错误对象。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid name or authType. | | 12300003 | Account not found. | | 12300107 | AuthType not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.getAuthList('LiSi', 'getSocialData', (err: BusinessError, authList: string[]) => { if (err) { console.log('getAuthList failed, error: ' + JSON.stringify(err)); } else { console.log('getAuthList successfully, authList: ' + authList); } }); } catch (err) { console.log('getAuthList exception: ' + JSON.stringify(err)); } ``` ### getAuthList9+ getAuthList(name: string, authType: string): Promise<Array<string>> 获取指定应用账号的特定鉴权类型的授权列表，即被授权的包名数组（令牌的授权列表通过[setAuthTokenVisibility](#setauthtokenvisibility9)来设置）。使用Promise异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------ | ---- | ------------------------------ | | name | string | 是 | 应用账号的名称。 | | authType | string | 是 | 鉴权类型。 | **返回值：** | 类型 | 说明 | | ---------------------------------- | --------------------- | | Promise<Array<string>> | Promise对象，返回被授权的包名数组。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid name or authType. | | 12300003 | Account not found. | | 12300107 | AuthType not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.getAuthList('LiSi', 'getSocialData').then((authList: string[]) => { console.log('getAuthList successfully, authList: ' + authList); }).catch((err: BusinessError) => { console.log('getAuthList failed, error: ' + JSON.stringify(err)); }); } catch (err) { console.log('getAuthList exception: ' + JSON.stringify(err)); } ``` ### getAuthCallback9+ getAuthCallback(sessionId: string, callback: AsyncCallback<AuthCallback>): void 获取鉴权会话的认证器回调对象。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | --------- | ---------------------------------------- | ---- | -------- | | sessionId | string | 是 | 鉴权会话的标识。 | | callback | AsyncCallback<[AuthCallback](#authcallback9)> | 是 | 回调函数。当获取成功时，err为null，data为鉴权会话的认证器回调对象；否则为错误对象。 | **错误码：** | 错误码ID | 错误信息 | | ------- | ------- | | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid sessionId. | | 12300108 | Session not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; import { Want, UIAbility, AbilityConstant } from '@kit.AbilityKit'; export default class EntryAbility extends UIAbility { onCreate(want: Want, param: AbilityConstant.LaunchParam) { // ability 生命周期函数 let sessionId: string = want.parameters![appAccount.Constants.KEY_SESSION_ID] as string; try { appAccountManager.getAuthCallback(sessionId, (err: BusinessError, callback: appAccount.AuthCallback) => { if (err != null) { console.log('getAuthCallback err: ' + JSON.stringify(err)); return; } let result: appAccount.AuthResult = { account: { name: 'Lisi', owner: 'com.example.accountjsdemo', }, tokenInfo: { token: 'xxxxxx', authType: 'getSocialData' } }; callback.onResult(0, result); }); } catch (err) { console.log('getAuthCallback exception: ' + JSON.stringify(err)); } } } ``` ### getAuthCallback9+ getAuthCallback(sessionId: string): Promise<AuthCallback> 获取鉴权会话的认证器回调对象。使用Promise异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | --------- | ------ | ---- | -------- | | sessionId | string | 是 | 鉴权会话的标识。 | **返回值：** | 类型 | 说明 | | ------------------------------------ | --------------------- | | Promise<[AuthCallback](#authcallback9)> | Promise对象，返回鉴权会话的认证器回调对象。 | **错误码：** | 错误码ID | 错误信息 | | ------- | ------- | | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid sessionId. | | 12300108 | Session not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; import { Want, UIAbility, AbilityConstant } from '@kit.AbilityKit'; export default class EntryAbility extends UIAbility { onCreate(want: Want, param: AbilityConstant.LaunchParam) { // ability 生命周期函数 let sessionId: string = want.parameters![appAccount.Constants.KEY_SESSION_ID] as string; try { appAccountManager.getAuthCallback(sessionId).then((callback: appAccount.AuthCallback) => { let result: appAccount.AuthResult = { account: { name: 'Lisi', owner: 'com.example.accountjsdemo', }, tokenInfo: { token: 'xxxxxx', authType: 'getSocialData' } }; callback.onResult(0, result); }).catch((err: BusinessError) => { console.log('getAuthCallback err: ' + JSON.stringify(err)); }); } catch (err) { console.log('getAuthCallback exception: ' + JSON.stringify(err)); } } } ``` ### queryAuthenticatorInfo9+ queryAuthenticatorInfo(owner: string, callback: AsyncCallback<AuthenticatorInfo>): void 获取指定应用的认证器信息。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------------------------------------- | ---- | ----------- | | owner | string | 是 | 应用账号所有者的包名。 | | callback | AsyncCallback<[AuthenticatorInfo](#authenticatorinfo8)> | 是 | 回调函数。当获取成功时，err为null，data为认证器信息对象；否则为错误对象。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid owner. | | 12300113 | Authenticator service not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.queryAuthenticatorInfo('com.example.accountjsdemo', (err: BusinessError, info: appAccount.AuthenticatorInfo) => { if (err) { console.log('queryAuthenticatorInfo failed, error: ' + JSON.stringify(err)); } else { console.log('queryAuthenticatorInfo successfully, info: ' + JSON.stringify(info)); } }); } catch (err) { console.log('queryAuthenticatorInfo exception: ' + JSON.stringify(err)); } ``` ### queryAuthenticatorInfo9+ queryAuthenticatorInfo(owner: string): Promise<AuthenticatorInfo> 获取指定应用的认证器信息。使用Promise异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ----- | ------ | ---- | ----------- | | owner | string | 是 | 应用账号所有者的包名。 | **返回值：** | 类型 | 说明 | | -------------------------------- | --------------------- | | Promise<[AuthenticatorInfo](#authenticatorinfo8)> | Promise对象，返回指定应用的认证器信息对象。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid owner. | | 12300113 | Authenticator service not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.queryAuthenticatorInfo('com.example.accountjsdemo').then(( info: appAccount.AuthenticatorInfo) => { console.log('queryAuthenticatorInfo successfully, info: ' + JSON.stringify(info)); }).catch((err: BusinessError) => { console.log('queryAuthenticatorInfo failed, error: ' + JSON.stringify(err)); }); } catch (err) { console.log('queryAuthenticatorInfo exception: ' + JSON.stringify(err)); } ``` ### checkAccountLabels9+ checkAccountLabels(name: string, owner: string, labels: Array<string>, callback: AsyncCallback<boolean>): void 检查指定应用账号是否满足特定的标签集合。使用callback异步回调。该方法依赖目标应用的认证器提供标签检查的能力。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------------- | ------------------------- | ----- | --------------- | | name | string | 是 | 应用账号的名称。 | | owner | string | 是 | 应用账号所有者的包名。| | labels | Array<string> | 是 | 标签数组。 | | callback | AsyncCallback<boolean> | 是 | 回调函数。当检查成功时，err为null，data为true表示满足特定的标签集合，data为false表示不满足；否则为错误对象。 | **错误码：** | 错误码ID | 错误信息 | | ------- | ------- | | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid name, owner or labels. | | 12300003 | Account not found. | | 12300010 | Account service busy. | | 12300113 | Authenticator service not found. | | 12300114 | Authenticator service exception. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; let labels = ['student']; try { appAccountManager.checkAccountLabels('zhangsan', 'com.example.accountjsdemo', labels, (err: BusinessError, hasAllLabels: boolean) => { if (err) { console.log('checkAccountLabels failed, error: ' + JSON.stringify(err)); } else { console.log('checkAccountLabels successfully, hasAllLabels: ' + hasAllLabels); } }); } catch (err) { console.log('checkAccountLabels exception: ' + JSON.stringify(err)); } ``` ### checkAccountLabels9+ checkAccountLabels(name: string, owner: string, labels: Array<string>): Promise<boolean> 检查指定应用账号是否满足特定的标签集合。使用Promise异步回调。该方法依赖目标应用的认证器提供标签检查的能力。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------------- | ------------------------- | ----- | --------------- | | name | string | 是 | 应用账号的名称。 | | owner | string | 是 | 应用账号所有者的包名。| | labels | Array<string> | 是 | 标签数组。 | **返回值：** | 类型 | 说明 | | ------------------- | -------------------------------- | | Promise<boolean> | Promise对象。返回true表示指定账号满足特定的标签集合，返回false表示不满足。 | **错误码：** | 错误码ID | 错误信息 | | ------- | ------- | | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid name, owner or labels. | | 12300003 | Account not found. | | 12300010 | Account service busy. | | 12300113 | Authenticator service not found. | | 12300114 | Authenticator service exception. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; let labels = ['student']; try { appAccountManager.checkAccountLabels('zhangsan', 'com.example.accountjsdemo', labels).then(( hasAllLabels: boolean) => { console.log('checkAccountLabels successfully: ' + hasAllLabels); }).catch((err: BusinessError) => { console.log('checkAccountLabels failed, error: ' + JSON.stringify(err)); }); } catch (err) { console.log('checkAccountLabels exception: ' + JSON.stringify(err)); } ``` ### deleteCredential9+ deleteCredential(name: string, credentialType: string, callback: AsyncCallback<void>): void 删除指定应用账号的特定类型的凭据信息。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------------- | ------------------------- | ----- | -------------- | | name | string | 是 | 应用账号的名称。 | | credentialType | string | 是 | 凭据类型。 | | callback | AsyncCallback<void> | 是 | 回调函数。当删除成功时，err为null；否则为错误对象。 | **错误码：** | 错误码ID | 错误信息 | | ------- | ------- | | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid name or credentialType. | | 12300003 | Account not found. | | 12300102 | Credential not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.deleteCredential('zhangsan', 'PIN_SIX', (err: BusinessError) => { if (err) { console.log('deleteCredential failed, error: ' + JSON.stringify(err)); } else { console.log('deleteCredential successfully'); } }); } catch (err) { console.log('deleteCredential exception: ' + JSON.stringify(err)); } ``` ### deleteCredential9+ deleteCredential(name: string, credentialType: string): Promise<void> 删除指定应用账号的特定类型的凭据信息。使用Promise异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------------- | ------ | ----- | --------------- | | name | string | 是 | 应用账号的名称。 | | credentialType | string | 是 | 凭据类型。 | **返回值：** | 类型 | 说明 | | ------------------- | -------------------------------- | | Promise<void> | 无返回结果的Promise对象。 | **错误码：** | 错误码ID | 错误信息 | | ------- | ------- | | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid name or credentialType. | | 12300003 | Account not found. | | 12300102 | Credential not found. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; try { appAccountManager.deleteCredential('zhangsan', 'PIN_SIX').then(() => { console.log('deleteCredential successfully'); }).catch((err: BusinessError) => { console.log('deleteCredential failed, error: ' + JSON.stringify(err)); }); } catch (err) { console.log('deleteCredential exception: ' + JSON.stringify(err)); } ``` ### selectAccountsByOptions9+ selectAccountsByOptions(options: SelectAccountsOptions, callback: AsyncCallback<Array<AppAccountInfo>>): void 根据选项选择调用方可访问的账号列表。使用callback异步回调。如果选项中包含标签约束，则该方法依赖目标应用的认证器提供标签检查的能力。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------------- | ----------------------------------- | ----- | --------------- | | options | [SelectAccountsOptions](#selectaccountsoptions9) | 是 | 选择账号的选项。 | | callback | AsyncCallback<Array<[AppAccountInfo](#appaccountinfo)>> | 是 | 回调函数。当根据选项选择请求方可访问的账号列表时，err为null，data为可访问的账号信息对象；否则为错误对象。 | **错误码：** | 错误码ID | 错误信息 | | ------- | ------- | | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid options. | | 12300010 | Account service busy. | | 12300114 | Authenticator service exception. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; let options: appAccount.SelectAccountsOptions = { allowedOwners: [ 'com.example.accountjsdemo' ], requiredLabels: [ 'student' ] }; try { appAccountManager.selectAccountsByOptions(options, (err: BusinessError, accountArr: appAccount.AppAccountInfo[]) => { if (err) { console.log('selectAccountsByOptions failed, error: ' + JSON.stringify(err)); } else { console.log('selectAccountsByOptions successfully, accountArr: ' + JSON.stringify(accountArr)); } }); } catch (err) { console.log('selectAccountsByOptions exception: ' + JSON.stringify(err)); } ``` ### selectAccountsByOptions9+ selectAccountsByOptions(options: SelectAccountsOptions): Promise<Array<AppAccountInfo>> 根据选项选择调用方可访问的账号列表。使用Promise异步回调。如果选项中包含标签约束，则该方法依赖目标应用的认证器提供标签检查的能力。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------------- | ------------------------- | ----- | --------------- | | options | [SelectAccountsOptions](#selectaccountsoptions9) | 是 | 选择账号的选项。 | **返回值：** | 类型 | 说明 | | ------------------- | -------------------------------- | | Promise<[AppAccountInfo](#appaccountinfo)> | Promise对象，返回调用方可访问的账号列表。 | **错误码：** | 错误码ID | 错误信息 | | ------- | ------- | | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid options. | | 12300010 | Account service busy. | | 12300114 | Authenticator service exception. | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; let options: appAccount.SelectAccountsOptions = { allowedOwners: ['com.example.accountjsdemo'] }; try { appAccountManager.selectAccountsByOptions(options).then((accountArr: appAccount.AppAccountInfo[]) => { console.log('selectAccountsByOptions successfully, accountArr: ' + JSON.stringify(accountArr)); }).catch((err: BusinessError) => { console.log('selectAccountsByOptions failed, error: ' + JSON.stringify(err)); }); } catch (err) { console.log('selectAccountsByOptions exception: ' + JSON.stringify(err)); } ``` ### verifyCredential9+ verifyCredential(name: string, owner: string, callback: AuthCallback): void 验证指定账号的凭据。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | --------------------- | ----- | ----------------------- | | name | string | 是 | 应用账号的名称。 | | owner | string | 是 | 应用账号所有者的包名。 | | callback | [AuthCallback](#authcallback9) | 是 | 回调函数，返回验证结果。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid name or owner. | | 12300003 | Account not found. | | 12300010 | Account service busy. | | 12300113 | Authenticator service not found. | | 12300114 | Authenticator service exception. | **示例：** ```ts import { Want } from '@kit.AbilityKit'; try { appAccountManager.verifyCredential('zhangsan', 'com.example.accountjsdemo', { onResult: (resultCode: number, result?: appAccount.AuthResult) => { console.log('verifyCredential onResult, resultCode: ' + JSON.stringify(resultCode)); console.log('verifyCredential onResult, result: ' + JSON.stringify(result)); }, onRequestRedirected: (request: Want) => { console.log('verifyCredential onRequestRedirected, request: ' + JSON.stringify(request)); } }); } catch (err) { console.log('verifyCredential err: ' + JSON.stringify(err)); } ``` ### verifyCredential9+ verifyCredential(name: string, owner: string, options: VerifyCredentialOptions, callback: AuthCallback): void 验证用户凭据。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ----------------------- | ----- | ----------------------- | | name | string | 是 | 应用账号的名称。 | | owner | string | 是 | 应用账号所有者的包名。 | | options | [VerifyCredentialOptions](#verifycredentialoptions9) | 是 | 验证凭据的选项。 | | callback | [AuthCallback](#authcallback9) | 是 | 回调函数，返回验证结果。 | **错误码：** | 错误码ID | 错误信息| | ------- | -------| | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid name, owner or options. | | 12300003 | Account not found. | | 12300010 | Account service busy. | | 12300113 | Authenticator service not found. | | 12300114 | Authenticator service exception. | **示例：** ```ts import { Want } from '@kit.AbilityKit'; let options: appAccount.VerifyCredentialOptions = { credentialType: 'pin', credential: '123456' }; try { appAccountManager.verifyCredential('zhangsan', 'com.example.accountjsdemo', options, { onResult: (resultCode: number, result?: appAccount.AuthResult) => { console.log('verifyCredential onResult, resultCode: ' + JSON.stringify(resultCode)); console.log('verifyCredential onResult, result: ' + JSON.stringify(result)); }, onRequestRedirected: (request: Want) => { console.log('verifyCredential onRequestRedirected, request: ' + JSON.stringify(request)); } }); } catch (err) { console.log('verifyCredential err: ' + JSON.stringify(err)); } ``` ### setAuthenticatorProperties9+ setAuthenticatorProperties(owner: string, callback: AuthCallback): void 设置指定应用的认证器属性。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | --------------------- | ----- | ----------------------- | | owner | string | 是 | 认证器的所有者的包名。 | | callback | [AuthCallback](#authcallback9) | 是 | 回调函数，返回设置属性的结果。 | **错误码：** | 错误码ID | 错误信息 | | ------- | ------- | | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid owner. | | 12300010 | Account service busy. | | 12300113 | Authenticator service not found. | | 12300114 | Authenticator service exception. | **示例：** ```ts import { Want } from '@kit.AbilityKit'; try { appAccountManager.setAuthenticatorProperties('com.example.accountjsdemo', { onResult: (resultCode: number, result?: appAccount.AuthResult) => { console.log('setAuthenticatorProperties onResult, resultCode: ' + JSON.stringify(resultCode)); console.log('setAuthenticatorProperties onResult, result: ' + JSON.stringify(result)); }, onRequestRedirected: (request: Want) => { console.log('setAuthenticatorProperties onRequestRedirected, request: ' + JSON.stringify(request)); } }); } catch (err) { console.log('setAuthenticatorProperties err: ' + JSON.stringify(err)); } ``` ### setAuthenticatorProperties9+ setAuthenticatorProperties(owner: string, options: SetPropertiesOptions, callback: AuthCallback): void 设置认证器属性。使用callback异步回调。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | --------------------- | ----- | ----------------------- | | owner | string | 是 | 认证器的所有者的包名。 | | options | [SetPropertiesOptions](#setpropertiesoptions9) | 是 | 设置属性的选项。 | | callback | [AuthCallback](#authcallback9) | 是 | 认证器回调，返回设置属性的结果。 | **错误码：** | 错误码ID | 错误信息 | | ------- | ------- | | 401 |Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. | | 12300001 | System service exception. | | 12300002 | Invalid owner or options. | | 12300010 | Account service busy. | | 12300113 | Authenticator service not found. | | 12300114 | Authenticator service exception. | **示例：** ```ts import { Want } from '@kit.AbilityKit'; let options: appAccount.SetPropertiesOptions = { properties: {prop1: 'value1'} }; try { appAccountManager.setAuthenticatorProperties('com.example.accountjsdemo', options, { onResult: (resultCode: number, result?: appAccount.AuthResult) => { console.log('setAuthenticatorProperties onResult, resultCode: ' + JSON.stringify(resultCode)); console.log('setAuthenticatorProperties onResult, result: ' + JSON.stringify(result)); }, onRequestRedirected: (request: Want) => { console.log('setAuthenticatorProperties onRequestRedirected, request: ' + JSON.stringify(request)); } }); } catch (err) { console.log('setAuthenticatorProperties err: ' + JSON.stringify(err)); } ``` ### addAccount(deprecated) addAccount(name: string, callback: AsyncCallback<void>): void 根据账号名添加应用账号。使用callback异步回调。 > **说明：** > >从 API version 7开始支持，从API version 9开始废弃。建议使用[createAccount](#createaccount9)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------------------------- | ---- | -------------------- | | name | string | 是 | 应用账号的名称。 | | callback | AsyncCallback<void> | 是 | 回调函数。当创建成功时，err为null，否则为错误对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.addAccount('WangWu', (err: BusinessError) => { console.log('addAccount err: ' + JSON.stringify(err)); }); ``` ### addAccount(deprecated) addAccount(name: string, extraInfo: string, callback: AsyncCallback<void>): void 根据账号名和额外信息添加应用账号。使用callback异步回调。 > **说明：** > 从 API version 7开始支持，从API version 9开始废弃。建议使用[createAccount](#createaccount9-1)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | --------- | ------------------------- | ---- | ---------------------------------------- | | name | string | 是 | 应用账号的名称。 | | extraInfo | string | 是 | 额外信息(能转换string类型的其它信息)，额外信息不能是应用账号的敏感信息（如应用账号密码、token等）。 | | callback | AsyncCallback<void> | 是 | 回调函数。当创建成功时，err为null，否则为错误对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.addAccount('LiSi', 'token101', (err: BusinessError) => { console.log('addAccount err: ' + JSON.stringify(err)); }); ``` ### addAccount(deprecated) addAccount(name: string, extraInfo?: string): Promise<void> 根据账号名和额外信息添加应用账号。使用callback异步回调。使用Promise异步回调。 > **说明：** > 从 API version 7开始支持，从API version 9开始废弃。建议使用[createAccount](#createaccount9-2)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | --------- | ------ | ---- | ---------------------------------------- | | name | string | 是 | 应用账号的名称。 | | extraInfo | string | 否 | 额外信息(能转换string类型的其它信息)，额外信息不能是应用账号的敏感信息（如应用账号密码、token等），默认为空，表示创建的该账号无额外信息需要添加。 | **返回值：** | 类型 | 说明 | | ------------------- | --------------------- | | Promise<void> | 无返回结果的Promise对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.addAccount('LiSi', 'token101').then(()=> { console.log('addAccount Success'); }).catch((err: BusinessError) => { console.log('addAccount err: ' + JSON.stringify(err)); }); ``` ### addAccountImplicitly(deprecated) addAccountImplicitly(owner: string, authType: string, options: {[key: string]: any;}, callback: AuthenticatorCallback): void 根据指定的账号所有者隐式地添加应用账号。使用callback异步回调。 > **说明：** > > 从 API version 8开始支持，从API version 9开始废弃。建议使用[createAccountImplicitly](#createaccountimplicitly9)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | --------------------- | ---- | ----------------------- | | owner | string | 是 | 应用账号所有者的包名。 | | authType | string | 是 | 鉴权类型。鉴权类型为自定义。 | | options | {[key: string]: any} | 是 | 鉴权所需要的可选项。可选项可根据自己需要设置。 | | callback | [AuthenticatorCallback](#authenticatorcallbackdeprecated) | 是 | 认证器回调对象，返回添加结果。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; import { Want, common } from '@kit.AbilityKit'; let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext function onResultCallback(code: number, result: Record): void { console.log('resultCode: ' + code); console.log('result: ' + JSON.stringify(result)); } function onRequestRedirectedCallback(request: Want): void { let wantInfo: Want = { deviceId: '', bundleName: 'com.example.accountjsdemo', action: 'ohos.want.action.viewData', entities: ['entity.system.default'], } context.startAbility(wantInfo).then(() => { console.log('startAbility successfully'); }).catch((err: BusinessError) => { console.log('startAbility err: ' + JSON.stringify(err)); }) } appAccountManager.addAccountImplicitly('com.example.accountjsdemo', 'getSocialData', {}, { onResult: onResultCallback, onRequestRedirected: onRequestRedirectedCallback }); ``` ### deleteAccount(deprecated) deleteAccount(name: string, callback: AsyncCallback<void>): void 删除应用账号。使用callback异步回调。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃。建议使用[removeAccount](#removeaccount9)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------------------------- | ---- | ---------------- | | name | string | 是 | 应用账号的名称。 | | callback | AsyncCallback<void> | 是 | 回调函数。当删除成功时，err为null，否则为错误对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.deleteAccount('ZhaoLiu', (err: BusinessError) => { console.log('deleteAccount err: ' + JSON.stringify(err)); }); ``` ### deleteAccount(deprecated) deleteAccount(name: string): Promise<void> 删除应用账号。使用Promise异步回调。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃。建议使用[removeAccount](#removeaccount9)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---- | ------ | ---- | ----------- | | name | string | 是 | 应用账号的名称。 | **返回值：** | 类型 | 说明 | | :------------------ | :-------------------- | | Promise<void> | 无返回结果的Promise对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.deleteAccount('ZhaoLiu').then(() => { console.log('deleteAccount Success'); }).catch((err: BusinessError) => { console.log('deleteAccount err: ' + JSON.stringify(err)); }); ``` ### disableAppAccess(deprecated) disableAppAccess(name: string, bundleName: string, callback: AsyncCallback<void>): void 禁止指定第三方应用账号名称对指定的第三方应用进行访问。使用callback异步回调。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃。建议使用[setAppAccess](#setappaccess9)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------------------------- | ---- | --------------------------------- | | name | string | 是 | 应用账号的名称。 | | bundleName | string | 是 | 第三方应用的包名。 | | callback | AsyncCallback<void> | 是 | 回调函数。当禁止指定第三方应用账号名称对指定包名称的第三方应用进行访问设置成功时，err为null，否则为错误对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.disableAppAccess('ZhangSan', 'com.example.accountjsdemo', (err: BusinessError) => { console.log('disableAppAccess err: ' + JSON.stringify(err)); }); ``` ### disableAppAccess(deprecated) disableAppAccess(name: string, bundleName: string): Promise<void> 禁止指定第三方应用账号名称对指定包名称的第三方应用进行访问。使用Promise异步回调。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃。建议使用[setAppAccess](#setappaccess9-1)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | ---------------- | | name | string | 是 | 要禁用访问的第三方应用账号的名称。 | | bundleName | string | 是 | 第三方应用的包名。 | **返回值：** | 类型 | 说明 | | :------------------ | :-------------------- | | Promise<void> | 无返回结果的Promise对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.disableAppAccess('ZhangSan', 'com.example.accountjsdemo').then(() => { console.log('disableAppAccess Success'); }).catch((err: BusinessError) => { console.log('disableAppAccess err: ' + JSON.stringify(err)); }); ``` ### enableAppAccess(deprecated) enableAppAccess(name: string, bundleName: string, callback: AsyncCallback<void>): void 允许指定第三方应用账号名称对指定包名称的第三方应用进行访问。使用callback异步回调。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃。建议使用[setAppAccess](#setappaccess9)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------------------------- | ---- | --------------------------------- | | name | string | 是 | 应用账号的名称。 | | bundleName | string | 是 | 第三方应用的包名。 | | callback | AsyncCallback<void> | 是 | 回调函数。当允许指定第三方应用账号名称对指定包名称的第三方应用进行访问设置成功时，err为null，否则为错误对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.enableAppAccess('ZhangSan', 'com.example.accountjsdemo', (err: BusinessError) => { console.log('enableAppAccess: ' + JSON.stringify(err)); }); ``` ### enableAppAccess(deprecated) enableAppAccess(name: string, bundleName: string): Promise<void> 允许指定第三方应用账号的名称对指定包名称的第三方应用进行访问。使用Promise异步回调。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃。建议使用[setAppAccess](#setappaccess9-1)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | --------- | | name | string | 是 | 应用账号的名称。 | | bundleName | string | 是 | 第三方应用的包名。 | **返回值：** | 类型 | 说明 | | :------------------ | :-------------------- | | Promise<void> | 无返回结果的Promise对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.enableAppAccess('ZhangSan', 'com.example.accountjsdemo').then(() => { console.log('enableAppAccess Success'); }).catch((err: BusinessError) => { console.log('enableAppAccess err: ' + JSON.stringify(err)); }); ``` ### checkAppAccountSyncEnable(deprecated) checkAppAccountSyncEnable(name: string, callback: AsyncCallback<boolean>): void 检查指定应用账号是否开启数据同步功能。使用callback异步回调。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃。建议使用[checkDataSyncEnabled](#checkdatasyncenabled9)替代。 **需要权限：** ohos.permission.DISTRIBUTED_DATASYNC **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------------- | ---- | --------------------- | | name | string | 是 | 应用账号的名称。 | | callback | AsyncCallback<boolean> | 是 | 回调函数。返回true表示指定应用账号已开启数据同步功能；返回false表示未开启。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.checkAppAccountSyncEnable('ZhangSan', (err: BusinessError, result: boolean) => { console.log('checkAppAccountSyncEnable err: ' + JSON.stringify(err)); console.log('checkAppAccountSyncEnable result: ' + result); }); ``` ### checkAppAccountSyncEnable(deprecated) checkAppAccountSyncEnable(name: string): Promise<boolean> 检查指定应用账号是否开启数据同步功能。使用Promise异步回调。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃。建议使用[checkDataSyncEnabled](#checkdatasyncenabled9-1)替代。 **需要权限：** ohos.permission.DISTRIBUTED_DATASYNC **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---- | ------ | ---- | ------- | | name | string | 是 | 应用账号的名称。 | **返回值：** | 类型 | 说明 | | ---------------------- | --------------------- | | Promise<boolean> | Promise对象。返回true表示指定应用账号已开启数据同步功能；返回false表示未开启。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.checkAppAccountSyncEnable('ZhangSan').then((data: boolean) => { console.log('checkAppAccountSyncEnable, result: ' + data); }).catch((err: BusinessError) => { console.log('checkAppAccountSyncEnable err: ' + JSON.stringify(err)); }); ``` ### setAccountCredential(deprecated) setAccountCredential(name: string, credentialType: string, credential: string,callback: AsyncCallback<void>): void 设置指定应用账号的凭据。使用callback异步回调。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃，建议使用[setCredential](#setcredential9)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------------- | ------------------------- | ---- | ------------- | | name | string | 是 | 应用账号的名称。 | | credentialType | string | 是 | 凭据类型。 | | credential | string | 是 | 凭据取值。 | | callback | AsyncCallback<void> | 是 | 回调函数。当设置此应用程序账号的凭据成功时，err为null，否则为错误对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.setAccountCredential('ZhangSan', 'credentialType001', 'credential001', (err: BusinessError) => { console.log('setAccountCredential err: ' + JSON.stringify(err)); }); ``` ### setAccountCredential(deprecated) setAccountCredential(name: string, credentialType: string, credential: string): Promise<void> 设置指定应用账号的凭据。使用Promise异步回调。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃，建议使用[setCredential](#setcredential9-1)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------------- | ------ | ---- | ---------- | | name | string | 是 | 应用账号的名称。 | | credentialType | string | 是 | 凭据类型。 | | credential | string | 是 | 凭据取值。 | **返回值：** | 类型 | 说明 | | :------------------ | :-------------------- | | Promise<void> | 无返回结果的Promise对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.setAccountCredential('ZhangSan', 'credentialType001', 'credential001').then(() => { console.log('setAccountCredential Success'); }).catch((err: BusinessError) => { console.log('setAccountCredential err: ' + JSON.stringify(err)); }); ``` ### setAccountExtraInfo(deprecated) setAccountExtraInfo(name: string, extraInfo: string, callback: AsyncCallback<void>): void 设置指定应用账号的额外信息。使用callback异步回调。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃。建议使用[setCustomData](#setcustomdata9)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | --------- | ------------------------- | ---- | --------------- | | name | string | 是 | 应用账号的名称。 | | extraInfo | string | 是 | 额外信息(能转换string类型的其它信息)，额外信息不能是应用账号的敏感信息（如应用账号密码、token等）。 | | callback | AsyncCallback<void> | 是 | 回调函数。当设置成功时，err为null，否则为错误对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.setAccountExtraInfo('ZhangSan', 'Tk002', (err: BusinessError) => { console.log('setAccountExtraInfo err: ' + JSON.stringify(err)); }); ``` ### setAccountExtraInfo(deprecated) setAccountExtraInfo(name: string, extraInfo: string): Promise<void> 设置此应用程序账号的额外信息。使用Promise异步回调。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃。建议使用[setCustomData](#setcustomdata9-1)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | --------- | ------ | ---- | --------- | | name | string | 是 | 应用账号的名称。 | | extraInfo | string | 是 | 额外信息(能转换string类型的其它信息)，额外信息不能是应用账号的敏感信息（如应用账号密码、token等）。 | **返回值：** | 类型 | 说明 | | :------------------ | :-------------------- | | Promise<void> | 无返回结果的Promise对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.setAccountExtraInfo('ZhangSan', 'Tk002').then(() => { console.log('setAccountExtraInfo Success'); }).catch((err: BusinessError) => { console.log('setAccountExtraInfo err: ' + JSON.stringify(err)); }); ``` ### setAppAccountSyncEnable(deprecated) setAppAccountSyncEnable(name: string, isEnable: boolean, callback: AsyncCallback<void>): void 开启或禁止指定应用账号的数据同步功能。使用callback异步回调。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃。建议使用[setDataSyncEnabled](#setdatasyncenabled9)替代。 **需要权限：** ohos.permission.DISTRIBUTED_DATASYNC **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------------------------- | ---- | ------------------------- | | name | string | 是 | 应用账号的名称。 | | isEnable | boolean | 是 | 是否开启数据同步。 | | callback | AsyncCallback<void> | 是 | 回调函数。当开启或禁止成功时，err为null，否则为错误对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.setAppAccountSyncEnable('ZhangSan', true, (err: BusinessError) => { console.log('setAppAccountSyncEnable err: ' + JSON.stringify(err)); }); ``` ### setAppAccountSyncEnable(deprecated) setAppAccountSyncEnable(name: string, isEnable: boolean): Promise<void> 开启或禁止指定应用账号的数据同步功能。使用Promise异步回调。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃。建议使用[setDataSyncEnabled](#setdatasyncenabled9-1)替代。 **需要权限：** ohos.permission.DISTRIBUTED_DATASYNC **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------- | ---- | ----------- | | name | string | 是 | 应用账号的名称。 | | isEnable | boolean | 是 | 是否开启数据同步。 | **返回值：** | 类型 | 说明 | | :------------------ | :-------------------- | | Promise<void> | 无返回结果的Promise对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager .setAppAccountSyncEnable('ZhangSan', true).then(() => { console.log('setAppAccountSyncEnable Success'); }).catch((err: BusinessError) => { console.log('setAppAccountSyncEnable err: ' + JSON.stringify(err)); }); ``` ### setAssociatedData(deprecated) setAssociatedData(name: string, key: string, value: string, callback: AsyncCallback<void>): void 设置指定应用账号的关联数据。使用callback异步回调。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃。建议使用[setCustomData](#setcustomdata9)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------------------------- | ---- | ----------------- | | name | string | 是 | 应用账号的名称。 | | key | string | 是 | 关联数据的键名。 | | value | string | 是 | 关联数据的取值。 | | callback | AsyncCallback<void> | 是 | 回调函数。当设置与此应用账号关联的数据成功时，err为null，否则为错误对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.setAssociatedData('ZhangSan', 'k001', 'v001', (err: BusinessError) => { console.log('setAssociatedData err: ' + JSON.stringify(err)); }); ``` ### setAssociatedData(deprecated) setAssociatedData(name: string, key: string, value: string): Promise<void> 设置指定应用账号的关联数据。使用Promise异步回调。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃。建议使用[setCustomData](#setcustomdata9-1)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ----- | ------ | ---- | ----------------- | | name | string | 是 | 应用账号的名称。 | | key | string | 是 | 关联数据的键名。 | | value | string | 是 | 关联数据的取值。 | **返回值：** | 类型 | 说明 | | :------------------ | :-------------------- | | Promise<void> | 无返回结果的Promise对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.setAssociatedData('ZhangSan', 'k001', 'v001').then(() => { console.log('setAssociatedData Success'); }).catch((err: BusinessError) => { console.log('setAssociatedData err: ' + JSON.stringify(err)); }); ``` ### getAllAccessibleAccounts(deprecated) getAllAccessibleAccounts(callback: AsyncCallback<Array<AppAccountInfo>>): void 获取所有可访问的应用账号信息。使用callback异步回调。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃。建议使用[getAllAccounts](#getallaccounts9)替代。 **需要权限：** ohos.permission.GET_ALL_APP_ACCOUNTS，该权限仅系统应用可申请。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------------------------- | ---- | --------- | | callback | AsyncCallback<Array<[AppAccountInfo](#appaccountinfo)>> | 是 | 回调函数。当查询成功时，err为null，data为获取到的应用账号信息列表；否则为错误对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.getAllAccessibleAccounts((err: BusinessError, data: appAccount.AppAccountInfo[])=>{ console.debug('getAllAccessibleAccounts err: ' + JSON.stringify(err)); console.debug('getAllAccessibleAccounts data: ' + JSON.stringify(data)); }); ``` ### getAllAccessibleAccounts(deprecated) getAllAccessibleAccounts(): Promise<Array<AppAccountInfo>> 获取所有可访问的应用账号信息。使用Promise异步回调。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃。建议使用[getAllAccounts](#getallaccounts9-1)替代。 **需要权限：** ohos.permission.GET_ALL_APP_ACCOUNTS，该权限仅系统应用可申请。 **系统能力：** SystemCapability.Account.AppAccount **返回值：** | 类型 | 说明 | | ---------------------------------------- | --------------------- | | Promise<Array<[AppAccountInfo](#appaccountinfo)>> | Promise对象，返回全部应用已授权账号信息对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.getAllAccessibleAccounts().then((data: appAccount.AppAccountInfo[]) => { console.log('getAllAccessibleAccounts: ' + data); }).catch((err: BusinessError) => { console.log('getAllAccessibleAccounts err: ' + JSON.stringify(err)); }); ``` ### getAllAccounts(deprecated) getAllAccounts(owner: string, callback: AsyncCallback<Array<AppAccountInfo>>): void 根据应用账号所有者获取调用方可访问的应用账号列表。使用callback异步回调。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃。建议使用[getAccountsByOwner](#getaccountsbyowner9)替代。 **需要权限：** ohos.permission.GET_ALL_APP_ACCOUNTS，该权限仅系统应用可申请。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------------------------- | ---- | --------- | | owner | string | 是 | 应用账号所有者的包名。 | | callback | AsyncCallback<Array<[AppAccountInfo](#appaccountinfo)>> | 是 | 应用账号信息列表。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; const selfBundle = 'com.example.actsgetallaaccounts'; appAccountManager.getAllAccounts(selfBundle, (err: BusinessError, data: appAccount.AppAccountInfo[])=>{ console.debug('getAllAccounts err: ' + JSON.stringify(err)); console.debug('getAllAccounts data:' + JSON.stringify(data)); }); ``` ### getAllAccounts(deprecated) getAllAccounts(owner: string): Promise<Array<AppAccountInfo>> 根据应用账号所有者获取调用方可访问的应用账号列表。使用Promise异步回调。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃。建议使用[getAccountsByOwner](#getaccountsbyowner9-1)替代。 **需要权限：** ohos.permission.GET_ALL_APP_ACCOUNTS，该权限仅系统应用可申请。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ----- | ------ | ---- | ------ | | owner | string | 是 | 应用账号所有者的包名。 | **返回值：** | 类型 | 说明 | | ---------------------------------------- | --------------------- | | Promise<Array<[AppAccountInfo](#appaccountinfo)>> | Promise对象，返回指定应用全部账号信息对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; const selfBundle = 'com.example.actsgetallaaccounts'; appAccountManager.getAllAccounts(selfBundle).then((data: appAccount.AppAccountInfo[]) => { console.log('getAllAccounts: ' + data); }).catch((err: BusinessError) => { console.log('getAllAccounts err: ' + JSON.stringify(err)); }); ``` ### getAccountCredential(deprecated) getAccountCredential(name: string, credentialType: string, callback: AsyncCallback<string>): void 获取指定应用账号的凭据。使用callback异步回调。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃。建议使用[getCredential](#getcredential9)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------------- | --------------------------- | ---- | -------------- | | name | string | 是 | 应用账号的名称。 | | credentialType | string | 是 | 凭据类型。 | | callback | AsyncCallback<string> | 是 | 回调函数。当获取凭据成功时，err为null，data为指定应用账号的凭据；否则为错误对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.getAccountCredential('ZhangSan', 'credentialType001', (err: BusinessError, result: string) => { console.log('getAccountCredential err: ' + JSON.stringify(err)); console.log('getAccountCredential result: ' + result); }); ``` ### getAccountCredential(deprecated) getAccountCredential(name: string, credentialType: string): Promise<string> 获取指定应用账号的凭据。使用Promise异步回调。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃。建议使用[getCredential](#getcredential9-1)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------------- | ------ | ---- | ---------- | | name | string | 是 | 应用账号的名称。 | | credentialType | string | 是 | 凭据类型。 | **返回值：** | 类型 | 说明 | | :-------------------- | :-------------------- | | Promise<string> | Promise对象，返回指定应用账号的凭据。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.getAccountCredential('ZhangSan', 'credentialType001').then((data: string) => { console.log('getAccountCredential, result: ' + data); }).catch((err: BusinessError) => { console.log('getAccountCredential err: ' + JSON.stringify(err)); }); ``` ### getAccountExtraInfo(deprecated) getAccountExtraInfo(name: string, callback: AsyncCallback<string>): void 获取指定应用账号的额外信息（能转换成string类型的其它信息）。使用callback异步回调。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃。建议使用[getCustomData](#getcustomdata9)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | --------------------------- | ---- | --------------- | | name | string | 是 | 应用账号的名称。 | | callback | AsyncCallback<string> | 是 | 回调函数。当获取此应用账号的额外信息成功时，err为null，data返回此应用账号的额外信息对象；否则为错误对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.getAccountExtraInfo('ZhangSan', (err: BusinessError, result: string) => { console.log('getAccountExtraInfo err: ' + JSON.stringify(err)); console.log('getAccountExtraInfo result: ' + result); }); ``` ### getAccountExtraInfo(deprecated) getAccountExtraInfo(name: string): Promise<string> 获取指定应用账号的额外信息（能转换成string类型的其它信息）。使用Promise异步回调。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃。建议使用[getCustomData](#getcustomdata9-1)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---- | ------ | ---- | ------- | | name | string | 是 | 应用账号的名称。 | **返回值：** | 类型 | 说明 | | :-------------------- | :-------------------- | | Promise<string> | Promise对象，返回此应用程序账号的额外信息对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.getAccountExtraInfo('ZhangSan').then((data: string) => { console.log('getAccountExtraInfo, result: ' + data); }).catch((err: BusinessError) => { console.log('getAccountExtraInfo err: ' + JSON.stringify(err)); }); ``` ### getAssociatedData(deprecated) getAssociatedData(name: string, key: string, callback: AsyncCallback<string>): void 根据指定键名获取特定应用账号的关联数据。使用callback异步回调。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃。建议使用[getCustomData](#getcustomdata9)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | --------------------------- | ---- | ----------------- | | name | string | 是 | 应用账号的名称。 | | key | string | 是 | 关联数据的键名。 | | callback | AsyncCallback<string> | 是 | 回调函数。当获取成功时，err为null，data为关联数据的取值；否则为错误对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.getAssociatedData('ZhangSan', 'k001', (err: BusinessError, result: string) => { console.log('getAssociatedData err: ' + JSON.stringify(err)); console.log('getAssociatedData result: ' + result); }); ``` ### getAssociatedData(deprecated) getAssociatedData(name: string, key: string): Promise<string> 获取与此应用程序账号关联的数据。使用Promise异步回调。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃。建议使用[getCustomData](#getcustomdata9-1)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---- | ------ | ---- | --------- | | name | string | 是 | 应用账号的名称。 | | key | string | 是 | 关联数据的键名。 | **返回值：** | 类型 | 说明 | | :-------------------- | :-------------------- | | Promise<string> | Promise对象，返回关联数据的取值。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.getAssociatedData('ZhangSan', 'k001').then((data: string) => { console.log('getAssociatedData: ' + data); }).catch((err: BusinessError) => { console.log('getAssociatedData err: ' + JSON.stringify(err)); }); ``` ### on('change')(deprecated) on(type: 'change', owners: Array<string>, callback: Callback<Array<AppAccountInfo>>): void 订阅指定应用的账号信息变更事件。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃。建议使用[on('accountChange')](#onaccountchange9)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------------------------- | ---- | ------------------------------ | | type | 'change' | 是 | 事件回调类型，支持的事件为'change'，当账号所有者更新账号信息时，触发该事件。 | | owners | Array<string> | 是 | 应用账号所有者的包名列表。 | | callback | Callback<Array<[AppAccountInfo](#appaccountinfo)>> | 是 | 需要注册的回调函数，返回信息发生变更的应用账号列表。 | **示例：** ```ts function changeOnCallback(data: appAccount.AppAccountInfo[]): void { console.debug('receive change data:' + JSON.stringify(data)); } try{ appAccountManager.on('change', ['com.example.actsaccounttest'], changeOnCallback); } catch(err){ console.error('on accountOnOffDemo err:' + JSON.stringify(err)); } ``` ### off('change')(deprecated) off(type: 'change', callback?: Callback<Array<AppAccountInfo>>): void 取消订阅账号信息变更事件。 > **说明：** > > 从 API version 7开始支持，从API version 9开始废弃。建议使用[off('accountChange')](#offaccountchange9)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------------------------------- | ---- | ------------ | | type | 'change' | 是 | 事件回调类型，支持的事件为'change'，当账号所有者更新账号信息时，触发该事件。 | | callback | Callback<Array<[AppAccountInfo](#appaccountinfo)>> | 否 | 需要注销的回调函数，默认为空，表示取消该类型事件的所有回调。 | **示例：** ```ts function changeOnCallback(data: appAccount.AppAccountInfo[]): void { console.debug('receive change data: ' + JSON.stringify(data)); appAccountManager.off('change', () => { console.debug('off finish'); }) } try{ appAccountManager.on('change', ['com.example.actsaccounttest'], changeOnCallback); } catch(err){ console.error('on accountOnOffDemo err: ' + JSON.stringify(err)); } ``` ### authenticate(deprecated) authenticate(name: string, owner: string, authType: string, options: {[key: string]: any;}, callback: AuthenticatorCallback): void 对应用账号进行鉴权以获取授权令牌。使用callback异步回调。 > **说明：** > > 从 API version 8开始支持，从API version 9开始废弃。建议使用[auth](#auth9)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | --------------------- | ---- | --------------- | | name | string | 是 | 应用账号的名称。 | | owner | string | 是 | 应用账号所有者的包名。 | | authType | string | 是 | 鉴权类型。 | | options | {[key: string]: any} | 是 | 鉴权所需的可选项。 | | callback | [AuthenticatorCallback](#authenticatorcallbackdeprecated) | 是 | 回调对象，返回鉴权结果。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; import { Want, common } from '@kit.AbilityKit'; let context = getContext(this) as common.UIAbilityContext; // UIAbilityContext function onResultCallback(code: number, result: Record): void { console.log('resultCode: ' + code); console.log('result: ' + JSON.stringify(result)); } function onRequestRedirectedCallback(request: Want): void { let wantInfo: Want = { deviceId: '', bundleName: 'com.example.accountjsdemo', action: 'ohos.want.action.viewData', entities: ['entity.system.default'], } context.startAbility(wantInfo).then(() => { console.log('startAbility successfully'); }).catch((err: BusinessError) => { console.log('startAbility err: ' + JSON.stringify(err)); }) } appAccountManager.authenticate('LiSi', 'com.example.accountjsdemo', 'getSocialData', {}, { onResult: onResultCallback, onRequestRedirected: onRequestRedirectedCallback }); ``` ### getOAuthToken(deprecated) getOAuthToken(name: string, owner: string, authType: string, callback: AsyncCallback<string>): void 获取指定应用账号的特定鉴权类型的授权令牌。使用callback异步回调。 > **说明：** > > 从 API version 8开始支持，从API version 9开始废弃。建议使用[getAuthToken](#getauthtoken9)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | --------------------------- | ---- | ----------- | | name | string | 是 | 应用账号的名称。 | | owner | string | 是 | 应用账号所有者的包名。 | | authType | string | 是 | 鉴权类型。 | | callback | AsyncCallback<string> | 是 | 回调函数。当获取成功时，err为null，data为授权令牌值；否则为错误对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.getOAuthToken('LiSi', 'com.example.accountjsdemo', 'getSocialData', (err: BusinessError, data: string) => { console.log('getOAuthToken err: ' + JSON.stringify(err)); console.log('getOAuthToken token: ' + data); }); ``` ### getOAuthToken(deprecated) getOAuthToken(name: string, owner: string, authType: string): Promise<string> 获取指定应用账号的特定鉴权类型的授权令牌。使用Promise异步回调。 > **说明：** > > 从 API version 8开始支持，从API version 9开始废弃。建议使用[getAuthToken](#getauthtoken9-1)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------ | ---- | ----------- | | name | string | 是 | 应用账号的名称。 | | owner | string | 是 | 应用账号所有者的包名。 | | authType | string | 是 | 鉴权类型。 | **返回值：** | 类型 | 说明 | | --------------------- | --------------------- | | Promise<string> | Promise对象，返回授权令牌。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.getOAuthToken('LiSi', 'com.example.accountjsdemo', 'getSocialData').then((data: string) => { console.log('getOAuthToken token: ' + data); }).catch((err: BusinessError) => { console.log('getOAuthToken err: ' + JSON.stringify(err)); }); ``` ### setOAuthToken(deprecated) setOAuthToken(name: string, authType: string, token: string, callback: AsyncCallback<void>): void 为指定应用账号设置特定鉴权类型的授权令牌。使用callback异步回调。 > **说明：** > > 从 API version 8开始支持，从API version 9开始废弃。建议使用[setAuthToken](#setauthtoken9)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------------------------- | ---- | -------- | | name | string | 是 | 应用账号的名称。 | | authType | string | 是 | 鉴权类型。 | | token | string | 是 | 授权令牌。 | | callback | AsyncCallback<void> | 是 | 回调函数。当设置成功时，err为null；否则为错误对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.setOAuthToken('LiSi', 'getSocialData', 'xxxx', (err: BusinessError) => { console.log('setOAuthToken err: ' + JSON.stringify(err)); }); ``` ### setOAuthToken(deprecated) setOAuthToken(name: string, authType: string, token: string): Promise<void> 为指定应用账号设置特定鉴权类型的授权令牌。使用Promise异步回调。 > **说明：** > > 从 API version 8开始支持，从API version 9开始废弃。建议使用[setAuthToken](#setauthtoken9-1)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------ | ---- | -------- | | name | string | 是 | 应用账号的名称。 | | authType | string | 是 | 鉴权类型。 | | token | string | 是 | 授权令牌。 | **返回值：** | 类型 | 说明 | | ------------------- | --------------------- | | Promise<void> | 无返回结果的Promise对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.setOAuthToken('LiSi', 'getSocialData', 'xxxx').then(() => { console.log('setOAuthToken successfully'); }).catch((err: BusinessError) => { console.log('setOAuthToken err: ' + JSON.stringify(err)); }); ``` ### deleteOAuthToken(deprecated) deleteOAuthToken(name: string, owner: string, authType: string, token: string, callback: AsyncCallback<void>): void 删除指定应用账号的特定鉴权类型的授权令牌。使用callback异步回调。 > **说明：** > > 从 API version 8开始支持，从API version 9开始废弃。建议使用[deleteAuthToken](#deleteauthtoken9)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------------------------- | ---- | ------------ | | name | string | 是 | 应用账号的名称。 | | owner | string | 是 | 应用账号所有者的包名。 | | authType | string | 是 | 鉴权类型。 | | token | string | 是 | 授权令牌。 | | callback | AsyncCallback<void> | 是 | 回调函数。当删除成功时，err为null；否则为错误对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.deleteOAuthToken('LiSi', 'com.example.accountjsdemo', 'getSocialData', 'xxxxx', (err: BusinessError) => { console.log('deleteOAuthToken err: ' + JSON.stringify(err)); }); ``` ### deleteOAuthToken(deprecated) deleteOAuthToken(name: string, owner: string, authType: string, token: string): Promise<void> 删除指定应用账号的特定鉴权类型的授权令牌。使用Promise异步回调。 > **说明：** > > 从 API version 8开始支持，从API version 9开始废弃。建议使用[deleteAuthToken](#deleteauthtoken9-1)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------ | ---- | ------------ | | name | string | 是 | 应用账号的名称。 | | owner | string | 是 | 应用账号所有者的包名。 | | authType | string | 是 | 鉴权类型。 | | token | string | 是 | 授权令牌。 | **返回值：** | 类型 | 说明 | | ------------------- | --------------------- | | Promise<void> | 无返回结果的Promise对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.deleteOAuthToken('LiSi', 'com.example.accountjsdemo', 'getSocialData', 'xxxxx').then(() => { console.log('deleteOAuthToken successfully'); }).catch((err: BusinessError) => { console.log('deleteOAuthToken err: ' + JSON.stringify(err)); }); ``` ### setOAuthTokenVisibility(deprecated) setOAuthTokenVisibility(name: string, authType: string, bundleName: string, isVisible: boolean, callback: AsyncCallback<void>): void 设置指定账号的特定鉴权类型的授权令牌对指定应用的可见性。使用callback异步回调。 > **说明：** > > 从 API version 8开始支持，从API version 9开始废弃。建议使用[setAuthTokenVisibility](#setauthtokenvisibility9)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------------------------- | ---- | ------------------------- | | name | string | 是 | 应用账号的名称。 | | authType | string | 是 | 鉴权类型。 | | bundleName | string | 是 | 被设置可见性的应用包名。 | | isVisible | boolean | 是 | 是否可见。true表示可见，false表示不可见。 | | callback | AsyncCallback<void> | 是 | 回调函数。当设置成功时，err为null；否则为错误对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.setOAuthTokenVisibility('LiSi', 'getSocialData', 'com.example.accountjsdemo', true, (err: BusinessError) => { console.log('setOAuthTokenVisibility err: ' + JSON.stringify(err)); }); ``` ### setOAuthTokenVisibility(deprecated) setOAuthTokenVisibility(name: string, authType: string, bundleName: string, isVisible: boolean): Promise<void> 设置指定账号的特定鉴权类型的授权令牌对指定应用的可见性。使用Promise异步回调。 > **说明：** > > 从 API version 8开始支持，从API version 9开始废弃。建议使用[setAuthTokenVisibility](#setauthtokenvisibility9-1)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------- | ---- | ------------ | | name | string | 是 | 应用账号的名称。 | | authType | string | 是 | 鉴权类型。 | | bundleName | string | 是 | 被设置可见性的应用包名。 | | isVisible | boolean | 是 | 是否可见。true表示可见，false表示不可见。 | **返回值：** | 类型 | 说明 | | ------------------- | --------------------- | | Promise<void> | 无返回结果的Promise对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.setOAuthTokenVisibility('LiSi', 'getSocialData', 'com.example.accountjsdemo', true).then(() => { console.log('setOAuthTokenVisibility successfully'); }).catch((err: BusinessError) => { console.log('setOAuthTokenVisibility err: ' + JSON.stringify(err)); }); ``` ### checkOAuthTokenVisibility(deprecated) checkOAuthTokenVisibility(name: string, authType: string, bundleName: string, callback: AsyncCallback<boolean>): void 检查指定应用账号的特定鉴权类型的授权令牌对指定应用的可见性。使用callback异步回调。 > **说明：** > > 从 API version 8开始支持，从API version 9开始废弃。建议使用[checkAuthTokenVisibility](#checkauthtokenvisibility9)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---------- | ---------------------------- | ---- | ----------- | | name | string | 是 | 应用账号的名称。 | | authType | string | 是 | 鉴权类型。 | | bundleName | string | 是 | 检查可见性的应用包名。 | | callback | AsyncCallback<boolean> | 是 | 回调函数。当检查成功时，err为null，data为true表示可见，data为false表示不可见；否则为错误对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.checkOAuthTokenVisibility('LiSi', 'getSocialData', 'com.example.accountjsdemo', (err: BusinessError, data: boolean) => { console.log('checkOAuthTokenVisibility err: ' + JSON.stringify(err)); console.log('checkOAuthTokenVisibility isVisible: ' + data); }); ``` ### checkOAuthTokenVisibility(deprecated) checkOAuthTokenVisibility(name: string, authType: string, bundleName: string): Promise<boolean> 检查指定应用账号的特定鉴权类型的授权令牌对指定应用的可见性。使用Promise异步回调。 > **说明：** > > 从 API version 8开始支持，从API version 9开始废弃。建议使用[checkAuthTokenVisibility](#checkauthtokenvisibility9-1)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---------- | ------ | ---- | ------------- | | name | string | 是 | 应用账号的名称。 | | authType | string | 是 | 鉴权类型。 | | bundleName | string | 是 | 用于检查可见性的应用包名。 | **返回值：** | 类型 | 说明 | | ---------------------- | --------------------- | | Promise<boolean> | Promise对象。返回true表示指定鉴权类型的OAuth令牌对特定应用的可见，返回false表示不可见。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.checkOAuthTokenVisibility('LiSi', 'getSocialData', 'com.example.accountjsdemo').then(( data: boolean) => { console.log('checkOAuthTokenVisibility isVisible: ' + data); }).catch((err: BusinessError) => { console.log('checkOAuthTokenVisibility err: ' + JSON.stringify(err)); }); ``` ### getAllOAuthTokens(deprecated) getAllOAuthTokens(name: string, owner: string, callback: AsyncCallback<Array<OAuthTokenInfo>>): void 获取指定账号对调用方可见的所有授权令牌。使用callback异步回调。 > **说明：** > > 从 API version 8开始支持，从API version 9开始废弃。建议使用[getAllAuthTokens](#getallauthtokens9)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------------------------- | ---- | ----------- | | name | string | 是 | 应用账号的名称。 | | owner | string | 是 | 应用账号所有者的包名。 | | callback | AsyncCallback<Array<[OAuthTokenInfo](#oauthtokeninfodeprecated)>> | 是 | 回调函数。当获取成功时，err为null，data为授权令牌数组；否则为错误对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.getAllOAuthTokens('LiSi', 'com.example.accountjsdemo', (err: BusinessError, data: appAccount.OAuthTokenInfo[]) => { console.log('getAllOAuthTokens err: ' + JSON.stringify(err)); console.log('getAllOAuthTokens data: ' + JSON.stringify(data)); }); ``` ### getAllOAuthTokens(deprecated) getAllOAuthTokens(name: string, owner: string): Promise<Array<OAuthTokenInfo>> 获取指定账号对调用方可见的所有授权令牌。使用Promise异步回调。 > **说明：** > > 从 API version 8开始支持，从API version 9开始废弃。建议使用[getAllAuthTokens](#getallauthtokens9-1)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ----- | ------ | ---- | ----------- | | name | string | 是 | 应用账号的名称。 | | owner | string | 是 | 应用账号所有者的包名。 | **返回值：** | 类型 | 说明 | | ---------------------------------------- | --------------------- | | Promise<Array< [OAuthTokenInfo](#oauthtokeninfodeprecated)>> | Promise对象，返回授权令牌数组。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.getAllOAuthTokens('LiSi', 'com.example.accountjsdemo').then(( data: appAccount.OAuthTokenInfo[]) => { console.log('getAllOAuthTokens data: ' + JSON.stringify(data)); }).catch((err: BusinessError) => { console.log('getAllOAuthTokens err: ' + JSON.stringify(err)); }); ``` ### getOAuthList(deprecated) getOAuthList(name: string, authType: string, callback: AsyncCallback<Array<string>>): void 获取指定应用账号的特定鉴权类型的授权列表，即被授权的包名数组（令牌的授权列表通过setOAuthTokenVisibility(#setoauthtokenvisibilitydeprecated)来设置）。使用callback异步回调。 > **说明：** > > 从 API version 8开始支持，从API version 9开始废弃。建议使用[getAuthList](#getauthlist9)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------------------------- | ---- | ----------------------- | | name | string | 是 | 应用账号的名称。 | | authType | string | 是 | 鉴权类型。 | | callback | AsyncCallback<Array<string>> | 是 | 回调函数。当获取成功时，err为null，data为被授权的包名数组；否则为错误对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.getOAuthList('LiSi', 'getSocialData', (err: BusinessError, data: string[]) => { console.log('getOAuthList err: ' + JSON.stringify(err)); console.log('getOAuthList data: ' + JSON.stringify(data)); }); ``` ### getOAuthList(deprecated) getOAuthList(name: string, authType: string): Promise<Array<string>> 获取指定应用账号的特定鉴权类型的授权列表，即被授权的包名数组（令牌的授权列表通过setOAuthTokenVisibility(#setoauthtokenvisibilitydeprecated)来设置）。使用Promise异步回调。 > **说明：** > > 从 API version 8开始支持，从API version 9开始废弃。建议使用[getAuthList](#getauthlist9-1)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | ------ | ---- | ----------------------- | | name | string | 是 | 应用账号的名称。 | | authType | string | 是 | 鉴权类型。 | **返回值：** | 类型 | 说明 | | ---------------------------------- | --------------------- | | Promise<Array<string>> | Promise对象，返回被授权的包名数组。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.getOAuthList('LiSi', 'getSocialData').then((data: string[]) => { console.log('getOAuthList data: ' + JSON.stringify(data)); }).catch((err: BusinessError) => { console.log('getOAuthList err: ' + JSON.stringify(err)); }); ``` ### getAuthenticatorCallback(deprecated) getAuthenticatorCallback(sessionId: string, callback: AsyncCallback<AuthenticatorCallback>): void 获取鉴权会话的认证器回调。使用callback异步回调。 > **说明：** > > 从 API version 8开始支持，从API version 9开始废弃。建议使用[getAuthCallback](#getauthcallback9)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | --------- | ---------------------------------------- | ---- | -------- | | sessionId | string | 是 | 鉴权会话的标识。 | | callback | AsyncCallback<[AuthenticatorCallback](#authenticatorcallbackdeprecated)> | 是 | 回调函数。当获取鉴权会话的认证器回调函数成功时，err为null，data为认证器回调函数；否则为错误对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; import { Want, UIAbility, AbilityConstant } from '@kit.AbilityKit'; export default class EntryAbility extends UIAbility { onCreate(want: Want, param: AbilityConstant.LaunchParam) { // ability 生命周期函数 let sessionId: string = want.parameters![appAccount.Constants.KEY_SESSION_ID] as string; appAccountManager.getAuthenticatorCallback(sessionId, (err: BusinessError, callback: appAccount.AuthenticatorCallback) => { if (err.code != appAccount.ResultCode.SUCCESS) { console.log('getAuthenticatorCallback err: ' + JSON.stringify(err)); return; } callback.onResult(appAccount.ResultCode.SUCCESS, { name: 'LiSi', owner: 'com.example.accountjsdemo', authType: 'getSocialData', token: 'xxxxxx'} ); }); } } ``` ### getAuthenticatorCallback(deprecated) getAuthenticatorCallback(sessionId: string): Promise<AuthenticatorCallback> 获取鉴权会话的认证器回调。使用Promise异步回调。 > **说明：** > > 从 API version 8开始支持，从API version 9开始废弃。建议使用[getAuthCallback](#getauthcallback9-1)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | --------- | ------ | ---- | -------- | | sessionId | string | 是 | 鉴权会话的标识。 | **返回值：** | 类型 | 说明 | | ------------------------------------ | --------------------- | | Promise<[AuthenticatorCallback](#authenticatorcallbackdeprecated)> | Promise对象，返回鉴权会话的认证器回调对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; import { Want, UIAbility, AbilityConstant } from '@kit.AbilityKit'; export default class EntryAbility extends UIAbility { onCreate(want: Want, param: AbilityConstant.LaunchParam) { // ability 生命周期函数 let sessionId: string = want.parameters![appAccount.Constants.KEY_SESSION_ID] as string; appAccountManager.getAuthenticatorCallback(sessionId).then(( callback: appAccount.AuthenticatorCallback) => { callback.onResult(appAccount.ResultCode.SUCCESS, { name: 'LiSi', owner: 'com.example.accountjsdemo', authType: 'getSocialData', token: 'xxxxxx'} ); }).catch((err: BusinessError) => { console.log('getAuthenticatorCallback err: ' + JSON.stringify(err)); }); } } ``` ### getAuthenticatorInfo(deprecated) getAuthenticatorInfo(owner: string, callback: AsyncCallback<AuthenticatorInfo>): void 获取指定应用的认证器信息。使用callback异步回调。 > **说明：** > > 从 API version 8开始支持，从API version 9开始废弃。建议使用[queryAuthenticatorInfo](#queryauthenticatorinfo9)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------------------------------------- | ---- | ----------- | | owner | string | 是 | 应用账号所有者的包名。 | | callback | AsyncCallback<[AuthenticatorInfo](#authenticatorinfo8)> | 是 | 回调函数。当获取成功时，err为null，data为认证器信息对象；否则为错误对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.getAuthenticatorInfo('com.example.accountjsdemo', (err: BusinessError, data: appAccount.AuthenticatorInfo) => { console.log('getAuthenticatorInfo err: ' + JSON.stringify(err)); console.log('getAuthenticatorInfo data: ' + JSON.stringify(data)); }); ``` ### getAuthenticatorInfo(deprecated) getAuthenticatorInfo(owner: string): Promise<AuthenticatorInfo> 获取指定应用的认证器信息。使用Promise异步回调。 > **说明：** > > 从 API version 8开始支持，从API version 9开始废弃。建议使用[queryAuthenticatorInfo](#queryauthenticatorinfo9-1)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ----- | ------ | ---- | ----------- | | owner | string | 是 | 应用账号所有者的包名。 | **返回值：** | 类型 | 说明 | | -------------------------------- | --------------------- | | Promise<[AuthenticatorInfo](#authenticatorinfo8)> | Promise对象，返回指定应用的认证器信息对象。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; appAccountManager.getAuthenticatorInfo('com.example.accountjsdemo').then(( data: appAccount.AuthenticatorInfo) => { console.log('getAuthenticatorInfo: ' + JSON.stringify(data)); }).catch((err: BusinessError) => { console.log('getAuthenticatorInfo err: ' + JSON.stringify(err)); }); ``` ## AppAccountInfo 表示应用账号信息。 **系统能力：** 以下各项对应的系统能力均为SystemCapability.Account.AppAccount。 | 名称 | 类型 | 必填 | 说明 | | ----- | ------ | ---- | ----------- | | owner | string | 是 | 应用账号所有者的包名。 | | name | string | 是 | 应用账号的名称。 | ## AuthTokenInfo9+ 表示Auth令牌信息。 **系统能力：** 以下各项对应的系统能力均为SystemCapability.Account.AppAccount。 | 名称 | 类型 | 必填 | 说明 | | -------------------- | -------------- | ----- | ---------------- | | authType9+ | string | 是 | 令牌的鉴权类型。 | | token9+ | string | 是 | 令牌的取值。 | | account9+ | [AppAccountInfo](#appaccountinfo) | 否 | 令牌所属的账号信息，默认为空。| ## OAuthTokenInfo(deprecated) 表示OAuth令牌信息。 > **说明：** > > 从 API version 8开始支持，从API version 9开始废弃。建议使用[AuthTokenInfo](#authtokeninfo9)替代。 **系统能力：** 以下各项对应的系统能力均为SystemCapability.Account.AppAccount。 | 名称 | 类型 | 必填 | 说明 | | -------------------- | -------------- | ----- | ---------------- | | authType | string | 是 | 令牌的鉴权类型。 | | token | string | 是 | 令牌的取值。 | ## AuthenticatorInfo8+ 表示OAuth认证器信息。 **系统能力：** 以下各项对应的系统能力均为SystemCapability.Account.AppAccount。 | 名称 | 类型 | 必填 | 说明 | | ------- | ------ | ---- | ---------- | | owner | string | 是 | 认证器的所有者的包名。 | | iconId | number | 是 | 认证器的图标标识。 | | labelId | number | 是 | 认证器的标签标识。 | ## AuthResult9+ 表示认证结果信息。 **系统能力：** 以下各项对应的系统能力均为SystemCapability.Account.AppAccount。 | 名称 | 类型 | 必填 | 说明 | | ------- | ------ | ---- | ---------- | | account | [AppAccountInfo](#appaccountinfo) | 否 | 令牌所属的账号信息，默认为空。 | | tokenInfo | [AuthTokenInfo](#authtokeninfo9) | 否 | 令牌信息，默认为空。 | ## CreateAccountOptions9+ 表示创建账号的选项。 **系统能力：** 以下各项对应的系统能力均为SystemCapability.Account.AppAccount。 | 名称 | 类型 | 必填 | 说明 | | ------- | ------ | ---- | ---------- | | customData | Record | 否 | 自定义数据，默认为空。 | ## CreateAccountImplicitlyOptions9+ 表示隐式创建账号的选项。 **系统能力：** 以下各项对应的系统能力均为SystemCapability.Account.AppAccount。 | 名称 | 类型 | 必填 | 说明 | | ------- | ------ | ---- | ---------- | | requiredLabels | Array<string> | 否 | 所需的标签，默认为空。 | | authType | string | 否 | 鉴权类型，默认为空。 | | parameters | Record | 否 | 自定义参数对象，默认为空。 | ## SelectAccountsOptions9+ 表示用于选择账号的选项。 **系统能力：** 以下各项对应的系统能力均为SystemCapability.Account.AppAccount。 | 名称 | 类型 | 必填 | 说明 | | --------------- | --------------------------- | ----- | ------------------- | | allowedAccounts | Array<[AppAccountInfo](#appaccountinfo)> | 否 | 允许的账号数组，默认为空。 | | allowedOwners | Array<string> | 否 | 允许的账号所有者数组，默认为空。 | | requiredLabels | Array<string> | 否 | 认证器的标签标识，默认为空。 | ## VerifyCredentialOptions9+ 表示用于验证凭据的选项。 **系统能力：** 以下各项对应的系统能力均为SystemCapability.Account.AppAccount。 | 名称 | 类型 | 必填 | 说明 | | -------------- | ---------------------- | ----- | -------------- | | credentialType | string | 否 | 凭据类型，默认为空。 | | credential | string | 否 | 凭据取值，默认为空。 | | parameters | Record | 否 | 自定义参数对象，默认为空。 | ## SetPropertiesOptions9+ 表示用于设置属性的选项。 **系统能力：** 以下各项对应的系统能力均为SystemCapability.Account.AppAccount。 | 名称 | 类型 | 必填 | 说明 | | ---------- | ---------------------- | ----- | -------------- | | properties | Record | 否 | 属性对象，默认为空。 | | parameters | Record | 否 | 自定义参数对象，默认为空。 | ## Constants8+ 表示常量的枚举。 **系统能力：** 以下各项对应的系统能力均为SystemCapability.Account.AppAccount。 | 名称 | 值 | 说明 | | -------------------------------- | ---------------------- | ----------------------- | | ACTION_ADD_ACCOUNT_IMPLICITLY(deprecated) | 'addAccountImplicitly' | 表示操作，隐式添加账号。 | | ACTION_AUTHENTICATE(deprecated) | 'authenticate' | 表示操作，鉴权。 | | ACTION_CREATE_ACCOUNT_IMPLICITLY9+ | 'createAccountImplicitly' | 表示操作，隐式创建账号。 | | ACTION_AUTH9+ | 'auth' | 表示操作，鉴权。 | | ACTION_VERIFY_CREDENTIAL9+ | 'verifyCredential' | 表示操作，验证凭据。 | | ACTION_SET_AUTHENTICATOR_PROPERTIES9+ | 'setAuthenticatorProperties' | 表示操作，设置认证器属性。 | | KEY_NAME | 'name' | 表示键名，应用账号的名称。 | | KEY_OWNER | 'owner' | 表示键名，应用账号所有者的包名。| | KEY_TOKEN | 'token' | 表示键名，令牌。 | | KEY_ACTION | 'action' | 表示键名，操作。 | | KEY_AUTH_TYPE | 'authType' | 表示键名，鉴权类型。 | | KEY_SESSION_ID | 'sessionId' | 表示键名，会话标识。 | | KEY_CALLER_PID | 'callerPid' | 表示键名，调用方PID。 | | KEY_CALLER_UID | 'callerUid' | 表示键名，调用方UID。 | | KEY_CALLER_BUNDLE_NAME | 'callerBundleName' | 表示键名，调用方包名。 | | KEY_REQUIRED_LABELS9+ | 'requiredLabels' | 表示键名，必需的标签。 | | KEY_BOOLEAN_RESULT9+ | 'booleanResult' | 表示键名，布尔返回值。 | ## ResultCode(deprecated) 表示返回码的枚举。 > **说明：**
> 从API version 8开始支持，从API version 9开始废弃。相关信息建议查看[错误码文档](errorcode-account.md)替代。 **系统能力：** 以下各项对应的系统能力均为SystemCapability.Account.AppAccount。 | 名称 | 值 | 说明 | | ----------------------------------- | ----- | ------------ | | SUCCESS | 0 | 表示操作成功。 | | ERROR_ACCOUNT_NOT_EXIST | 10001 | 表示应用账号不存在。 | | ERROR_APP_ACCOUNT_SERVICE_EXCEPTION | 10002 | 表示应用账号服务异常。 | | ERROR_INVALID_PASSWORD | 10003 | 表示密码无效。 | | ERROR_INVALID_REQUEST | 10004 | 表示请求无效。 | | ERROR_INVALID_RESPONSE | 10005 | 表示响应无效。 | | ERROR_NETWORK_EXCEPTION | 10006 | 表示网络异常。 | | ERROR_OAUTH_AUTHENTICATOR_NOT_EXIST | 10007 | 表示认证器不存在。 | | ERROR_OAUTH_CANCELED | 10008 | 表示鉴权取消。 | | ERROR_OAUTH_LIST_TOO_LARGE | 10009 | 表示开放授权列表过大。 | | ERROR_OAUTH_SERVICE_BUSY | 10010 | 表示开放授权服务忙碌。 | | ERROR_OAUTH_SERVICE_EXCEPTION | 10011 | 表示开放授权服务异常。 | | ERROR_OAUTH_SESSION_NOT_EXIST | 10012 | 表示鉴权会话不存在。 | | ERROR_OAUTH_TIMEOUT | 10013 | 表示鉴权超时。 | | ERROR_OAUTH_TOKEN_NOT_EXIST | 10014 | 表示开放授权令牌不存在。 | | ERROR_OAUTH_TOKEN_TOO_MANY | 10015 | 表示开放授权令牌过多。 | | ERROR_OAUTH_UNSUPPORT_ACTION | 10016 | 表示不支持的鉴权操作。 | | ERROR_OAUTH_UNSUPPORT_AUTH_TYPE | 10017 | 表示不支持的鉴权类型。 | | ERROR_PERMISSION_DENIED | 10018 | 表示权限不足。 | ## AuthCallback9+ 认证器回调类。 ### onResult9+ onResult: (code: number, result?: AuthResult) => void 通知请求结果。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | -------------------- | ---- | ------ | | code | number | 是 | 鉴权结果码。 | | result | [AuthResult](#authresult9) | 否 | 鉴权结果，默认为空，表示不接收认证结果信息。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; let appAccountManager: appAccount.AppAccountManager = appAccount.createAppAccountManager(); let sessionId = '1234'; appAccountManager.getAuthCallback(sessionId).then((callback: appAccount.AuthCallback) => { let result: appAccount.AuthResult = { account: { name: 'Lisi', owner: 'com.example.accountjsdemo', }, tokenInfo: { token: 'xxxxxx', authType: 'getSocialData' } }; callback.onResult(appAccount.ResultCode.SUCCESS, result); }).catch((err: BusinessError) => { console.log('getAuthCallback err: ' + JSON.stringify(err)); }); ``` ### onRequestRedirected9+ onRequestRedirected: (request: Want) => void 通知请求被跳转。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------- | ---- | ---- | ---------- | | request | [Want](../apis-ability-kit/js-apis-app-ability-want.md) | 是 | 用于跳转的请求信息。 | **示例：** ```ts import { Want } from '@kit.AbilityKit'; class MyAuthenticator extends appAccount.Authenticator { createAccountImplicitly( options: appAccount.CreateAccountImplicitlyOptions, callback: appAccount.AuthCallback) { let want: Want = { bundleName: 'com.example.accountjsdemo', abilityName: 'com.example.accountjsdemo.LoginAbility', }; callback.onRequestRedirected(want); } auth(name: string, authType: string, options: Record, callback: appAccount.AuthCallback) { let result: appAccount.AuthResult = { account: { name: 'Lisi', owner: 'com.example.accountjsdemo', }, tokenInfo: { token: 'xxxxxx', authType: 'getSocialData' } }; callback.onResult(appAccount.ResultCode.SUCCESS, result); } } ``` ### onRequestContinued9+ onRequestContinued?: () => void 通知请求被继续处理。 **系统能力：** SystemCapability.Account.AppAccount **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; let appAccountManager: appAccount.AppAccountManager = appAccount.createAppAccountManager(); let sessionId = '1234'; appAccountManager.getAuthCallback(sessionId).then((callback: appAccount.AuthCallback) => { if (callback.onRequestContinued != undefined) { callback.onRequestContinued(); } }).catch((err: BusinessError) => { console.log('getAuthCallback err: ' + JSON.stringify(err)); }); ``` ## AuthenticatorCallback(deprecated) OAuth认证器回调接口。 > **说明：** > > 从 API version 8开始支持，从API version 9开始废弃。建议使用[AuthCallback](#authcallback9)替代。 ### onResult8+ onResult: (code: number, result: {[key: string]: any;}) => void 通知请求结果。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------ | -------------------- | ---- | ------ | | code | number | 是 | 鉴权结果码。 | | result | {[key: string]: any} | 是 | 鉴权结果。 | **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; let appAccountManager: appAccount.AppAccountManager = appAccount.createAppAccountManager(); let sessionId = '1234'; appAccountManager.getAuthenticatorCallback(sessionId).then((callback: appAccount.AuthenticatorCallback) => { callback.onResult(appAccount.ResultCode.SUCCESS, { name: 'LiSi', owner: 'com.example.accountjsdemo', authType: 'getSocialData', token: 'xxxxxx'} ); }).catch((err: BusinessError) => { console.log('getAuthenticatorCallback err: ' + JSON.stringify(err)); }); ``` ### onRequestRedirected8+ onRequestRedirected: (request: Want) => void 通知请求被跳转。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ------- | ---- | ---- | ---------- | | request | [Want](../apis-ability-kit/js-apis-app-ability-want.md) | 是 | 用于跳转的请求信息。 | **示例：** ```ts import { Want } from '@kit.AbilityKit'; class MyAuthenticator extends appAccount.Authenticator { addAccountImplicitly(authType: string, callerBundleName: string, options: Record, callback: appAccount.AuthenticatorCallback) { let want: Want = { bundleName: 'com.example.accountjsdemo', abilityName: 'com.example.accountjsdemo.LoginAbility', }; callback.onRequestRedirected(want); } authenticate(name: string, authType: string, callerBundleName: string, options: Record, callback: appAccount.AuthenticatorCallback) { callback.onResult(appAccount.ResultCode.SUCCESS, { name: name, authType: authType, token: 'xxxxxx'} ); } } ``` ## Authenticator8+ 认证器基类。 ### createAccountImplicitly9+ createAccountImplicitly(options: CreateAccountImplicitlyOptions, callback: AuthCallback): void 根据指定的账号所有者隐式地创建应用账号，并使用callback异步回调返回结果。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---------------- | --------------------- | ---- | --------------- | | options | [CreateAccountImplicitlyOptions](#createaccountimplicitlyoptions9) | 是 | 隐式创建账号的选项。 | | callback | [AuthCallback](#authcallback9) | 是 | 认证器回调对象，用于返回创建结果。 | ### addAccountImplicitly(deprecated) addAccountImplicitly(authType: string, callerBundleName: string, options: {[key: string]: any;}, callback: AuthenticatorCallback): void 根据指定的鉴权类型和可选项，隐式地添加应用账号，并使用callback异步回调返回结果。 > **说明：** > > 从 API version 8开始支持, 从API version 9开始废弃。建议使用[createAccountImplicitly](#createaccountimplicitly9-2)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---------------- | --------------------- | ---- | --------------- | | authType | string | 是 | 应用账号的鉴权类型。 | | callerBundleName | string | 是 | 鉴权请求方的包名。 | | options | {[key: string]: any} | 是 | 鉴权所需要的可选项。 | | callback | [AuthenticatorCallback](#authenticatorcallbackdeprecated) | 是 | 认证器回调，用于返回鉴权结果。 | ### auth9+ auth(name: string, authType: string, options: Record, callback: AuthCallback): void 对应用账号进行鉴权以获取授权令牌，并使用callback异步回调返回结果。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---------------- | --------------------- | ---- | --------------- | | name | string | 是 | 应用账号的名称。 | | authType | string | 是 | 应用账号的鉴权类型。 | | options | Record | 是 | 鉴权所需要的可选项。 | | callback | [AuthCallback](#authcallback9) | 是 | 回调对象，用于返回鉴权结果。 | ### authenticate(deprecated) authenticate(name: string, authType: string, callerBundleName: string, options: {[key: string]: any;}, callback: AuthenticatorCallback): void 对应用账号进行鉴权，获取OAuth令牌，并使用callback异步回调返回结果。 > **说明：** > > 从 API version 8开始支持, 从API version 9开始废弃。建议使用[auth](#auth9-2)替代。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---------------- | --------------------- | ---- | --------------- | | name | string | 是 | 应用账号的名称。 | | authType | string | 是 | 应用账号的鉴权类型。 | | callerBundleName | string | 是 | 鉴权请求方的包名。 | | options | {[key: string]: any} | 是 | 鉴权所需要的可选项。 | | callback | [AuthenticatorCallback](#authenticatorcallbackdeprecated) | 是 | 认证器回调，用于返回鉴权结果。 | ### verifyCredential9+ verifyCredential(name: string, options: VerifyCredentialOptions, callback: AuthCallback): void 验证应用账号的凭据，并使用callback异步回调返回结果。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---------------- | --------------------- | ---- | --------------- | | name | string | 是 | 应用账号的名称。 | | options | [VerifyCredentialOptions](#verifycredentialoptions9) | 是 | 验证凭据的可选项。 | | callback | [AuthCallback](#authcallback9) | 是 | 认证器回调，用于返回验证结果。 | ### setProperties9+ setProperties(options: SetPropertiesOptions, callback: AuthCallback): void 设置认证器属性，并使用callback异步回调返回结果。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---------------- | --------------------- | ---- | --------------- | | options | [SetPropertiesOptions](#setpropertiesoptions9) | 是 | 设置属性的可选项。 | | callback | [AuthCallback](#authcallback9) | 是 | 认证器回调，用于返回设置结果。 | ### checkAccountLabels9+ checkAccountLabels(name: string, labels: Array<string>, callback: AuthCallback): void 检查账号标签，并使用callback异步回调返回结果。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---------------- | --------------------- | ---- | --------------- | | name | string | 是 | 应用账号的名称。 | | labels | Array<string> | 是 | 标签数组。 | | callback | [AuthCallback](#authcallback9) | 是 | 认证器回调，用于返回检查结果。 | ### checkAccountRemovable9+ checkAccountRemovable(name: string, callback: AuthCallback): void 判断账号是否可以删除，并使用callback异步回调返回结果。 **系统能力：** SystemCapability.Account.AppAccount **参数：** | 参数名 | 类型 | 必填 | 说明 | | ---------------- | --------------------- | ---- | --------------- | | name | string | 是 | 应用账号的名称。 | | callback | [AuthCallback](#authcallback9) | 是 | 认证器回调，用于返回判断结果。 | ### getRemoteObject9+ getRemoteObject(): rpc.RemoteObject; 获取认证器的远程对象，不可以重载实现。 **系统能力：** SystemCapability.Account.AppAccount **示例：** ```ts import { rpc } from '@kit.IPCKit'; import { Want } from '@kit.AbilityKit'; class MyAuthenticator extends appAccount.Authenticator { verifyCredential(name: string, options: appAccount.VerifyCredentialOptions, callback: appAccount.AuthCallback) { let want: Want = { bundleName: 'com.example.accountjsdemo', abilityName: 'com.example.accountjsdemo.VerifyAbility', parameters: { name: name } }; callback.onRequestRedirected(want); } setProperties(options: appAccount.SetPropertiesOptions, callback: appAccount.AuthCallback) { let want: Want = { bundleName: 'com.example.accountjsdemo', abilityName: 'com.example.accountjsdemo.SetPropertiesAbility', parameters: { options: options } }; callback.onRequestRedirected(want); } checkAccountLabels(name: string, labels: string[], callback: appAccount.AuthCallback) { callback.onResult(0); } checkAccountRemovable(name: string, callback: appAccount.AuthCallback) { callback.onResult(0); } } export default { onConnect(want: Want): rpc.RemoteObject { // serviceAbility 生命周期函数, 需要放在serviceAbility中 let authenticator = new MyAuthenticator(); return authenticator.getRemoteObject(); } } ```