diff --git a/zh-cn/application-dev/reference/apis/Readme-CN.md b/zh-cn/application-dev/reference/apis/Readme-CN.md index 7794befe61158c82b71fdf5dbe1339cec0d89713..ddf2b4c4db3d2f27b4139b53985ef73b415e9616 100755 --- a/zh-cn/application-dev/reference/apis/Readme-CN.md +++ b/zh-cn/application-dev/reference/apis/Readme-CN.md @@ -249,6 +249,7 @@ - [@ohos.runningLock (Runninglock锁)](js-apis-runninglock.md) - [@ohos.sensor (传感器)](js-apis-sensor.md) - [@ohos.settings (设置数据项名称)](js-apis-settings.md) + - [@ohos.systemCapability (系统能力)](js-apis-system-capability.md) - [@ohos.systemParameterV9 (系统属性)](js-apis-system-parameterV9.md) - [@ohos.thermal (热管理)](js-apis-thermal.md) - [@ohos.update (升级)](js-apis-update.md) diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-capability.md b/zh-cn/application-dev/reference/apis/js-apis-system-capability.md new file mode 100755 index 0000000000000000000000000000000000000000..70b91f50ab52636310a2f5ca9309acd172bb0e0a --- /dev/null +++ b/zh-cn/application-dev/reference/apis/js-apis-system-capability.md @@ -0,0 +1,80 @@ +# 系统能力 + +系统能力(SystemCapability,简称SysCap),指操作系统中每一个相对独立的特性。不同的设备对应不同的系统能力集,每个系统能力对应多个接口。开发者可根据系统能力来判断是否可以使用某接口。本模块提供接口可查询系统能力的集合。 + +> **说明:** +> - 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 +> - 本模块接口为系统接口。 + + +## 导入模块 + +```ts +import systemcapability from '@ohos.systemCapability' +``` + +## systemcapability.querySystemCapabilities + +querySystemCapabilities(callback: AsyncCallback): void; + +获取系统能力集合的字符串,并调用回调函数。 + +**系统能力:** SystemCapability.Developtools.Syscap + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| callback | AsyncCallback | 是 | 回调函数 | + + +**示例:** + +```ts +try { + systemcapability.querySystemCapabilities(function (err, data) { + if (err == undefined) { + console.log("get system capabilities:" + data) + } else { + console.log(" get system capabilities err:" + err.code) + }}); +}catch(e){ + console.log("get unexpected error: " + e); +} +``` + + +## systemcapability.querySystemCapabilities + +querySystemCapabilities(): Promise<string> + +获取系统能力的集合。 + +**系统能力:** SystemCapability.Startup.SystemInfo + +**返回值:** + +| 类型 | 说明 | +| -------- | -------- | +| Promise<string> | Promise示例,用于异步获取结果。 | + +**示例:** + +```ts +try { + var p = systemcapability.querySystemCapabilities(); + p.then(function (value) { + console.log("get system capabilities: " + value); + }).catch(function (err) { + console.log("get system capabilities error: " + err.code); + }); +}catch(e){ + console.log("get unexpected error: " + e); +} +``` + + +> **说明:** +> - 以上接口所返回的system capability集合形式均为编码后的数字字符串形式。 + +