• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# @ohos.bundleState (设备使用信息统计)
2
3本模块提供设备使用信息统计能力。
4
5> **说明：**
6>
7> 从API version9开始，该接口不再维护，替代接口仅向系统应用开放。
8>
9> 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
10
11
12## 导入模块
13
14```js
15import bundleState from '@ohos.bundleState'
16```
17
18## bundleState.isIdleState<sup>(deprecated)</sup>
19
20isIdleState(bundleName: string, callback: AsyncCallback&lt;boolean&gt;): void
21> 从API version 7开始支持，从API version 9开始废弃，替代接口仅向系统应用开放。
22
23判断指定bundleName的应用当前是否是空闲状态，三方应用只能查询自身的空闲状态。系统应用支持查询其他应用的空闲状态，查询前需要申请权限ohos.permission.BUNDLE_ACTIVE_INFO。使用Callback异步回调。
24
25**系统能力**：SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
26
27**参数**：
28
29| 参数名        | 类型                           | 必填   | 说明                                       |
30| ---------- | ---------------------------- | ---- | ---------------------------------------- |
31| bundleName | string                       | 是    | 应用的bundleName。                           |
32| callback   | AsyncCallback&lt;boolean&gt; | 是    | 指定的callback回调方法。如果指定的bundleName有效，则返回指定bundleName的应用当前是否是空闲状态；否则返回null。 |
33
34**示例**：
35
36```ts
37import { BusinessError } from '@ohos.base';
38// 三方应用使用示例代码时，注意将bundleName更换为自己应用的bundleName
39bundleState.isIdleState("com.ohos.camera", (err: BusinessError, res: boolean) => {
40  if (err) {
41    console.error('BUNDLE_ACTIVE isIdleState callback failed, because: ' + err.code);
42  } else {
43    console.log('BUNDLE_ACTIVE isIdleState callback succeeded, result: ' + JSON.stringify(res));
44  }
45});
46```
47
48## bundleState.isIdleState<sup>(deprecated)</sup>
49
50isIdleState(bundleName: string): Promise&lt;boolean&gt;
51> 从API version 7开始支持，从API version 9开始废弃，替代接口仅向系统应用开放。
52
53判断指定bundleName的应用当前是否是空闲状态，三方应用只能查询自身的空闲状态。系统应用支持查询其他应用的空闲状态，查询前需要申请权限ohos.permission.BUNDLE_ACTIVE_INFO，使用Promise异步回调。
54
55**系统能力**：SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
56
57**参数**：
58
59| 参数名        | 类型     | 必填   | 说明             |
60| ---------- | ------ | ---- | -------------- |
61| bundleName | string | 是    | 应用的bundleName。 |
62
63**返回值**：
64
65| 类型                     | 说明                                       |
66| ---------------------- | ---------------------------------------- |
67| Promise&lt;boolean&gt; | 指定的Promise回调方法。如果指定的bundleName有效，则返回指定bundleName的应用当前是否是空闲状态；否则返回null。 |
68
69**示例**：
70
71```ts
72import { BusinessError } from '@ohos.base';
73// 三方应用使用示例代码时，注意将bundleName更换为自己应用的bundleName
74bundleState.isIdleState("com.ohos.camera").then((res: boolean) => {
75  console.log('BUNDLE_ACTIVE isIdleState promise succeeded, result: ' + JSON.stringify(res));
76}).catch((err: BusinessError) => {
77  console.error('BUNDLE_ACTIVE isIdleState promise failed, because: ' + err.code);
78});
79```