設備使用信息統計

本模塊提供設備使用信息統計能力。

設備使用信息統計，系統應用可調用接口實現如下功能：

• 查詢設備上各應用在不同時間段的使用時長、各應用的事件（前臺、后臺、長時任務開始、長時任務結束）信息及各應用的通知次數信息。
• 查詢系統事件（休眠、喚醒、解鎖、鎖屏）統計信息。
• 查詢應用分組信息（其他應用和自身應用）。
• 查詢應用空閑狀態（其他應用和自身應用）。
• 設置應用分組信息（其他應用）。
• 注冊和解除注冊應用分組變化監聽。

三方應用可調用接口實現如下功能：

• 查詢應用空閑狀態（僅限自身應用）。
• 查詢應用分組信息（僅限自身應用）。
• 查詢應用事件（僅限自身應用）。

說明： 本模塊首批接口從API version 7開始支持。后續版本的新增接口，采用上角標單獨標記接口的起始版本。 開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]點擊或者復制轉到。

導入模塊

import bundleState from '@ohos.bundleState'

bundleState.isIdleState

isIdleState(bundleName: string, callback: AsyncCallback): void

判斷指定bundleName的應用當前是否是空閑狀態，使用Callback形式返回。

系統能力 ：SystemCapability.ResourceSchedule.UsageStatistics.AppGroup

參數 ：

示例 ：

bundleState.isIdleState("com.ohos.camera", (err, res) = > {
      if (err) {
          console.log('BUNDLE_ACTIVE isIdleState callback failed, because: ' + err.code);
      } else {
          console.log('BUNDLE_ACTIVE isIdleState callback succeeded, result: ' + JSON.stringify(res));
      }
  });

bundleState.isIdleState

isIdleState(bundleName: string): Promise

判斷指定bundleName的應用當前是否是空閑狀態，使用Promise形式返回。

系統能力 ：SystemCapability.ResourceSchedule.UsageStatistics.AppGroup

參數 ：

返回值 ：

示例 ：

bundleState.isIdleState("com.ohos.camera").then( res = > {
      console.log('BUNDLE_ACTIVE isIdleState promise succeeded, result: ' + JSON.stringify(res));
  }).catch( err = > {
      console.log('BUNDLE_ACTIVE isIdleState promise failed, because: ' + err.code);
  });

bundleState.queryAppUsagePriorityGroup

queryAppUsagePriorityGroup(callback: AsyncCallback): void

查詢（返回）當前調用者應用的使用優先級群組，使用Callback形式返回。

系統能力 ：SystemCapability.ResourceSchedule.UsageStatistics.AppGroup

參數 ：

示例 ：

bundleState.queryAppUsagePriorityGroup((err, res) = > {
      if (err) {
          console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup callback failed. because: ' + err.code);
      } else {
          console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup callback succeeded. result: ' + JSON.stringify(res));
      }
  });

bundleState.queryAppUsagePriorityGroup

queryAppUsagePriorityGroup(): Promise

查詢（返回）當前調用者應用的使用優先級群組，使用Promise形式返回。

系統能力 ：SystemCapability.ResourceSchedule.UsageStatistics.AppGroup

返回值 ：

示例 ：

bundleState.queryAppUsagePriorityGroup().then( res = > {
      console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup promise succeeded. result: ' + JSON.stringify(res));
  }).catch( err = > {
      console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup promise failed. because: ' + err.code);
  });

bundleState.queryBundleStateInfos

queryBundleStateInfos(begin: number, end: number, callback: AsyncCallback): void

通過指定起始和結束時間查詢應用使用時長統計信息，使用Callback形式返回。

需要權限 ：ohos.permission.BUNDLE_ACTIVE_INFO

系統能力 ：SystemCapability.ResourceSchedule.UsageStatistics.App

系統API ：此接口為系統接口，三方應用不支持調用。

參數 ：

示例 ：

bundleState.queryBundleStateInfos(0, 20000000000000, (err, res) = > {
      if (err) {
          console.log('BUNDLE_ACTIVE queryBundleStateInfos callback failed, because: ' + err.code);
      } else {
          console.log('BUNDLE_ACTIVE queryBundleStateInfos callback success.');
          let i = 1;
          for(let key in res){
              console.log('BUNDLE_ACTIVE queryBundleStateInfos callback number : ' + i);
              console.log('BUNDLE_ACTIVE queryBundleStateInfos callback result ' + JSON.stringify(res[key]));
              i++;
          }
      }
  });

bundleState.queryBundleStateInfos

queryBundleStateInfos(begin: number, end: number): Promise

通過指定起始和結束時間查詢應用使用時長統計信息，使用Promise形式返回。

需要權限 ：ohos.permission.BUNDLE_ACTIVE_INFO

系統能力 ：SystemCapability.ResourceSchedule.UsageStatistics.App

系統API ：此接口為系統接口，三方應用不支持調用。

參數 ：

返回值 ：

示例 ：

bundleState.queryBundleStateInfos(0, 20000000000000).then( res = > {
      console.log('BUNDLE_ACTIVE queryBundleStateInfos promise success.');
      let i = 1;
      for(let key in res){
          console.log('BUNDLE_ACTIVE queryBundleStateInfos promise number : ' + i);
          console.log('BUNDLE_ACTIVE queryBundleStateInfos promise result ' + JSON.stringify(res[key]));
          i++;
      }
  }).catch( err = > {
      console.log('BUNDLE_ACTIVE queryBundleStateInfos promise failed, because: ' + err.code);
  });

bundleState.queryBundleStateInfoByInterval

queryBundleStateInfoByInterval(byInterval: IntervalType, begin: number, end: number, callback: AsyncCallback>): void

通過指定時間段間隔（天、周、月、年）查詢應用使用時長統計信息，使用Callback形式返回。

需要權限 ：ohos.permission.BUNDLE_ACTIVE_INFO

系統能力 ：SystemCapability.ResourceSchedule.UsageStatistics.App

系統API ：此接口為系統接口，三方應用不支持調用。

參數 ：

示例 ：

bundleState.queryBundleStateInfoByInterval(0, 0, 20000000000000, (err, res) = > {
      if (err) {
          console.log('BUNDLE_ACTIVE queryBundleStateInfoByInterval callback failed, because: ' + err.code);
      } else {
          console.log('BUNDLE_ACTIVE queryBundleStateInfoByInterval callback success.');
          for (let i = 0; i < res.length; i++) {
              console.log('BUNDLE_ACTIVE queryBundleStateInfoByInterval callback number : ' + (i + 1));
              console.log('BUNDLE_ACTIVE queryBundleStateInfoByInterval callback result ' + JSON.stringify(res[i]));
          }
      }
  });

bundleState.queryBundleStateInfoByInterval

queryBundleStateInfoByInterval(byInterval: IntervalType, begin: number, end: number): Promise>

通過指定時間段間隔（天、周、月、年）查詢應用使用時長統計信息，使用Promise形式返回。

需要權限 ：ohos.permission.BUNDLE_ACTIVE_INFO

系統能力 ：SystemCapability.ResourceSchedule.UsageStatistics.App

系統API ：此接口為系統接口，三方應用不支持調用。

參數 ：

返回值 ：

示例 ：

bundleState.queryBundleStateInfoByInterval(0, 0, 20000000000000).then( res = > {
      console.log('BUNDLE_ACTIVE queryBundleStateInfoByInterval promise success.');
      for (let i = 0; i < res.length; i++) {
          console.log('BUNDLE_ACTIVE queryBundleStateInfoByInterval promise number : ' + (i + 1));
          console.log('BUNDLE_ACTIVE queryBundleStateInfoByInterval promise result ' + JSON.stringify(res[i]));
      }
  }).catch( err = > {
      console.log('BUNDLE_ACTIVE queryBundleStateInfoByInterval promise failed, because: ' + err.code);
  });

bundleState.queryBundleActiveStates

queryBundleActiveStates(begin: number, end: number, callback: AsyncCallback>): void

通過指定起始和結束時間查詢所有應用的事件集合，使用Callback形式返回。

需要權限 ：ohos.permission.BUNDLE_ACTIVE_INFO

系統能力 ：SystemCapability.ResourceSchedule.UsageStatistics.App

系統API ：此接口為系統接口，三方應用不支持調用。

參數 ：

示例 ：

bundleState.queryBundleActiveStates(0, 20000000000000, (err, res) = > {
      if (err) {
          console.log('BUNDLE_ACTIVE queryBundleActiveStates callback failed, because: ' + err.code);
      } else {
          console.log('BUNDLE_ACTIVE queryBundleActiveStates callback success.');
          for (let i = 0; i < res.length; i++) {
              console.log('BUNDLE_ACTIVE queryBundleActiveStates callback number : ' + (i + 1));
              console.log('BUNDLE_ACTIVE queryBundleActiveStates callback result ' + JSON.stringify(res[i]));
          }
      }
  });

bundleState.queryBundleActiveStates

queryBundleActiveStates(begin: number, end: number): Promise>

通過指定起始和結束時間查詢所有應用的事件集合，使用Promise形式返回。

需要權限 ：ohos.permission.BUNDLE_ACTIVE_INFO

系統能力 ：SystemCapability.ResourceSchedule.UsageStatistics.App

系統API ：此接口為系統接口，三方應用不支持調用。

參數 ：

返回值 ：

示例 ：

bundleState.queryBundleActiveStates(0, 20000000000000).then( res = > {
      console.log('BUNDLE_ACTIVE queryBundleActiveStates promise success.');
      for (let i = 0; i < res.length; i++) {
          console.log('BUNDLE_ACTIVE queryBundleActiveStates promise number : ' + (i + 1));
          console.log('BUNDLE_ACTIVE queryBundleActiveStates promise result ' + JSON.stringify(res[i]));
      }
  }).catch( err = > {
      console.log('BUNDLE_ACTIVE queryBundleActiveStates promise failed, because: ' + err.code);
  });

bundleState.queryCurrentBundleActiveStates

queryCurrentBundleActiveStates(begin: number, end: number, callback: AsyncCallback>): void

通過指定起始和結束時間查詢當前應用的事件集合，使用Callback形式返回。

系統能力 ：SystemCapability.ResourceSchedule.UsageStatistics.App

參數 ：

示例 ：

bundleState.queryCurrentBundleActiveStates(0, 20000000000000, (err, res) = > {
      if (err) {
          console.log('BUNDLE_ACTIVE queryCurrentBundleActiveStates callback failed, because: ' + err.code);
      } else {
          console.log('BUNDLE_ACTIVE queryCurrentBundleActiveStates callback success.');
          for (let i = 0; i < res.length; i++) {
              console.log('BUNDLE_ACTIVE queryCurrentBundleActiveStates callback number : ' + (i + 1));
              console.log('BUNDLE_ACTIVE queryCurrentBundleActiveStates callback result ' + JSON.stringify(res[i]));
          }
      }
  });

bundleState.queryCurrentBundleActiveStates

queryCurrentBundleActiveStates(begin: number, end: number): Promise>

通過指定起始和結束時間查詢當前應用的事件集合，使用Promise形式返回。

系統能力 ：SystemCapability.ResourceSchedule.UsageStatistics.App

參數 ：

返回值 ：

示例 ：

bundleState.queryCurrentBundleActiveStates(0, 20000000000000).then( res = > {
      console.log('BUNDLE_ACTIVE queryCurrentBundleActiveStates promise success.');
      for (let i = 0; i < res.length; i++) {
          console.log('BUNDLE_ACTIVE queryCurrentBundleActiveStates promise number : ' + (i + 1));
          console.log('BUNDLE_ACTIVE queryCurrentBundleActiveStates promise result ' + JSON.stringify(res[i]));
      }
  }).catch( err = > {
      console.log('BUNDLE_ACTIVE queryCurrentBundleActiveStates promise failed, because: ' + err.code);
  });

bundleState.getRecentlyUsedModules9+

getRecentlyUsedModules(maxNum?: number): Promise>

據maxNum，查詢FA使用記錄，使用Promise形式返回不超過maxNum條FA使用記錄，FA使用記錄由近及遠排序，maxNum最大為1000。

需要權限 ：ohos.permission.BUNDLE_ACTIVE_INFO

系統能力 ：SystemCapability.ResourceSchedule.UsageStatistics.App

系統API ：此接口為系統接口，三方應用不支持調用。

參數 ：

返回值 ：

示例 ：

bundleState.getRecentlyUsedModules(1000).then( res = > {
      console.log('BUNDLE_ACTIVE getRecentlyUsedModules promise succeeded');
      for (let i = 0; i < res.length; i++) {
          console.log('BUNDLE_ACTIVE getRecentlyUsedModules promise number : ' + (i + 1));
          console.log('BUNDLE_ACTIVE getRecentlyUsedModules promise result ' + JSON.stringify(res[i]));
      }
  }).catch( err= > {
      console.log('BUNDLE_ACTIVE getRecentlyUsedModules promise failed, because: ' + err.code);
  });

  // 無maxNum參數調用方式
  bundleState.getRecentlyUsedModules().then( res = > {
      console.log('BUNDLE_ACTIVE getRecentlyUsedModules promise succeeded');
      for (let i = 0; i < res.length; i++) {
          console.log('BUNDLE_ACTIVE getRecentlyUsedModules promise number : ' + (i + 1));
          console.log('BUNDLE_ACTIVE getRecentlyUsedModules promise result ' + JSON.stringify(res[i]));
      }
  }).catch( err= > {
      console.log('BUNDLE_ACTIVE getRecentlyUsedModules promise failed, because: ' + err.code);
  });

bundleState.getRecentlyUsedModules9+

getRecentlyUsedModules(maxNum?: number, callback: AsyncCallback>): void

查詢FA使用記錄。使用CallBack形式返回數量最大不超過maxNum設置的值，FA使用記錄由近及遠排序，maxNum最大為1000。

需要權限 ：ohos.permission.BUNDLE_ACTIVE_INFO

系統能力 ：SystemCapability.ResourceSchedule.UsageStatistics.App

系統API ：此接口為系統接口，三方應用不支持調用。

參數 ：

示例 ：

bundleState.getRecentlyUsedModules(1000,(err, res) = > {
      if(err) {
          console.log('BUNDLE_ACTIVE getRecentlyUsedModules callback failed, because: ' + err.code);
      } else {
          console.log('BUNDLE_ACTIVE getRecentlyUsedModules callback succeeded.');
              for (let i = 0; i < res.length; i++) {
                  console.log('BUNDLE_ACTIVE getRecentlyUsedModules callback number : ' + (i + 1));
                  console.log('BUNDLE_ACTIVE getRecentlyUsedModules callback result ' + JSON.stringify(res[i]));
              }
      }
  });

  // 無maNum參數調用方式
  bundleState.getRecentlyUsedModules((err, res) = > {
      if(err) {
          console.log('BUNDLE_ACTIVE getRecentlyUsedModules callback failed, because: ' + err.code);
      } else {
          console.log('BUNDLE_ACTIVE getRecentlyUsedModules callback succeeded.');
              for (let i = 0; i < res.length; i++) {
                  console.log('BUNDLE_ACTIVE getRecentlyUsedModules callback number : ' + (i + 1));
                  console.log('BUNDLE_ACTIVE getRecentlyUsedModules callback result ' + JSON.stringify(res[i]));
              }
          }
  });

BundleActiveModuleInfo9+

FA的使用信息的屬性集合。

系統能力 ：以下各項對應的系統能力均為SystemCapability.ResourceSchedule.UsageStatistics.App

BundleActiveFormInfo9+

FA卡片的使用信息的屬性集合。

系統能力 ：以下各項對應的系統能力均為SystemCapability.ResourceSchedule.UsageStatistics.App

BundleStateInfo

提供應用使用時長的具體信息。

屬性

系統能力 ：以下各項對應的系統能力均為SystemCapability.ResourceSchedule.UsageStatistics.App

merge

merge(toMerge: BundleStateInfo): void

合并相同包名的應用使用信息。

系統能力 ：SystemCapability.ResourceSchedule.UsageStatistics.App

參數 ：

BundleActiveState

提供應用事件的具體信息。

系統能力 ：以下各項對應的系統能力均為SystemCapability.ResourceSchedule.UsageStatistics.App

BundleActiveInfoResponse

提供應用使用時長的具體信息。

系統能力 ：SystemCapability.ResourceSchedule.UsageStatistics.App

IntervalType

提供應用使用時長的查詢類型。

系統能力 ：以下各項對應的系統能力均為SystemCapability.ResourceSchedule.UsageStatistics.App