• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# @ohos.systemCapability (系统能力)
2
3系统能力（SystemCapability，简称SysCap），指操作系统中每一个相对独立的特性。不同的设备对应不同的系统能力集，每个系统能力对应多个接口。开发者可根据系统能力来判断是否可以使用某接口。本模块提供接口可查询系统能力的集合。
4
5> **说明：**
6>
7> - 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
8>
9> - 本模块接口为系统接口。
10
11
12## 导入模块
13
14```ts
15import systemcapability from '@ohos.systemCapability'
16```
17
18## systemcapability.querySystemCapabilities
19
20querySystemCapabilities(callback: AsyncCallback<string>): void;
21
22获取系统能力集合的字符串，并调用回调函数。
23
24**系统能力：** SystemCapability.Developtools.Syscap
25
26**参数：**
27
28| 参数名 | 类型 | 必填 | 说明 |
29| -------- | -------- | -------- | -------- |
30| callback | AsyncCallback<string> | 是 | 回调函数 |
31
32
33**示例：**
34
35```ts
36try {
37    systemcapability.querySystemCapabilities(function (err, data) {
38    if (err == undefined) {
39        console.log("get system capabilities:" + data)
40    } else {
41        console.log(" get system capabilities err:" + err.code)
42    }});
43}catch(e){
44    console.log("get unexpected error: " + e);
45}
46```
47
48
49## systemcapability.querySystemCapabilities
50
51querySystemCapabilities(): Promise&lt;string&gt;
52
53获取系统能力的集合。
54
55**系统能力：** SystemCapability.Developtools.Syscap
56
57**返回值：**
58
59| 类型 | 说明 |
60| -------- | -------- |
61| Promise&lt;string&gt; | Promise示例，用于异步获取结果。 |
62
63**示例：**
64
65```ts
66try {
67    var p = systemcapability.querySystemCapabilities();
68    p.then(function (value) {
69        console.log("get system capabilities: " + value);
70    }).catch(function (err) {
71        console.log("get system capabilities error: " + err.code);
72    });
73}catch(e){
74    console.log("get unexpected error: " + e);
75}
76```
77
78
79> **说明：**
80>
81> 以上接口所返回的system capability集合形式均为编码后的数字字符串形式。
82
83
84