• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# PermissionRequestResult
2
3权限请求结果对象,在调用[requestPermissionsFromUser](js-apis-abilityAccessCtrl.md#requestpermissionsfromuser9)申请权限时返回此对象表明此次权限申请的结果。
4
5> **说明:**
6>
7> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
8> 本模块接口仅可在Stage模型下使用。
9
10## 属性
11
12**系统能力**:以下各项对应的系统能力均为SystemCapability.Security.AccessToken
13
14| 名称 | 类型 | 可读 | 可写 | 说明 |
15| -------- | -------- | -------- | -------- | -------- |
16| permissions | Array<string> | 是 | 否 | 用户传入的权限。|
17| authResults | Array&lt;number&gt; | 是 | 否 | 相应请求权限的结果:<br>- -1:未授权,表示权限已设置,无需弹窗,需要用户在"设置"中修改。<br>- 0:已授权。<br>- 2:未授权,表示请求无效,可能原因有:<br>  -未在设置文件中声明目标权限。<br>  -权限名非法。<br>  -部分权限存在特殊申请条件,在申请对应权限时未满足其指定的条件,见[ohos.permission.LOCATION](../../security/permission-list.md#ohospermissionlocation)与[ohos.permission.APPROXIMATELY_LOCATION](../../security/permission-list.md#ohospermissionapproximately_location) |
18
19## 使用说明
20
21通过atManager实例来获取。
22
23**示例:**
24
25ArkTS语法不支持直接使用globalThis,需要通过一个单例的map来做中转。开发者需要:
26
27a. 在EntryAbility.ets中导入构建的单例对象GlobalThis。
28  ```typescript
29    import { GlobalThis } from '../utils/globalThis'; // 需要根据globalThis.ets的路径自行适配
30  ```
31b. 在onCreate中添加:
32  ```typescript
33    GlobalThis.getInstance().setContext('context', this.context);
34  ```
35
36> **说明:**
37>
38> 由于在ts中引入ets文件会有告警提示,需要将EntryAbility.ts的文件后缀修改为EntryAbility.ets,并在module.json5中同步修改。
39
40**globalThis.ets示例代码如下:**
41```typescript
42import common from '@ohos.app.ability.common';
43
44// 构造单例对象
45export class GlobalThis {
46  private constructor() {}
47  private static instance: GlobalThis;
48  private _uiContexts = new Map<string, common.UIAbilityContext>();
49
50  public static getInstance(): GlobalThis {
51    if (!GlobalThis.instance) {
52      GlobalThis.instance = new GlobalThis();
53    }
54    return GlobalThis.instance;
55  }
56
57  getContext(key: string): common.UIAbilityContext | undefined {
58    return this._uiContexts.get(key);
59  }
60
61  setContext(key: string, value: common.UIAbilityContext): void {
62    this._uiContexts.set(key, value);
63  }
64
65  // 其他需要传递的内容依此扩展
66}
67```
68
69```ts
70import { BusinessError } from '@ohos.base';
71import abilityAccessCtrl from '@ohos.abilityAccessCtrl';
72import common from '@ohos.app.ability.common';
73import { GlobalThis } from '../utils/globalThis';
74
75let atManager = abilityAccessCtrl.createAtManager();
76try {
77  let context: common.UIAbilityContext = GlobalThis.getInstance().getContext('context');
78  atManager.requestPermissionsFromUser(context, ["ohos.permission.CAMERA"]).then((data) => {
79      console.info("data:" + JSON.stringify(data));
80      console.info("data permissions:" + data.permissions);
81      console.info("data authResults:" + data.authResults);
82  }).catch((err: BusinessError) => {
83      console.info("data:" + JSON.stringify(err));
84  })
85} catch(err) {
86  console.log(`catch err->${JSON.stringify(err)}`);
87}
88```