鸿蒙ASCF权限拒绝后openSetting引导设置与状态重置

鸿蒙专家

在鸿蒙 ASCF 开发权限相关功能时，常见现象是：用户拒绝授权后，再调用 has.authorize 不再弹窗，而是直接进入 fail。此时不能继续死等系统弹窗，需要使用设置类 API 把用户引导到元服务设置页，并在返回后重新确认权限状态。ASCF 里主要涉及两个方法：has.openSetting 用来打开元服务设置页，has.getSetting 用来查询已授权的权限列表。

一、openSetting 与 getSetting 的分工

has.openSetting 调用后拉起元服务设置页面，用户可在其中手动开启或关闭权限。调用示例：

2. has.openSetting({
3.   success: (res) => {
4.     console.info('设置页返回:', res);
5.     // res 是用户在设置页操作后的权限状态
6.   },
7.   fail: (err) => {
8.     console.error('打开设置页失败:', err);
9.   }
10. });

复制代码

has.getSetting 查询当前已授权的权限列表：

2. has.getSetting({
3.   success: (res) => {
4.     console.info('已授权权限:', res);
5.     if (res['scope.userLocation']) {
6.       console.info('定位权限已开启');
7.     }
8.     if (res['scope.camera']) {
9.       console.info('相机权限已开启');
10.     }
11.   },
12.   fail: (err) => {
13.     console.error('查询失败:', err);
14.   }
15. });

复制代码

返回值是一个对象，key 是 scope 名称，value 是 boolean。只会返回明确授权或拒绝的权限，没申请过的权限不会出现在结果里。两个方法的 success 返回值格式一样，都是 { 'scope.xxx': true/false } 对象。

设置页中显示给用户的权限名称，和代码里的 scope 不一定一样。例如设置页显示“位置信息”“相机”，而代码里是 scope.userLocation、scope.camera。弹窗引导时不要对用户说“请开启 scope.camera”，应说“请开启相机权限”。

二、最容易踩的坑：openSetting 必须先 authorize

openSetting 必须在 has.authorize 之后调用。如果项目从未调用过 authorize，直接调用 openSetting 会报错：

2. {"errMsg":"operateWXData:fail no authorize"}

复制代码

也就是说，至少先弹过一次授权弹窗，不管用户同意还是拒绝，之后才能打开设置页。正确顺序是：先 authorize（成功或失败都算），再 openSetting。

三、设置页返回后状态会重置

用户在设置页操作后，之前 authorize 的授权状态会被重置。从设置页返回后，需要重新调用 authorize 或 getSetting 获取最新状态。

同时，openSetting 的 success 回调里的权限状态有些情况下可能不是最新的。保险起见，从设置页返回后再调一次 getSetting 确认。

另外，openSetting 不能代替 authorize。它只是引导用户手动操作，用户可以在设置页选择开启或关闭，开发者无法控制。

getSetting 的另一个限制是：它只返回之前 authorize 过的 scope。从来没申请过的权限不会出现在结果里。要检查某个权限是否已授权，得先 authorize 过一次。

四、典型使用场景

场景一：授权失败后弹窗引导去设置页。这是最常见流程：authorize 失败后调用 has.showModal，用户点“去设置”再调用 has.openSetting。

2. Page({
3.   getLocationWithGuide() {
4.     has.authorize({
5.       scope: 'scope.userLocation',
6.       success: () => {
7.         has.getLocation({
8.           success: (res) => {
9.             console.info('位置:', res);
10.           }
11.         });
12.       },
13.       fail: (err) => {
14.         console.info('授权失败，引导去设置:', err);
15.         has.showModal({
16.           title: '需要定位权限',
17.           content: '请在设置中开启定位权限，否则无法使用此功能',
18.           confirmText: '去设置',
19.           cancelText: '取消',
20.           success: (modalRes) => {
21.             if (modalRes.confirm) {
22.               has.openSetting({
23.                 success: (settingRes) => {
24.                   console.info('用户从设置页返回');
25.                 }
26.               });
27.             }
28.           }
29.         });
30.       }
31.     });
32.   }
33. });

复制代码

场景二：先用 getSetting 检查，未授权再申请。

2. Page({
3.   checkAndAuthorize() {
4.     has.getSetting({
5.       success: (res) => {
6.         if (res['scope.camera']) {
7.           this.openCamera();
8.         } else {
9.           has.authorize({
10.             scope: 'scope.camera',
11.             success: () => {
12.               this.openCamera();
13.             },
14.             fail: () => {
15.               has.showToast({ title: '需要相机权限' });
16.             }
17.           });
18.         }
19.       }
20.     });
21.   },
22.   openCamera() {
23.     const ctx = has.createCameraContext();
24.     // ...
25.   }
26. });

复制代码

场景三：页面加载时检查所有权限状态，适合设置页展示开关。

2. Page({
3.   data: {
4.     permissions: {
5.       location: false,
6.       camera: false,
7.       microphone: false,
8.       contact: false
9.     }
10.   },
11.   onShow() {
12.     this.checkPermissions();
13.   },
14.   checkPermissions() {
15.     has.getSetting({
16.       success: (res) => {
17.         this.setData({
18.           permissions: {
19.             location: !!res['scope.userLocation'],
20.             camera: !!res['scope.camera'],
21.             microphone: !!res['scope.record'],
22.             contact: !!res['scope.contact']
23.           }
24.         });
25.       }
26.     });
27.   },
28.   goToSetting() {
29.     has.openSetting();
30.   }
31. });

复制代码

场景四：结合辅助功能权限。项目若用 has.openAccessibility 做辅助功能检测，用户拒绝后可引导去设置。err.code === 203 表示用户手动关闭了辅助功能。

2. has.openAccessibility({
3.   success: () => {
4.     console.info('辅助功能已开启');
5.   },
6.   fail: (err) => {
7.     if (err.code === 203) {
8.       has.showModal({
9.         title: '需要辅助功能',
10.         content: '请在设置中开启辅助功能',
11.         confirmText: '去设置',
12.         success: (res) => {
13.           if (res.confirm) {
14.             has.openSetting();
15.           }
16.         }
17.       });
18.     }
19.   }
20. });

复制代码

五、完整流程与封装

authorize + openSetting 的流程可以概括为：

2. 调用 has.authorize
3. ├── success → 权限已拿到，继续业务
4. └── fail
5.     ├── 弹窗提示用户
6.     │   ├── 用户点“去设置”
7.     │   │   └── 调用 has.openSetting
8.     │   │       └── 用户在设置页操作
9.     │   │           └── 返回后重新 authorize/getSetting
10.     │   └── 用户点“取消”
11.     │       └── 结束或降级处理
12.     └── getSetting 检查是否还有其他权限需要申请

复制代码

由于流程固定，可以封装 ensurePermission：

2. function ensurePermission(scope, scopeName) {
3.   return new Promise((resolve, reject) => {
4.     has.authorize({
5.       scope: scope,
6.       success: () => resolve(),
7.       fail: () => {
8.         has.showModal({
9.           title: '需要' + scopeName + '权限',
10.           content: '请在设置中开启' + scopeName + '权限',
11.           confirmText: '去设置',
12.           cancelText: '取消',
13.           success: (res) => {
14.             if (res.confirm) {
15.               has.openSetting({
16.                 success: () => reject(new Error('需要用户重新授权'))
17.               });
18.             } else {
19.               reject(new Error('用户拒绝授权'));
20.             }
21.           }
22.         });
23.       }
24.     });
25.   });
26. }
28. async function getLocation() {
29.   try {
30.     await ensurePermission('scope.userLocation', '定位');
31.     const res = await new Promise((resolve, reject) => {
32.       has.getLocation({ success: resolve, fail: reject });
33.     });
34.     return res;
35.   } catch (err) {
36.     console.error(err.message);
37.   }
38. }

复制代码

六、调试与落地提醒

在 DevEco Studio 的模拟器上，openSetting 可能表现和真机不一样，建议真机测试。项目里的 openSetting Demo 已经注册到“开放能力”分类下，可以直接体验；getSetting 的示例没有单独做，但文中代码可直接复制使用。

最后记住几个关键点：openSetting 必须在 authorize 之后；设置页返回后授权状态会重置，要重新确认；getSetting 只返回申请过的权限；openSetting 回调状态可能不是最新，必要时用 getSetting 二次确认。