ding-qiaoqiaoupdate: 更新文件 js-apis-abilityAccessCtrl.md

496d4144创建于 2025年12月15日历史提交

@ohos.abilityAccessCtrl (程序访问控制管理)

程序访问控制提供应用程序的权限校验和管理能力。

说明： 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import { abilityAccessCtrl } from '@kit.AbilityKit';

abilityAccessCtrl.createAtManager

createAtManager(): AtManager

访问控制管理：创建程序访问控制管理的实例对象。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Security.AccessToken

返回值：

类型	说明
AtManager	获取程序访问控制模块的实例。

示例：

let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();

AtManager

管理访问控制模块的实例。

checkAccessToken⁹⁺

checkAccessToken(tokenID: number, permissionName: Permissions): Promise<GrantStatus>

校验应用是否被授予权限。使用Promise异步回调。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Security.AccessToken

参数：

参数名	类型	必填	说明
tokenID	number	是	要校验的目标应用的身份标识，可通过应用的ApplicationInfo的accessTokenId字段获得。
permissionName	Permissions	是	需要校验的权限名称，合法的权限名取值可在应用权限列表中查询。

返回值：

类型	说明
Promise<GrantStatus>	Promise对象，返回授权状态结果。

错误码：

以下错误码的详细介绍请参见通用错误码和访问控制错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
12100001	Invalid parameter. The tokenID is 0, or the permissionName exceeds 256 characters.

示例：

import { abilityAccessCtrl } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
let tokenID: number = 0; // 系统应用可以通过bundleManager.getApplicationInfo获取，三方应用可以通过bundleManager.getBundleInfoForSelf获取。
atManager.checkAccessToken(tokenID, 'ohos.permission.GRANT_SENSITIVE_PERMISSIONS').then((data: abilityAccessCtrl.GrantStatus) => {
  console.info(`checkAccessToken success, result: ${data}`);
}).catch((err: BusinessError) => {
  console.error(`checkAccessToken fail, code: ${err.code}, message: ${err.message}`);
});

checkAccessTokenSync¹⁰⁺

checkAccessTokenSync(tokenID: number, permissionName: Permissions): GrantStatus

校验应用是否被授予权限，同步返回结果。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Security.AccessToken

参数：

参数名	类型	必填	说明
tokenID	number	是	要校验应用的身份标识，可通过应用的ApplicationInfo的accessTokenId字段获得。
permissionName	Permissions	是	需要校验的权限名称，合法的权限名取值可在应用权限列表中查询。

返回值：

类型	说明
GrantStatus	枚举实例，返回授权状态。

错误码：

以下错误码的详细介绍请参见通用错误码和访问控制错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
12100001	Invalid parameter. The tokenID is 0, or the permissionName exceeds 256 characters.

示例：

import { abilityAccessCtrl, Permissions } from '@kit.AbilityKit';

let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
let tokenID: number = 0; // 系统应用可以通过bundleManager.getApplicationInfo获取，三方应用可以通过bundleManager.getBundleInfoForSelf获取。
let permissionName: Permissions = 'ohos.permission.GRANT_SENSITIVE_PERMISSIONS';
let data: abilityAccessCtrl.GrantStatus = atManager.checkAccessTokenSync(tokenID, permissionName);
console.info(`Result: ${data}`);

on¹⁸⁺

on(type: 'selfPermissionStateChange', permissionList: Array<Permissions>, callback: Callback<PermissionStateChangeInfo>): void

订阅本应用的指定权限列表的权限授权状态变化事件。当本应用对应权限的授权状态发生变化时，触发对应回调函数的执行。使用callback异步回调。

多次调用本订阅接口时，如果订阅的权限列表相同，callback不同，允许订阅成功。
多次调用本订阅接口时，如果订阅的权限列表间有相同的子集，callback相同时，订阅失败。

原子化服务API： 从API version 18开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Security.AccessToken

参数：

参数名	类型	必填	说明
type	string	是	订阅事件类型，固定为'selfPermissionStateChange'，自身权限状态变更事件。
permissionList	Array<Permissions>	是	订阅的权限名列表，如果为空，则表示订阅所有的权限状态变化，合法的权限名取值可在应用权限列表中查询。
callback	Callback<PermissionStateChangeInfo>	是	回调函数，返回订阅指定权限名状态变更事件的结果。

错误码：

以下错误码的详细介绍请参见通用错误码和访问控制错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
12100001	Invalid parameter. Possible causes: 1. The permissionList exceeds the size limit; 2. The permissionNames in the list are all invalid.
12100004	The API is used repeatedly with the same input.
12100005	The registration time has exceeded the limit.
12100007	The service is abnormal.

示例：

import { abilityAccessCtrl, Permissions } from '@kit.AbilityKit';

let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
let permissionList: Array<Permissions> = ['ohos.permission.APPROXIMATELY_LOCATION'];
try {
    atManager.on('selfPermissionStateChange', permissionList, (data: abilityAccessCtrl.PermissionStateChangeInfo) => {
        console.info(`receive permission state change, result: ${data}`);
    });
} catch(err) {
    console.error(`Code: ${err.code}, message: ${err.message}`);
}

off¹⁸⁺

off(type: 'selfPermissionStateChange', permissionList: Array<Permissions>, callback?: Callback<PermissionStateChangeInfo>): void

取消订阅自身指定权限列表的权限状态变更事件。使用callback异步回调。

取消订阅不传callback时，批量删除permissionList下面的所有callback。

原子化服务API： 从API version 18开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Security.AccessToken

参数：

参数名	类型	必填	说明
type	string	是	订阅事件类型，固定为'selfPermissionStateChange'，权限状态变更事件。
permissionList	Array<Permissions>	是	取消订阅的权限名列表，为空时表示取消订阅所有的权限状态变化，必须与on的输入一致，合法的权限名取值可在应用权限列表中查询。
callback	Callback<PermissionStateChangeInfo>	否	回调函数，返回取消订阅指定tokenID与指定权限名状态变更事件的结果。

错误码：

以下错误码的详细介绍请参见通用错误码和访问控制错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
12100004	The API is not used in pair with "on".
12100007	The service is abnormal.

示例：

import { abilityAccessCtrl, Permissions } from '@kit.AbilityKit';

let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
let permissionList: Array<Permissions> = ['ohos.permission.APPROXIMATELY_LOCATION'];
try {
    atManager.off('selfPermissionStateChange', permissionList);
} catch(err) {
    console.error(`Code: ${err.code}, message: ${err.message}`);
}

requestPermissionsFromUser⁹⁺

requestPermissionsFromUser(context: Context, permissionList: Array<Permissions>, requestCallback: AsyncCallback<PermissionRequestResult>): void

用于UIAbility拉起弹框请求用户授权。使用callback异步回调。

如果用户拒绝授权，将无法再次拉起弹框，需要用户在系统应用“设置”的界面中，手动授予权限，或是调用requestPermissionOnSetting，拉起权限设置弹框，引导用户授权。

requestPermissionsFromUser

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Security.AccessToken

参数：

参数名	类型	必填	说明
context	Context	是	请求权限的UIAbility的Context。
permissionList	Array<Permissions>	是	权限名列表，合法的权限名取值可在应用权限列表中查询。
requestCallback	AsyncCallback<PermissionRequestResult>	是	回调函数。当拉起权限请求弹框成功，err为undefined，data为获取到的PermissionRequestResult；否则err为错误对象。

错误码：

以下错误码的详细介绍请参见通用错误码和访问控制错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
12100001	(Deprecated in 12) Invalid parameter. The context is invalid when it does not belong to the application itself.
12100009	Common inner error. An error occurs when creating the pop-up window or obtaining user operation results.

示例：

下述示例中context的获取方式请参见获取UIAbility的上下文信息。关于向用户申请授权的完整流程及示例，请参见向用户申请授权。

import { abilityAccessCtrl, Context, PermissionRequestResult, common } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
let context: Context = this.getUIContext().getHostContext() as common.UIAbilityContext;
atManager.requestPermissionsFromUser(context, ['ohos.permission.CAMERA'], (err: BusinessError, data: PermissionRequestResult) => {
  if (err) {
    console.error(`requestPermissionsFromUser fail, code: ${err.code}, message: ${err.message}`);
  } else {
    console.info(`requestPermissionsFromUser success, result: ${data}`);
    console.info('requestPermissionsFromUser data permissions:' + data.permissions);
    console.info('requestPermissionsFromUser data authResults:' + data.authResults);
    console.info('requestPermissionsFromUser data dialogShownResults:' + data.dialogShownResults);
    console.info('requestPermissionsFromUser data errorReasons:' + data.errorReasons);
  }
});

requestPermissionsFromUser⁹⁺

requestPermissionsFromUser(context: Context, permissionList: Array<Permissions>): Promise<PermissionRequestResult>

用于UIAbility拉起弹框请求用户授权。使用Promise异步回调。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Security.AccessToken

参数：

参数名	类型	必填	说明
context	Context	是	请求权限的UIAbility的Context。
permissionList	Array<Permissions>	是	需要校验的权限名称，合法的权限名取值可在应用权限列表中查询。

返回值：

类型	说明
Promise<PermissionRequestResult>	Promise对象，返回接口的结果。

错误码：

以下错误码的详细介绍请参见通用错误码和访问控制错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
12100001	(Deprecated in 12) Invalid parameter. The context is invalid when it does not belong to the application itself.
12100009	Common inner error. An error occurs when creating the pop-up window or obtaining user operation results.

示例：

下述示例中context的获取方式请参见获取UIAbility的上下文信息。关于向用户申请授权的完整流程及示例，请参见向用户申请授权。

import { abilityAccessCtrl, Context, PermissionRequestResult, common } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
let context: Context = this.getUIContext().getHostContext() as common.UIAbilityContext;
atManager.requestPermissionsFromUser(context, ['ohos.permission.CAMERA']).then((data: PermissionRequestResult) => {
  console.info(`requestPermissionsFromUser success, result: ${data}`);
  console.info('requestPermissionsFromUser data permissions:' + data.permissions);
  console.info('requestPermissionsFromUser data authResults:' + data.authResults);
  console.info('requestPermissionsFromUser data dialogShownResults:' + data.dialogShownResults);
  console.info('requestPermissionsFromUser data errorReasons:' + data.errorReasons);
}).catch((err: BusinessError) => {
  console.error(`requestPermissionsFromUser fail, code: ${err.code}, message: ${err.message}`);
});

requestPermissionOnSetting¹²⁺

requestPermissionOnSetting(context: Context, permissionList: Array<Permissions>): Promise<Array<GrantStatus>>

用于UIAbility/UIExtensionAbility二次拉起权限设置弹框。使用Promise异步回调。

在调用此接口前，应用需要先调用requestPermissionsFromUser，如果用户在首次弹窗授权时已授权，调用当前接口将无法拉起弹窗。

requestPermissionOnSetting

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Security.AccessToken

参数：

参数名	类型	必填	说明
context	Context	是	请求权限的UIAbility/UIExtensionAbility的Context。
permissionList	Array<Permissions>	是	权限名列表，合法的权限名取值可在应用权限组列表中查询。

返回值：

类型	说明
Promise<Array<GrantStatus>>	Promise对象，返回授权状态结果。

错误码：

以下错误码的详细介绍请参见通用错误码和访问控制错误码。

错误码ID	错误信息
12100001	Invalid parameter. Possible causes: 1. The context is invalid because it does not belong to the application itself; 2. The permission list contains the permission that is not declared in the module.json file; 3. The permission list is invalid because the permissions in it do not belong to the same permission group; 4. The permission list contains one or more system_grant permissions.
12100009	Common inner error. An error occurs when creating the pop-up window or obtaining user operation result.
12100011	All permissions in the permission list have been granted.
12100012	The permission list contains the permission that has not been revoked by the user.
12100014	Unexpected permission. You cannot request this type of permission from users via a pop-up window.

示例： 示例中context的获取方式请参见获取UIAbility的上下文信息。

import { abilityAccessCtrl, Context, common } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
let context: Context = this.getUIContext().getHostContext() as common.UIAbilityContext;
atManager.requestPermissionOnSetting(context, ['ohos.permission.CAMERA']).then((data: Array<abilityAccessCtrl.GrantStatus>) => {
  console.info(`requestPermissionOnSetting success, result: ${data}`);
}).catch((err: BusinessError) => {
  console.error(`requestPermissionOnSetting fail, code: ${err.code}, message: ${err.message}`);
});

requestGlobalSwitch¹²⁺

requestGlobalSwitch(context: Context, type: SwitchType): Promise<boolean>

用于UIAbility/UIExtensionAbility拉起全局开关设置弹框。使用Promise异步回调。

在某些情况下，如果录音、拍照等功能被禁用，应用可拉起此弹框请求用户同意开启对应功能。如果当前全局开关的状态为开启，则不拉起弹框。

requestGlobalSwitch

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Security.AccessToken

参数：

参数名	类型	必填	说明
context	Context	是	请求权限的UIAbility/UIExtensionAbility的Context。
type	SwitchType	是	全局开关类型。

返回值：

类型	说明
Promise<boolean>	Promise对象。返回true，表示全局开关状态为开启。返回false，表示全局开关状态为关闭。

错误码：

以下错误码的详细介绍请参见通用错误码和访问控制错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
12100001	Invalid parameter. Possible causes: 1. The context is invalid because it does not belong to the application itself; 2. The type of global switch is not support.
12100009	Common inner error. An error occurs when creating the pop-up window or obtaining user operation result.
12100013	The specific global switch is already open.

示例： 示例中context的获取方式请参见获取UIAbility的上下文信息。

import { abilityAccessCtrl, Context, common } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
let context: Context = this.getUIContext().getHostContext() as common.UIAbilityContext;
atManager.requestGlobalSwitch(context, abilityAccessCtrl.SwitchType.CAMERA).then((data: Boolean) => {
  console.info(`requestGlobalSwitch success, result: ${data}`);
}).catch((err: BusinessError) => {
  console.error(`requestGlobalSwitch fail, code: ${err.code}, message: ${err.message}`);
});

getSelfPermissionStatus²⁰⁺

getSelfPermissionStatus(permissionName: Permissions): PermissionStatus

查询应用权限状态，同步返回结果。

原子化服务API： 从API version 20开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Security.AccessToken

参数：

参数名	类型	必填	说明
permissionName	Permissions	是	需要校验的权限名称，合法的权限名取值可在应用权限列表中查询。

返回值：

类型	说明
PermissionStatus	枚举实例，返回权限状态。

错误码：

以下错误码的详细介绍请参见访问控制错误码。

错误码ID	错误信息
12100001	Invalid parameter. The permissionName is empty or exceeds 256 characters.
12100007	The service is abnormal.

示例：

import { abilityAccessCtrl } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
try {
  let data: abilityAccessCtrl.PermissionStatus = atManager.getSelfPermissionStatus('ohos.permission.CAMERA');
  console.info(`getSelfPermissionStatus success, result: ${data}`);
} catch(err) {
  console.error(`getSelfPermissionStatus fail, code: ${err.code}, message: ${err.message}`);
}

openPermissionOnSetting²²⁺

openPermissionOnSetting(context: Context, permission: Permissions): Promise<SelectedResult>

用于UIAbility/UIExtensionAbility拉起跳转设置页的弹窗。使用Promise异步回调。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Security.AccessToken

参数：

参数名	类型	必填	说明
context	Context	是	请求权限的UIAbility/UIExtensionAbility的Context。
permission	Permissions	是	权限名，只支持授权方式为manual_settings类型的权限。

返回值：

类型	说明
Promise<SelectedResult>	Promise对象，返回跳转设置页弹窗结果。

错误码：

以下错误码的详细介绍请参见访问控制错误码。

错误码ID	错误信息
12100001	Invalid parameter. Possible causes: 1. The context is invalid because it does not belong to the application itself; 2. The permission is invalid or not declared in the module.json file.
12100009	Common inner error. An error occurs when creating the pop-up window or obtaining user operation result.
12100014	Unexpected permission. The permission is not a manual_settings permission.

示例：

示例中context的获取方式请参见获取UIAbility的上下文信息。

import { abilityAccessCtrl, Context, common } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
let context: Context = this.getUIContext().getHostContext() as common.UIAbilityContext;
atManager.openPermissionOnSetting(context, 'ohos.permission.HOOK_KEY_EVENT').then((data: abilityAccessCtrl.SelectedResult) => {
  console.info(`openPermissionOnSetting success, result: ${data}`);
}).catch((err: BusinessError) => {
  console.error(`openPermissionOnSetting fail, code: ${err.code}, message: ${err.message}`);
});

verifyAccessTokenSync⁹⁺

verifyAccessTokenSync(tokenID: number, permissionName: Permissions): GrantStatus

校验应用是否被授予权限，同步返回结果。

系统能力： SystemCapability.Security.AccessToken

参数：

参数名	类型	必填	说明
tokenID	number	是	要校验应用的身份标识，可通过应用的ApplicationInfo的accessTokenId字段获得。
permissionName	Permissions	是	需要校验的权限名称，合法的权限名取值可在应用权限列表中查询。

返回值：

类型	说明
GrantStatus	枚举实例，返回授权状态。

错误码：

以下错误码的详细介绍请参见通用错误码和访问控制错误码。

错误码ID	错误信息
401	Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
12100001	Invalid parameter. The tokenID is 0, or the permissionName exceeds 256 characters.

示例：

import { abilityAccessCtrl } from '@kit.AbilityKit';

let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
let tokenID: number = 0; // 系统应用可以通过bundleManager.getApplicationInfo获取，三方应用可以通过bundleManager.getBundleInfoForSelf获取。
try {
  let data: abilityAccessCtrl.GrantStatus = atManager.verifyAccessTokenSync(tokenID, 'ohos.permission.GRANT_SENSITIVE_PERMISSIONS');
  console.info(`verifyAccessTokenSync success, result: ${data}`);
} catch(err) {
  console.error(`verifyAccessTokenSync fail, code: ${err.code}, message: ${err.message}`);
}

verifyAccessToken⁹⁺

verifyAccessToken(tokenID: number, permissionName: Permissions): Promise<GrantStatus>

校验应用是否被授予权限。使用Promise异步回调。

说明：

建议使用checkAccessToken替代。

系统能力： SystemCapability.Security.AccessToken

参数：

参数名	类型	必填	说明
tokenID	number	是	要校验的目标应用的身份标识，可通过应用的ApplicationInfo的accessTokenId字段获得。
permissionName	Permissions	是	需要校验的权限名称，合法的权限名取值可在应用权限列表中查询。

返回值：

类型	说明
Promise<GrantStatus>	Promise对象，返回授权状态结果。

示例：

import { abilityAccessCtrl, Permissions } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
let tokenID: number = 0; // 系统应用可以通过bundleManager.getApplicationInfo获取，三方应用可以通过bundleManager.getBundleInfoForSelf获取。
let permissionName: Permissions = 'ohos.permission.GRANT_SENSITIVE_PERMISSIONS';
atManager.verifyAccessToken(tokenID, permissionName).then((data: abilityAccessCtrl.GrantStatus) => {
  console.info(`verifyAccessToken success, result: ${data}`);
}).catch((err: BusinessError) => {
  console.error(`verifyAccessToken fail, code: ${err.code}, message: ${err.message}`);
});

verifyAccessToken^(deprecated)

verifyAccessToken(tokenID: number, permissionName: string): Promise<GrantStatus>

校验应用是否被授予权限。使用Promise异步回调。

说明：

从API version 8 开始支持，从API version 9 开始废弃，建议使用checkAccessToken替代。

系统能力： SystemCapability.Security.AccessToken

参数：

参数名	类型	必填	说明
tokenID	number	是	要校验的目标应用的身份标识，可通过应用的ApplicationInfo的accessTokenId字段获得。
permissionName	string	是	需要校验的权限名称，合法的权限名取值可在应用权限列表中查询。

返回值：

类型	说明
Promise<GrantStatus>	Promise对象，返回授权状态结果。

示例：

import { abilityAccessCtrl } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
let tokenID: number = 0; // 系统应用可以通过bundleManager.getApplicationInfo获取，三方应用可以通过bundleManager.getBundleInfoForSelf获取。
atManager.verifyAccessToken(tokenID, 'ohos.permission.GRANT_SENSITIVE_PERMISSIONS').then((data: abilityAccessCtrl.GrantStatus) => {
  console.info(`verifyAccessToken success, result: ${data}`);
}).catch((err: BusinessError) => {
  console.error(`verifyAccessToken fail, code: ${err.code}, message: ${err.message}`);
});

GrantStatus

表示授权状态的枚举。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Security.AccessToken

名称	值	说明
PERMISSION_DENIED	-1	表示未授权。
PERMISSION_GRANTED	0	表示已授权。

SwitchType¹²⁺

表示全局开关类型的枚举。

原子化服务API： 从API version 12开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Security.AccessToken

名称	值	说明
CAMERA	0	表示相机全局开关。
MICROPHONE	1	表示麦克风全局开关。
LOCATION	2	表示位置全局开关。

PermissionStateChangeType¹⁸⁺

表示权限授权状态变化操作类型的枚举。

原子化服务API： 从API version 18开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Security.AccessToken

名称	值	说明
PERMISSION_REVOKED_OPER	0	表示权限取消操作。
PERMISSION_GRANTED_OPER	1	表示权限授予操作。

PermissionStateChangeInfo¹⁸⁺

表示某次权限授权状态变化的详情。

原子化服务API： 从API version 18开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Security.AccessToken

名称	类型	只读	可选	说明
change	PermissionStateChangeType	否	否	权限授权状态变化类型。
tokenID	number	否	否	被订阅的应用身份标识，可通过应用的ApplicationInfo的accessTokenId字段获得。
permissionName	Permissions	否	否	当前授权状态发生变化的权限名，合法的权限名取值可在应用权限列表中查询。

PermissionRequestResult¹⁰⁺

type PermissionRequestResult = _PermissionRequestResult

权限请求结果对象。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Security.AccessToken

类型	说明
_PermissionRequestResult	权限请求结果对象。

Context¹⁰⁺

type Context = _Context

提供了ability或application的上下文的能力，包括访问特定应用程序的资源等。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Security.AccessToken

类型	说明
_Context	提供了ability或application的上下文的能力，包括访问特定应用程序的资源等。

PermissionStatus²⁰⁺

表示权限状态的枚举。

原子化服务API： 从API version 20开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Security.AccessToken

名称	值	说明
DENIED	-1	表示用户未授权。
GRANTED	0	表示已授权。
NOT_DETERMINED	1	表示未操作。应用声明用户授权权限，暂未调用requestPermissionsFromUser接口请求用户授权时，或用户在设置中将权限状态修改为每次询问时，查询权限状态将返回此值。
INVALID	2	表示无效。应用未声明权限或当前无法处理。例如：当模糊位置权限的状态为NOT_DETERMINED时，查询精确位置权限状态，返回此值。
RESTRICTED	3	表示受限。应用被设置禁止通过requestPermissionsFromUser接口请求用户授权。

SelectedResult²²⁺

表示跳转设置页弹窗结果的枚举。

系统能力： SystemCapability.Security.AccessToken

名称	值	说明
REJECTED	-1	表示用户选择不允许前往设置。
OPENED	0	表示用户选择前往设置。
GRANTED	1	表示权限已授权，无需弹窗。

@ohos.abilityAccessCtrl (程序访问控制管理)

导入模块

abilityAccessCtrl.createAtManager

AtManager

checkAccessToken9+

checkAccessTokenSync10+

on18+

off18+

requestPermissionsFromUser9+

requestPermissionsFromUser9+

requestPermissionOnSetting12+

requestGlobalSwitch12+

getSelfPermissionStatus20+

openPermissionOnSetting22+

verifyAccessTokenSync9+

verifyAccessToken9+

verifyAccessToken(deprecated)

GrantStatus

SwitchType12+

PermissionStateChangeType18+

PermissionStateChangeInfo18+

PermissionRequestResult10+

Context10+

PermissionStatus20+

SelectedResult22+

checkAccessToken⁹⁺

checkAccessTokenSync¹⁰⁺

on¹⁸⁺

off¹⁸⁺

requestPermissionsFromUser⁹⁺

requestPermissionsFromUser⁹⁺

requestPermissionOnSetting¹²⁺

requestGlobalSwitch¹²⁺

getSelfPermissionStatus²⁰⁺

openPermissionOnSetting²²⁺

verifyAccessTokenSync⁹⁺

verifyAccessToken⁹⁺

verifyAccessToken^(deprecated)

SwitchType¹²⁺

PermissionStateChangeType¹⁸⁺

PermissionStateChangeInfo¹⁸⁺

PermissionRequestResult¹⁰⁺

Context¹⁰⁺

PermissionStatus²⁰⁺

SelectedResult²²⁺