@ohos.resourceschedule.usageStatistics (设备使用信息统计)

本模块提供设备使用信息统计能力。

设备使用信息统计，系统应用可调用接口实现如下功能：

• 查询设备上各应用在不同时间段的使用时长、各应用的事件（前台、后台、长时任务开始、长时任务结束）信息及各应用的通知次数信息。
• 查询系统事件（休眠、唤醒、解锁、锁屏）统计信息。
• 查询应用分组信息（其他应用和自身应用）。
• 查询应用空闲状态（其他应用和自身应用）。
• 设置应用分组信息（其他应用）。
• 注册和解除注册应用分组变化监听。

三方应用可调用接口实现如下功能：

• 查询应用空闲状态（仅限自身应用）。
• 查询应用分组信息（仅限自身应用）。
• 查询应用事件（仅限自身应用）。

说明：

本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import usageStatistics from '@ohos.resourceschedule.usageStatistics'

usageStatistics.isIdleState

isIdleState(bundleName: string, callback: AsyncCallback<boolean>): void

判断指定bundleName的应用当前是否是空闲状态，三方应用只能查询自身的空闲状态，使用Callback形式返回。

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

系统API：此接口为系统接口。

参数：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

示例：

  try{
      usageStatistics.isIdleState("com.ohos.camera", (err, res) => {
          if (err) {
              console.log('BUNDLE_ACTIVE isIdleState callback failed. code is: ' + err.code + ',message is: ' + err.message);
          } else {
              console.log('BUNDLE_ACTIVE isIdleState callback succeeded, result: ' + JSON.stringify(res));
          }
      });
  } catch(error) {
      console.log('BUNDLE_ACTIVE isIdleState throw error, code is: ' + error.code + ',message is: ' + error.message);
  }

usageStatistics.isIdleState

isIdleState(bundleName: string): Promise<boolean>

判断指定bundleName的应用当前是否是空闲状态，三方应用只能查询自身的空闲状态，使用Promise形式返回。

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

系统API：此接口为系统接口。

参数：

返回值：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

示例：

  try{
      usageStatistics.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. code is: ' + err.code + ',message is: ' + err.message);
      });
  } catch (error) {
      console.log('BUNDLE_ACTIVE isIdleState throw error, code is: ' + error.code + ',message is: ' + error.message);
  }

usageStatistics.queryAppGroup

queryAppGroup(): Promise<number>

查询当前应用的优先级分组。使用Promise形式返回其应用分组。

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

系统API：此接口为系统接口。

返回值：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

示例：

    try{
        usageStatistics.queryAppGroup().then( res => {
            console.log('BUNDLE_ACTIVE queryAppGroup promise succeeded. result: ' + JSON.stringify(res));
        }).catch( err => {
            console.log('BUNDLE_ACTIVE queryAppGroup promise failed. code is: ' + err.code + ',message is: ' + err.message);
        });
    } catch (error) {
        console.log('BUNDLE_ACTIVE queryAppGroup throw error, code is: ' + error.code + ',message is: ' + error.message);
    }

usageStatistics.queryAppGroup

queryAppGroup(callback: AsyncCallback<number>): void

查询当前应用的优先级分组。使用callback形式返回其应用分组。

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

系统API：此接口为系统接口。

参数：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

示例：

    try{
        usageStatistics.queryAppGroup((err, res) => {
            if(err) {
                console.log('BUNDLE_ACTIVE queryAppGroup callback failed. code is: ' + err.code + ',message is: ' + err.message);
            } else {
                console.log('BUNDLE_ACTIVE queryAppGroup callback succeeded. result: ' + JSON.stringify(res));
            }
        });
    } catch (error) {
        console.log('BUNDLE_ACTIVE queryAppGroup throw error, code is: ' + error.code + ',message is: ' + error.message);
    }

usageStatistics.queryBundleStatsInfos

queryBundleStatsInfos(begin: number, end: number, callback: AsyncCallback<BundleStatsMap>): void

通过指定起始和结束时间查询应用使用时长统计信息，使用Callback形式返回。

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

系统API：此接口为系统接口。

参数：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

示例：

  try{
      usageStatistics.queryBundleStatsInfos(0, 20000000000000, (err, res) => {
          if (err) {
              console.log('BUNDLE_ACTIVE queryBundleStatsInfos callback failed. code is: ' + err.code + ',message is: ' + err.message);
          } else {
              console.log('BUNDLE_ACTIVE queryBundleStatsInfos callback success.');
              let i = 1;
              for(let key in res){
                  console.log('BUNDLE_ACTIVE queryBundleStatsInfos callback number : ' + i);
                  console.log('BUNDLE_ACTIVE queryBundleStatsInfos callback result ' + JSON.stringify(res[key]));
                  i++;
              }
          }
      });
  } catch (error) {
      console.log('BUNDLE_ACTIVE queryBundleStatsInfos throw error, code is: ' + error.code + ',message is: ' + error.message);
  }

usageStatistics.queryBundleStatsInfos

queryBundleStatsInfos(begin: number, end: number): Promise<BundleStatsMap>

通过指定起始和结束时间查询应用使用时长统计信息，使用Promise形式返回。

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

系统API：此接口为系统接口。

参数：

返回值：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

示例：

  try{
      usageStatistics.queryBundleStatsInfos(0, 20000000000000).then( res => {
          console.log('BUNDLE_ACTIVE queryBundleStatsInfos promise success.');
          let i = 1;
          for(let key in res){
              console.log('BUNDLE_ACTIVE queryBundleStatsInfos promise number : ' + i);
              console.log('BUNDLE_ACTIVE queryBundleStatsInfos promise result ' + JSON.stringify(res[key]));
              i++;
          }
      }).catch( err => {
          console.log('BUNDLE_ACTIVE queryBundleStatsInfos promise failed. code is: ' + err.code + ',message is: ' + err.message);
      });
  } catch (error) {
      console.log('BUNDLE_ACTIVE queryBundleStatsInfos throw error, code is: ' + error.code + ',message is: ' + error.message);
  }

usageStatistics.queryBundleStatsInfoByInterval

queryBundleStatsInfoByInterval(byInterval: IntervalType, begin: number, end: number, callback: AsyncCallback<Array<BundleStatsInfo>>): void

通过指定时间段间隔（天、周、月、年）查询应用使用时长统计信息，使用Callback形式返回。

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

系统API：此接口为系统接口。

参数：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

示例：

  try{
      usageStatistics.queryBundleStatsInfoByInterval(0, 0, 20000000000000, (err, res) => {
          if (err) {
              console.log('BUNDLE_ACTIVE queryBundleStatsInfoByInterval callback failed. code is: ' + err.code + ',message is: ' + err.message);
          } else {
              console.log('BUNDLE_ACTIVE queryBundleStatsInfoByInterval callback success.');
              for (let i = 0; i < res.length; i++) {
                  console.log('BUNDLE_ACTIVE queryBundleStatsInfoByInterval callback number : ' + (i + 1));
                  console.log('BUNDLE_ACTIVE queryBundleStatsInfoByInterval callback result ' + JSON.stringify(res[i]));
              }
          }
      });
  } catch (error) {
      console.log('BUNDLE_ACTIVE queryBundleStatsInfoByInterval throw error, code is: ' + error.code + ',message is: ' + error.message);
  }

usageStatistics.queryBundleStatsInfoByInterval

queryBundleStatsInfoByInterval(byInterval: IntervalType, begin: number, end: number): Promise<Array<BundleStatsInfo>>

通过指定时间段间隔（天、周、月、年）查询应用使用时长统计信息，使用Promise形式返回。

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

系统API：此接口为系统接口。

参数：

返回值：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

示例：

  try{
      usageStatistics.queryBundleStatsInfoByInterval(0, 0, 20000000000000).then( res => {
          console.log('BUNDLE_ACTIVE queryBundleStatsInfoByInterval promise success.');
          for (let i = 0; i < res.length; i++) {
              console.log('BUNDLE_ACTIVE queryBundleStatsInfoByInterval promise number : ' + (i + 1));
              console.log('BUNDLE_ACTIVE queryBundleStatsInfoByInterval promise result ' + JSON.stringify(res[i]));
          }
      }).catch( err => {
          console.log('BUNDLE_ACTIVE queryBundleStatsInfoByInterval promise failed. code is: ' + err.code + ',message is: ' + err.message);
      });
  } catch (error) {
      console.log('BUNDLE_ACTIVE queryBundleStatsInfoByInterval throw error, code is: ' + error.code + ',message is: ' + error.message);
  }

usageStatistics.queryBundleEvents

queryBundleEvents(begin: number, end: number, callback: AsyncCallback<Array<BundleEvents>>): void

通过指定起始和结束时间查询所有应用的事件集合，使用Callback形式返回。

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

系统API：此接口为系统接口。

参数：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

示例：

  try{
      usageStatistics.queryBundleEvents(0, 20000000000000, (err, res) => {
          if (err) {
              console.log('BUNDLE_ACTIVE queryBundleEvents callback failed. code is: ' + err.code + ',message is: ' + err.message);
          } else {
              console.log('BUNDLE_ACTIVE queryBundleEvents callback success.');
              for (let i = 0; i < res.length; i++) {
                  console.log('BUNDLE_ACTIVE queryBundleEvents callback number : ' + (i + 1));
                  console.log('BUNDLE_ACTIVE queryBundleEvents callback result ' + JSON.stringify(res[i]));
              }
          }
      });
  } catch (error) {
      console.log('BUNDLE_ACTIVE queryBundleEvents throw error, code is: ' + error.code + ',message is: ' + error.message);
  }

usageStatistics.queryBundleEvents

queryBundleEvents(begin: number, end: number): Promise<Array<BundleEvents>>

通过指定起始和结束时间查询所有应用的事件集合，使用Promise形式返回。

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

系统API：此接口为系统接口。

参数：

返回值：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

示例：

  try{
      usageStatistics.queryBundleEvents(0, 20000000000000).then( res => {
          console.log('BUNDLE_ACTIVE queryBundleEvents promise success.');
          for (let i = 0; i < res.length; i++) {
              console.log('BUNDLE_ACTIVE queryBundleEvents promise number : ' + (i + 1));
              console.log('BUNDLE_ACTIVE queryBundleEvents promise result ' + JSON.stringify(res[i]));
          }
      }).catch( err => {
          console.log('BUNDLE_ACTIVE queryBundleEvents promise failed. code is: ' + err.code + ',message is: ' + err.message);
      });
  } catch (error) {
      console.log('BUNDLE_ACTIVE queryBundleEvents throw error, code is: ' + error.code + ',message is: ' + error.message);
  }

usageStatistics.queryCurrentBundleEvents

queryCurrentBundleEvents(begin: number, end: number, callback: AsyncCallback<Array<BundleEvents>>): void

通过指定起始和结束时间查询当前应用的事件集合，使用Callback形式返回。

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

系统API：此接口为系统接口。

参数：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

示例：

  try{
      usageStatistics.queryCurrentBundleEvents(0, 20000000000000, (err, res) => {
          if (err) {
              console.log('BUNDLE_ACTIVE queryCurrentBundleEvents callback failed. code is: ' + err.code + ',message is: ' + err.message);
          } else {
              console.log('BUNDLE_ACTIVE queryCurrentBundleEvents callback success.');
              for (let i = 0; i < res.length; i++) {
                  console.log('BUNDLE_ACTIVE queryCurrentBundleEvents callback number : ' + (i + 1));
                  console.log('BUNDLE_ACTIVE queryCurrentBundleEvents callback result ' + JSON.stringify(res[i]));
              }
          }
      });
  } catch (error) {
      console.log('BUNDLE_ACTIVE queryCurrentBundleEvents throw error, code is: ' + error.code + ',message is: ' + error.message);
  }

usageStatistics.queryCurrentBundleEvents

queryCurrentBundleEvents(begin: number, end: number): Promise<Array<BundleEvents>>

通过指定起始和结束时间查询当前应用的事件集合，使用Promise形式返回。

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

系统API：此接口为系统接口。

参数：

返回值：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

示例：

  try{
      usageStatistics.queryCurrentBundleEvents(0, 20000000000000).then( res => {
          console.log('BUNDLE_ACTIVE queryCurrentBundleEvents promise success.');
          for (let i = 0; i < res.length; i++) {
              console.log('BUNDLE_ACTIVE queryCurrentBundleEvents promise number : ' + (i + 1));
              console.log('BUNDLE_ACTIVE queryCurrentBundleEvents promise result ' + JSON.stringify(res[i]));
          }
      }).catch( err => {
          console.log('BUNDLE_ACTIVE queryCurrentBundleEvents promise failed. code is: ' + err.code + ',message is: ' + err.message);
      });
  } catch (error) {
      console.log('BUNDLE_ACTIVE queryCurrentBundleEvents throw error, code is: ' + error.code + ',message is: ' + error.message);
  }

usageStatistics.queryModuleUsageRecords

queryModuleUsageRecords(): Promise<Array<HapModuleInfo>>

使用Promise形式返回不超过1000条FA使用记录，FA使用记录由近及远排序。

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

系统API：此接口为系统接口。

返回值：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

示例：

  // 无maxNum参数调用方式
  try{
      usageStatistics.queryModuleUsageRecords().then( res => {
          console.log('BUNDLE_ACTIVE queryModuleUsageRecords promise succeeded');
          for (let i = 0; i < res.length; i++) {
              console.log('BUNDLE_ACTIVE queryModuleUsageRecords promise number : ' + (i + 1));
              console.log('BUNDLE_ACTIVE queryModuleUsageRecords promise result ' + JSON.stringify(res[i]));
          }
      }).catch( err=> {
          console.log('BUNDLE_ACTIVE queryModuleUsageRecords promise failed. code is: ' + err.code + ',message is: ' + err.message);
      });
  } catch (error) {
      console.log('BUNDLE_ACTIVE queryModuleUsageRecords throw error, code is: ' + error.code + ',message is: ' + error.message);
  }

usageStatistics.queryModuleUsageRecords

queryModuleUsageRecords(callback: AsyncCallback<Array<HapModuleInfo>>): void

查询FA使用记录。使用CallBack形式返回数量不超过1000条FA使用记录（FA记录按时间由近及远排序）。

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

系统API：此接口为系统接口。

参数：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

示例：

  try{
      usageStatistics.queryModuleUsageRecords((err, res) => {
      if(err) {
          console.log('BUNDLE_ACTIVE queryModuleUsageRecords callback failed. code is: ' + err.code + ',message is: ' + err.message);
      } else {
          console.log('BUNDLE_ACTIVE queryModuleUsageRecords callback succeeded.');
          for (let i = 0; i < res.length; i++) {
          console.log('BUNDLE_ACTIVE queryModuleUsageRecords callback number : ' + (i + 1));
          console.log('BUNDLE_ACTIVE queryModuleUsageRecords callback result ' + JSON.stringify(res[i]));
          }
      }
      });
  } catch (error) {
      console.log('BUNDLE_ACTIVE queryModuleUsageRecords throw error, code is: ' + error.code + ',message is: ' + error.message);
  }

usageStatistics.queryModuleUsageRecords

queryModuleUsageRecords(maxNum: number): Promise<Array<HapModuleInfo>>

据maxNum，查询FA使用记录，使用Promise形式返回不超过maxNum条FA使用记录，FA使用记录由近及远排序，maxNum最大为1000。

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

系统API：此接口为系统接口。

参数：

返回值：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

示例：

  try{
      usageStatistics.queryModuleUsageRecords(1000).then( res => {
          console.log('BUNDLE_ACTIVE queryModuleUsageRecords promise succeeded');
          for (let i = 0; i < res.length; i++) {
              console.log('BUNDLE_ACTIVE queryModuleUsageRecords promise number : ' + (i + 1));
              console.log('BUNDLE_ACTIVE queryModuleUsageRecords promise result ' + JSON.stringify(res[i]));
          }
      }).catch( err=> {
          console.log('BUNDLE_ACTIVE queryModuleUsageRecords promise failed. code is: ' + err.code + ',message is: ' + err.message);
      });
  } catch (error) {
      console.log('BUNDLE_ACTIVE queryModuleUsageRecords throw error, code is: ' + error.code + ',message is: ' + error.message);
  }

usageStatistics.queryModuleUsageRecords

queryModuleUsageRecords(maxNum: number, callback: AsyncCallback<Array<HapModuleInfo>>): void

查询FA使用记录。使用CallBack形式返回数量最大不超过maxNum设置的值，FA使用记录由近及远排序，maxNum最大为1000。

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

系统API：此接口为系统接口。

参数：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

示例：

  try{
      usageStatistics.queryModuleUsageRecords(1000, (err, res) => {
          if(err) {
              console.log('BUNDLE_ACTIVE queryModuleUsageRecords callback failed. code is: ' + err.code + ',message is: ' + err.message);
          } else {
              console.log('BUNDLE_ACTIVE queryModuleUsageRecords callback succeeded.');
              for (let i = 0; i < res.length; i++) {
                  console.log('BUNDLE_ACTIVE queryModuleUsageRecords callback number : ' + (i + 1));
                  console.log('BUNDLE_ACTIVE queryModuleUsageRecords callback result ' + JSON.stringify(res[i]));
              }
          }
      });
  } catch (error) {
      console.log('BUNDLE_ACTIVE queryModuleUsageRecords throw error, code is: ' + error.code + ',message is: ' + error.message);
  }

usageStatistics.queryAppGroup

queryAppGroup(bundleName : string): Promise<number>

查询指定bundleName的应用的优先级分组。使用Promise形式返回其应用分组结果。

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

系统API：此接口为系统接口。

参数：

返回值：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

示例：

//有bundleName的promise
    let bundleName = "com.ohos.camera";
    try{
        usageStatistics.queryAppGroup(bundleName).then( res => {
            console.log('BUNDLE_ACTIVE queryAppGroup promise succeeded. result: ' + JSON.stringify(res));
        }).catch( err => {
            console.log('BUNDLE_ACTIVE queryAppGroup promise failed. code is: ' + err.code + ',message is: ' + err.message);
        });
    } catch (error) {
        console.log('BUNDLE_ACTIVE queryAppGroup throw error, code is: ' + error.code + ',message is: ' + error.message);
    }

usageStatistics.queryAppGroup

queryAppGroup(bundleName : string, callback: AsyncCallback<number>): void

查询指定bundleName对应应用的分组。使用callback形式返回其应用分组。

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

系统API：此接口为系统接口。

参数：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

示例：

    let bundleName = "com.ohos.camera";
    try{
        usageStatistics.queryAppGroup(bundleName, (err, res) => {
            if(err) {
                console.log('BUNDLE_ACTIVE queryAppGroup callback failed. code is: ' + err.code + ',message is: ' + err.message);
            } else {
                console.log('BUNDLE_ACTIVE queryAppGroup callback succeeded. result: ' + JSON.stringify(res));
            }
        });
    } catch (error) {
        console.log('BUNDLE_ACTIVE queryAppGroup throw error, code is: ' + error.code + ',message is: ' + error.message);
    }

usageStatistics.setAppGroup

setAppGroup(bundleName: string, newGroup: GroupType): Promise<void>

将指定bundleName的应用的分组设置为newGroup，使用Promise形式返回设置是否成功。

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

系统API：此接口为系统接口。

参数：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

返回值：

示例：

    let bundleName = "com.example.deviceUsageStatistics";
    let newGroup = usageStatistics.GroupType.DAILY_GROUP;

    try{
        usageStatistics.setAppGroup(bundleName, newGroup).then( () => {
            console.log('BUNDLE_ACTIVE setAppGroup promise succeeded.');
        }).catch( err => {
            console.log('BUNDLE_ACTIVE setAppGroup promise failed. code is: ' + err.code + ',message is: ' + err.message);
        });
    } catch (error) {
        console.log('BUNDLE_ACTIVE setAppGroup throw error, code is: ' + error.code + ',message is: ' + error.message);
    }

usageStatistics.setAppGroup

setAppGroup(bundleName: string, newGroup: GroupType, callback: AsyncCallback<void>): void

将指定bundleName的应用的分组设置为newGroup，使用CallBack形式返回设置是否成功。

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

系统API：此接口为系统接口。

参数：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

示例：

    let bundleName = "com.example.deviceUsageStatistics";
    let newGroup = usageStatistics.GroupType.DAILY_GROUP;

    try{
        usageStatistics.setAppGroup(bundleName, newGroup, (err) => {
            if(err) {
                console.log('BUNDLE_ACTIVE setAppGroup callback failed. code is: ' + err.code + ',message is: ' + err.message);
            } else {
                console.log('BUNDLE_ACTIVE setAppGroup callback succeeded.');
            }
        });
    } catch (error) {
        console.log('BUNDLE_ACTIVE setAppGroup throw error, code is: ' + error.code + ',message is: ' + error.message);
    }

usageStatistics.registerAppGroupCallBack

registerAppGroupCallBack(groupCallback: Callback<AppGroupCallbackInfo>): Promise<void>

应用注册分组变化监听，待用户名下的某个应用分组发生变化时，通过callback形式向所有已注册分组变化监听的应用返回AppGroupCallbackInfo信息。使用Promise形式返回注册是否成功。

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

系统API：此接口为系统接口。

参数：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

返回值：

示例：

    let onBundleGroupChanged = (res) =>{
        console.log('BUNDLE_ACTIVE registerAppGroupCallBack RegisterGroupCallBack callback success.');
        console.log('BUNDLE_ACTIVE registerAppGroupCallBack result appOldGroup is : ' + res.appOldGroup);
        console.log('BUNDLE_ACTIVE registerAppGroupCallBack result appNewGroup is : ' + res.appNewGroup);
        console.log('BUNDLE_ACTIVE registerAppGroupCallBack result changeReason is : ' + res.changeReason);
        console.log('BUNDLE_ACTIVE registerAppGroupCallBack result userId is : ' + res.userId);
        console.log('BUNDLE_ACTIVE registerAppGroupCallBack result bundleName is : ' + res.bundleName);
    };
    try{
        usageStatistics.registerAppGroupCallBack(onBundleGroupChanged).then( () => {
            console.log('BUNDLE_ACTIVE registerAppGroupCallBack promise succeeded.');
        }).catch( err => {
            console.log('BUNDLE_ACTIVE registerAppGroupCallBack promise failed. code is: ' + err.code + ',message is: ' + err.message);
        });
    } catch (error) {
        console.log('BUNDLE_ACTIVE registerAppGroupCallBack throw error, code is: ' + error.code + ',message is: ' + error.message);
    }

usageStatistics.registerAppGroupCallBack

registerAppGroupCallBack(groupCallback: Callback<AppGroupCallbackInfo>, callback: AsyncCallback<void>): void

应用注册分组变化监听，待用户名下的某个应用分组发生变化时，通过callback形式向所有已注册分组变化监听的应用返回AppGroupCallbackInfo信息。使用异步callback形式返回注册监听是否成功。

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

系统API：此接口为系统接口。

参数：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

示例：

    // @ts-nocheck
    let onBundleGroupChanged = (err, res) =>{
        console.log('BUNDLE_ACTIVE onBundleGroupChanged RegisterGroupCallBack callback success.');
        console.log('BUNDLE_ACTIVE registerAppGroupCallBack result appOldGroup is : ' + res.appOldGroup);
        console.log('BUNDLE_ACTIVE registerAppGroupCallBack result appNewGroup is : ' + res.appNewGroup);
        console.log('BUNDLE_ACTIVE registerAppGroupCallBack result changeReason is : ' + res.changeReason);
        console.log('BUNDLE_ACTIVE registerAppGroupCallBack result userId is : ' + res.userId);
        console.log('BUNDLE_ACTIVE registerAppGroupCallBack result bundleName is : ' + res.bundleName);
    };
    try{
        usageStatistics.registerAppGroupCallBack(onBundleGroupChanged, err => {
            if(err) {
                console.log('BUNDLE_ACTIVE registerAppGroupCallBack callback failed. code is: ' + err.code + ',message is: ' + err.message);
            } else {
                console.log('BUNDLE_ACTIVE registerAppGroupCallBack callback success.');
            }
        });
    } catch (error) {
        console.log('BUNDLE_ACTIVE registerAppGroupCallBack throw error, code is: ' + error.code + ',message is: ' + error.message);
    }

usageStatistics.unregisterAppGroupCallBack

unregisterAppGroupCallBack(): Promise<void>

应用解除分组变化监听，解除通过调用注册接口生成的监听。使用Promise形式返回解除监听是否成功。

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

系统API：此接口为系统接口。

返回值：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

示例：

    try{
        usageStatistics.unregisterAppGroupCallBack().then( () => {
            console.log('BUNDLE_ACTIVE unregisterAppGroupCallBack promise succeeded.');
        }).catch( err => {
            console.log('BUNDLE_ACTIVE unregisterAppGroupCallBack promise failed. code is: ' + err.code + ',message is: ' + err.message);
        });
    } catch (error) {
        console.log('BUNDLE_ACTIVE unregisterAppGroupCallBack throw error, code is: ' + error.code + ',message is: ' + error.message);
    }

usageStatistics.unregisterAppGroupCallBack

unregisterAppGroupCallBack(callback: AsyncCallback<void>): void;

应用解除分组变化监听，解除通过调用注册接口生成的监听。使用异步callback形式返回解除监听是否成功。

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

系统API：此接口为系统接口。

参数：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

示例：

    try{
        usageStatistics.unregisterAppGroupCallBack(err => {
            if(err) {
                console.log('BUNDLE_ACTIVE unregisterAppGroupCallBack callback failed. code is: ' + err.code + ',message is: ' + err.message);
            } else {
                console.log('BUNDLE_ACTIVE unregisterAppGroupCallBack callback success.');
            }
        });
    } catch (error) {
        console.log('BUNDLE_ACTIVE unregisterAppGroupCallBack throw error, code is: ' + error.code + ',message is: ' + error.message);
    }

usageStatistics.queryDeviceEventStats

queryDeviceEventStats(begin: number, end: number): Promise<Array<DeviceEventStats>>

通过指定起始和结束时间查询系统事件（休眠、唤醒、解锁、锁屏）统计信息，使用Promise形式返回。

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

系统API：此接口为系统接口。

参数：

返回值：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

示例：

  try{
      usageStatistics.queryDeviceEventStats(0, 20000000000000).then( res => {
          console.log('BUNDLE_ACTIVE queryDeviceEventStates promise success.');
          console.log('BUNDLE_ACTIVE queryDeviceEventStates promise result ' + JSON.stringify(res));
      }).catch( err=> {
          console.log('BUNDLE_ACTIVE queryDeviceEventStats promise failed. code is: ' + err.code + ',message is: ' + err.message);
      });
  } catch (error) {
      console.log('BUNDLE_ACTIVE queryDeviceEventStats throw error, code is: ' + error.code + ',message is: ' + error.message);
  }

usageStatistics.queryDeviceEventStats

queryDeviceEventStats(begin: number, end: number, callback: AsyncCallback<Array<DeviceEventStats>>): void

通过指定起始和结束时间查询系统事件（休眠、唤醒、解锁、锁屏）统计信息，使用Callback形式返回。

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

系统API：此接口为系统接口。

参数：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

示例：

  try{
      usageStatistics.queryDeviceEventStats(0, 20000000000000, (err, res) => {
          if(err) {
              console.log('BUNDLE_ACTIVE queryDeviceEventStats callback failed. code is: ' + err.code + ',message is: ' + err.message);
          } else {
              console.log('BUNDLE_ACTIVE queryDeviceEventStats callback success.');
              console.log('BUNDLE_ACTIVE queryDeviceEventStats callback result ' + JSON.stringify(res));
          }
      });
  } catch (error) {
      console.log('BUNDLE_ACTIVE queryDeviceEventStats throw error, code is: ' + error.code + ',message is: ' + error.message);
  }

usageStatistics.queryNotificationEventStats

queryNotificationEventStats(begin: number, end: number): Promise<Array<DeviceEventStats>>

通过指定起始和结束时间查询所有应用的通知次数信息，使用Promise形式返回。

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

系统API：此接口为系统接口。

参数：

返回值：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

示例：

  try{
      usageStatistics.queryNotificationEventStats(0, 20000000000000).then( res => {
          console.log('BUNDLE_ACTIVE queryNotificationEventStats promise success.');
          console.log('BUNDLE_ACTIVE queryNotificationEventStats promise result ' + JSON.stringify(res));
      }).catch( err=> {
          console.log('BUNDLE_ACTIVE queryNotificationEventStats promise failed. code is: ' + err.code + ',message is: ' + err.message);
      });
  } catch (error) {
      console.log('BUNDLE_ACTIVE queryNotificationEventStats throw error, code is: ' + error.code + ',message is: ' + error.message);
  }

usageStatistics.queryNotificationEventStats

queryNotificationEventStats(begin: number, end: number, callback: AsyncCallback<Array<DeviceEventStats>>): void

通过指定起始和结束时间查询所有应用的通知次数信息，使用Callback形式返回。

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

系统API：此接口为系统接口。

参数：

错误码：

以下错误码的详细介绍请参见设备信息使用统计错误码。

示例：

  try{
      usageStatistics.queryNotificationEventStats(0, 20000000000000, (err, res) => {
          if(err) {
              console.log('BUNDLE_ACTIVE queryNotificationEventStats callback failed. code is: ' + err.code + ',message is: ' + err.message);
          } else {
              console.log('BUNDLE_ACTIVE queryNotificationEventStats callback success.');
              console.log('BUNDLE_ACTIVE queryNotificationEventStats callback result ' + JSON.stringify(res));
          }
      });
  } catch (error) {
      console.log('BUNDLE_ACTIVE queryNotificationEventStats throw error, code is: ' + error.code + ',message is: ' + error.message);
  }

HapModuleInfo

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

系统能力：以下各项对应的系统能力均为SystemCapability.ResourceSchedule.UsageStatistics.App

系统API：此接口为系统接口。

HapFormInfo

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

系统能力：以下各项对应的系统能力均为SystemCapability.ResourceSchedule.UsageStatistics.App

系统API：此接口为系统接口。

AppGroupCallbackInfo

应用分组变化回调返回的属性集合

系统能力：以下各项对应的系统能力均为SystemCapability.ResourceSchedule.UsageStatistics.AppGroup

系统API：此接口为系统接口。

BundleStatsInfo

提供应用使用时长的具体信息。

属性

系统能力：以下各项对应的系统能力均为SystemCapability.ResourceSchedule.UsageStatistics.App

系统API：此接口为系统接口。

BundleEvents

提供应用事件的具体信息。

系统能力：以下各项对应的系统能力均为SystemCapability.ResourceSchedule.UsageStatistics.App

系统API：此接口为系统接口。

BundleStatsMap

提供应用使用时长的具体信息。

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

系统API：此接口为系统接口。

DeviceEventStats

提供通知、系统事件的统计信息。

系统能力：以下各项对应的系统能力均为SystemCapability.ResourceSchedule.UsageStatistics.App

系统API：此接口为系统接口。

IntervalType

提供应用使用时长的查询类型。

系统能力：以下各项对应的系统能力均为SystemCapability.ResourceSchedule.UsageStatistics.App

系统API：此接口为系统接口。

GroupType

提供应用分组的设置类型。

系统能力：以下各项对应的系统能力均为SystemCapability.ResourceSchedule.UsageStatistics.AppGroup

系统API：此接口为系统接口。