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

2022-10-28
浏览 (711)

@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：此接口为系统接口。

参数：

参数名	类型	必填	说明
bundleName	string	是	应用的bundleName。
callback	AsyncCallback<boolean>	是	指定的callback回调方法。如果指定的bundleName有效，则返回指定bundleName的应用当前是否是空闲状态；否则返回null。

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000006	Failed to get the application information.

示例：

import { BusinessError } from '@ohos.base';

usageStatistics.isIdleState("com.ohos.camera", (err: BusinessError, res: boolean) => {
  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));
  }
});

usageStatistics.isIdleState

isIdleState(bundleName: string): Promise<boolean>

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

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

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

参数：

参数名	类型	必填	说明
bundleName	string	是	应用的bundleName。

返回值：

类型	说明
Promise<boolean>	指定的Promise回调方法。如果指定的bundleName有效，则返回指定bundleName的应用当前是否是空闲状态；否则返回null。

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000006	Failed to get the application information.

示例：

import { BusinessError } from '@ohos.base';

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

usageStatistics.isIdleStateSync¹⁰⁺

isIdleStateSync(bundleName: string): boolean

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

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

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

参数：

参数名	类型	必填	说明
bundleName	string	是	应用的bundleName。

返回值：

类型	说明
boolean	如果指定的bundleName有效，返回true则表示空闲状态，false则非空闲。

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000006	Failed to get the application information.

示例：

let isIdleState: boolean = usageStatistics.isIdleStateSync("com.ohos.camera");

usageStatistics.queryAppGroup

queryAppGroup(): Promise<number>

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

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

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

返回值：

类型	说明
Promise<number>	指定的Promise回调方法。返回查询的应用分组结果。

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000005	Application is not installed.
10000006	Failed to get the application information.
10100002	Failed to get the application group information.

示例：

import { BusinessError } from '@ohos.base';

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

usageStatistics.queryAppGroup

queryAppGroup(callback: AsyncCallback<number>): void

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

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

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

参数：

参数名	类型	必填	说明
callback	AsyncCallback<number>	是	指定的CallBack回调方法。返回查询的应用分组。

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000005	Application is not installed.
10000006	Failed to get the application information.
10100002	Failed to get the application group information.

示例：

import { BusinessError } from '@ohos.base';

usageStatistics.queryAppGroup((err: BusinessError, res: number) => {
  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));
  }
});

usageStatistics.queryAppGroupSync¹⁰⁺

queryAppGroupSync(): number;

查询当前应用的优先级分组。

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

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

返回值：

类型	说明
number	返回当前应用优先级分组结果。

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000005	Application is not installed.
10000006	Failed to get the application information.
10100002	Failed to get the application group information.

示例：

let priorityGroup: number = usageStatistics.queryAppGroupSync();

usageStatistics.queryAppGroupSync¹⁰⁺

queryAppGroupSync(bundleName: string): number

查询指定bundleName应用的优先级分组。

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

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

参数：

参数名	类型	必填	说明
bundleName	string	是	应用的bundleName。

返回值：

类型	说明
number	返回指定bundleName应用优先级分组结果。

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000005	Application is not installed.
10000006	Failed to get the application information.
10100002	Failed to get the application group information.

示例：

let priorityGroup: number = usageStatistics.queryAppGroupSync("com.ohos.camera");

usageStatistics.queryBundleStatsInfos

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

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

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

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

参数：

参数名	类型	必填	说明
begin	number	是	起始时间，以毫秒为单位。
end	number	是	结束时间，以毫秒为单位。
callback	AsyncCallback<BundleStatsMap>	是	指定的callback回调方法。返回指定起始和结束时间内应用使用时长统计信息。

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000006	Failed to get the application information.
10000007	Failed to get the system time.

示例：

import { BusinessError } from '@ohos.base';

usageStatistics.queryBundleStatsInfos(0, 20000000000000, (err: BusinessError, res:usageStatistics.BundleStatsMap) => {
  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.');
    console.log('BUNDLE_ACTIVE queryBundleStatsInfos callback result ' + JSON.stringify(res));
  }
});

usageStatistics.queryBundleStatsInfos

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

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

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

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

参数：

参数名	类型	必填	说明
begin	number	是	起始时间，以毫秒为单位。
end	number	是	结束时间，以毫秒为单位。

返回值：

类型	说明
Promise<BundleStatsMap>	指定的Promise回调方法。返回指定起始和结束时间内应用使用时长统计信息。

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000006	Failed to get the application information.
10000007	Failed to get the system time.

示例：

import { BusinessError } from '@ohos.base';

usageStatistics.queryBundleStatsInfos(0, 20000000000000).then((res:usageStatistics.BundleStatsMap) => {
  console.log('BUNDLE_ACTIVE queryBundleStatsInfos promise success.');
  console.log('BUNDLE_ACTIVE queryBundleStatsInfos promise result ' + JSON.stringify(res));
}).catch((err: BusinessError) => {
  console.log('BUNDLE_ACTIVE queryBundleStatsInfos promise failed. code is: ' + err.code + ',message is: ' + err.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：此接口为系统接口。

参数：

参数名	类型	必填	说明
byInterval	IntervalType	是	查询类型。
begin	number	是	起始时间，以毫秒为单位。
end	number	是	结束时间，以毫秒为单位。
callback	AsyncCallback<Array<BundleStatsInfo>>	是	指定的callback回调方法。返回指定时间段间隔（天、周、月、年）查询应用使用时长统计信息。

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000006	Failed to get the application information.
10000007	Failed to get the system time.

示例：

import { BusinessError } from '@ohos.base';

usageStatistics.queryBundleStatsInfoByInterval(0, 0, 20000000000000, (err: BusinessError, res: Array<usageStatistics.BundleStatsInfo>) => {
  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]));
    }
  }
});

usageStatistics.queryBundleStatsInfoByInterval

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

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

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

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

参数：

参数名	类型	必填	说明
byInterval	IntervalType	是	查询类型。
begin	number	是	起始时间，以毫秒为单位。
end	number	是	结束时间，以毫秒为单位。

返回值：

类型	说明
Promise<Array<BundleStatsInfo>>	指定的Promise回调方法。返回指定时间段间隔（天、周、月、年）查询应用使用时长统计信息。

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000006	Failed to get the application information.
10000007	Failed to get the system time.

示例：

import { BusinessError } from '@ohos.base';

usageStatistics.queryBundleStatsInfoByInterval(0, 0, 20000000000000).then((res: Array<usageStatistics.BundleStatsInfo>) => {
  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: BusinessError) => {
  console.log('BUNDLE_ACTIVE queryBundleStatsInfoByInterval promise failed. code is: ' + err.code + ',message is: ' + err.message);
});

usageStatistics.queryBundleEvents

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

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

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

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

参数：

参数名	类型	必填	说明
begin	number	是	起始时间，以毫秒为单位。
end	number	是	结束时间，以毫秒为单位。
callback	AsyncCallback<Array<BundleEvents>>	是	指定的callback回调方法。返回指定起始和结束时间查询所有应用的事件集合。

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000006	Failed to get the application information.
10000007	Failed to get the system time.

示例：

import { BusinessError } from '@ohos.base';

usageStatistics.queryBundleEvents(0, 20000000000000, (err: BusinessError, res: Array<usageStatistics.BundleEvents>) => {
  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]));
    }
  }
});

usageStatistics.queryBundleEvents

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

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

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

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

参数：

参数名	类型	必填	说明
begin	number	是	起始时间，以毫秒为单位。
end	number	是	结束时间，以毫秒为单位。

返回值：

类型	说明
Promise<Array<BundleEvents>>	指定的Promise回调方法。返回指定起始和结束时间查询所有应用的事件集合。

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000006	Failed to get the application information.
10000007	Failed to get the system time.

示例：

import { BusinessError } from '@ohos.base';

usageStatistics.queryBundleEvents(0, 20000000000000).then((res: Array<usageStatistics.BundleEvents>) => {
  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: BusinessError) => {
  console.log('BUNDLE_ACTIVE queryBundleEvents promise failed. code is: ' + err.code + ',message is: ' + err.message);
});

usageStatistics.queryCurrentBundleEvents

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

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

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

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

参数：

参数名	类型	必填	说明
begin	number	是	起始时间，以毫秒为单位。
end	number	是	结束时间，以毫秒为单位。
callback	AsyncCallback<Array<BundleEvents>>	是	指定的callback回调方法。返回指定起始和结束时间查询当前应用的事件集合。

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000006	Failed to get the application information.
10000007	Failed to get the system time.

示例：

import { BusinessError } from '@ohos.base';

usageStatistics.queryCurrentBundleEvents(0, 20000000000000, (err: BusinessError, res: Array<usageStatistics.BundleEvents>) => {
  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]));
    }
  }
});

usageStatistics.queryCurrentBundleEvents

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

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

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

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

参数：

参数名	类型	必填	说明
begin	number	是	起始时间，以毫秒为单位。
end	number	是	结束时间，以毫秒为单位。

返回值：

类型	说明
Promise<Array<BundleEvents>>	指定的Promise回调方法。返回指定起始和结束时间查询当前应用的事件集合。

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000006	Failed to get the application information.
10000007	Failed to get the system time.

示例：

import { BusinessError } from '@ohos.base';

usageStatistics.queryCurrentBundleEvents(0, 20000000000000).then((res: Array<usageStatistics.BundleEvents>) => {
  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: BusinessError) => {
  console.log('BUNDLE_ACTIVE queryCurrentBundleEvents promise failed. code is: ' + err.code + ',message is: ' + err.message);
});

usageStatistics.queryModuleUsageRecords

queryModuleUsageRecords(): Promise<Array<HapModuleInfo>>

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

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

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

返回值：

类型	说明
Promise<Array<HapModuleInfo>>	指定的Promise回调方法。返回不超过1000条FA使用记录。

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000006	Failed to get the application information.
10000007	Failed to get the system time.

示例：

// 无maxNum参数调用方式
import { BusinessError } from '@ohos.base';

usageStatistics.queryModuleUsageRecords().then((res: Array<usageStatistics.HapModuleInfo>) => {
  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: BusinessError) => {
  console.log('BUNDLE_ACTIVE queryModuleUsageRecords promise failed. code is: ' + err.code + ',message is: ' + err.message);
});

usageStatistics.queryModuleUsageRecords

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

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

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

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

参数：

参数名	类型	必填	说明
callback	AsyncCallback<Array<HapModuleInfo>>	是	指定的CallBack回调方法。返回不超过maxNum条FA使用记录。

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000006	Failed to get the application information.
10000007	Failed to get the system time.

示例：

import { BusinessError } from '@ohos.base';

usageStatistics.queryModuleUsageRecords((err: BusinessError, res: Array<usageStatistics.HapModuleInfo>) => {
  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]));
    }
  }
});

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：此接口为系统接口。

参数：

参数名	类型	必填	说明
maxNum	number	是	返回条目的最大数量，最多支持1000条。

返回值：

类型	说明
Promise<Array<HapModuleInfo>>	指定的Promise回调方法。返回不超过maxNum条FA使用记录。

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000006	Failed to get the application information.
10000007	Failed to get the system time.

示例：

import { BusinessError } from '@ohos.base';

usageStatistics.queryModuleUsageRecords(1000).then((res: Array<usageStatistics.HapModuleInfo>) => {
  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: BusinessError) => {
  console.log('BUNDLE_ACTIVE queryModuleUsageRecords promise failed. code is: ' + err.code + ',message is: ' + err.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：此接口为系统接口。

参数：

参数名	类型	必填	说明
maxNum	number	是	返回FA记录的最大数量，maxNum最大为1000。
callback	AsyncCallback<Array<HapModuleInfo>>	是	指定的CallBack回调方法。返回不超过maxNum条FA使用记录。

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000006	Failed to get the application information.
10000007	Failed to get the system time.

示例：

import { BusinessError } from '@ohos.base';

usageStatistics.queryModuleUsageRecords(1000, (err: BusinessError, res: Array<usageStatistics.HapModuleInfo>) => {
  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]));
    }
  }
});

usageStatistics.queryAppGroup

queryAppGroup(bundleName : string): Promise<number>

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

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

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

参数：

参数名	类型	必填	说明
bundleName	string	是	查询指定bundleName的应用的优先级分组。

返回值：

类型	说明
Promise<number>	指定的Promise回调方法。返回查询的应用分组结果。

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000005	Application is not installed.
10000006	Failed to get the application information.
10100002	Failed to get the application group information.

示例：

//有bundleName的promise
import { BusinessError } from '@ohos.base';

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

usageStatistics.queryAppGroup

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

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

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

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

参数：

参数名	类型	必填	说明
bundleName	string	是	查询指定bundleName对应应用的分组。
callback	AsyncCallback<number>	是	指定的CallBack回调方法。返回指定bundleName的应用分组。

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000005	Application is not installed.
10000006	Failed to get the application information.
10100002	Failed to get the application group information.

示例：

import { BusinessError } from '@ohos.base';

let bundleName: string = "com.ohos.camera";
usageStatistics.queryAppGroup(bundleName, (err: BusinessError, res: number) => {
  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));
  }
});

usageStatistics.setAppGroup

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

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

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

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

参数：

参数名	类型	必填	说明
bundleName	string	是	应用名称
newGroup	GroupType	是	应用分组

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000006	Failed to get the application information.
10100001	Repeated operation on the application group.

返回值：

类型	说明
Promise<void>	指定的Promise回调方法。返回本次设置是否成功

示例：

import { BusinessError } from '@ohos.base';

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

usageStatistics.setAppGroup(bundleName, newGroup).then( () => {
  console.log('BUNDLE_ACTIVE setAppGroup promise succeeded.');
}).catch((err: BusinessError) => {
  console.log('BUNDLE_ACTIVE setAppGroup promise failed. code is: ' + err.code + ',message is: ' + err.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：此接口为系统接口。

参数：

参数名	类型	必填	说明
bundleName	string	是	应用名称
newGroup	GroupType	是	应用分组
callback	AsyncCallback<void>	是	指定的CallBack回调方法。返回设置是否成功。

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000006	Failed to get the application information.
10100001	Repeated operation on the application group.

示例：

import { BusinessError } from '@ohos.base';

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

usageStatistics.setAppGroup(bundleName, newGroup, (err: BusinessError) => {
  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.');
  }
});

usageStatistics.registerAppGroupCallBack

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

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

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

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

参数：

参数名	类型	必填	说明
callback	Callback<AppGroupCallbackInfo>	是	指定的callback函数，返回应用分组变化的信息

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10100001	Repeated operation on the application group.

返回值：

类型	说明
Promise<void>	指定的Promise回调方法。返回注册监听是否成功

示例：

import { BusinessError } from '@ohos.base';

function onBundleGroupChanged(res: usageStatistics.AppGroupCallbackInfo) {
  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);
};
usageStatistics.registerAppGroupCallBack(onBundleGroupChanged).then( () => {
  console.log('BUNDLE_ACTIVE registerAppGroupCallBack promise succeeded.');
}).catch((err: BusinessError) => {
  console.log('BUNDLE_ACTIVE registerAppGroupCallBack promise failed. code is: ' + err.code + ',message is: ' + err.message);
});

usageStatistics.registerAppGroupCallBack

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

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

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

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

参数：

参数名	类型	必填	说明
groupCallback	Callback<AppGroupCallbackInfo>	是	指定的callback函数，返回应用分组变化的信息
callback	AsyncCallback<void>	是	指定的异步callback函数，返回注册监听是否成功

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10100001	Repeated operation on the application group.

示例：

import { BusinessError } from '@ohos.base';

function onBundleGroupChanged(res: usageStatistics.AppGroupCallbackInfo) {
  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);
};
usageStatistics.registerAppGroupCallBack(onBundleGroupChanged, (err: BusinessError) => {
  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.');
  }
});

usageStatistics.unregisterAppGroupCallBack

unregisterAppGroupCallBack(): Promise<void>

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

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

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

返回值：

类型	说明
Promise<void>	指定的Promise回调方法。返回解除监听是否成功

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10100001	Repeated operation on the application group.

示例：

import { BusinessError } from '@ohos.base';

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

usageStatistics.unregisterAppGroupCallBack

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

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

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

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

参数：

参数名	类型	必填	说明
callback	AsyncCallback<void>	是	解除监听是否成功的异步回调函数

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10100001	Repeated operation on the application group.

示例：

import { BusinessError } from '@ohos.base';

usageStatistics.unregisterAppGroupCallBack((err: BusinessError) => {
  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.');
  }
});

usageStatistics.queryDeviceEventStats

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

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

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

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

参数：

参数名	类型	必填	说明
begin	number	是	起始时间，以毫秒为单位。
end	number	是	结束时间，以毫秒为单位。

返回值：

类型	说明
Promise<Array<DeviceEventStats>>	指定的Promise回调方法。返回指定起始和结束时间查询系统事件（休眠、唤醒、解锁、锁屏）统计信息。

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000006	Failed to get the application information.
10000007	Failed to get the system time.

示例：

import { BusinessError } from '@ohos.base';

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

usageStatistics.queryDeviceEventStats

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

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

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

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

参数：

参数名	类型	必填	说明
begin	number	是	起始时间，以毫秒为单位。
end	number	是	结束时间，以毫秒为单位。
callback	AsyncCallback<Array<DeviceEventStats>>	是	指定的callback回调方法。返回指定起始和结束时间查询系统事件（休眠、唤醒、解锁、锁屏）统计信息。

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000006	Failed to get the application information.
10000007	Failed to get the system time.

示例：

import { BusinessError } from '@ohos.base';

usageStatistics.queryDeviceEventStats(0, 20000000000000, (err: BusinessError, res: Array<usageStatistics.DeviceEventStats>) => {
  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));
  }
});

usageStatistics.queryNotificationEventStats

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

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

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

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

参数：

参数名	类型	必填	说明
begin	number	是	起始时间，以毫秒为单位。
end	number	是	结束时间，以毫秒为单位。

返回值：

类型	说明
Promise<Array<DeviceEventStats>>	指定的Promise回调方法。返回指定起始和结束时间查询所有应用的通知次数信息。

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000006	Failed to get the application information.
10000007	Failed to get the system time.

示例：

import { BusinessError } from '@ohos.base';

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

usageStatistics.queryNotificationEventStats

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

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

需要权限：ohos.permission.BUNDLE_ACTIVE_INFO

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

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

参数：

参数名	类型	必填	说明
begin	number	是	起始时间，以毫秒为单位。
end	number	是	结束时间，以毫秒为单位。
callback	AsyncCallback<Array<DeviceEventStats>>	是	指定的callback回调方法。返回通过指定起始和结束时间查询所有应用的通知次数信息。

错误码：

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

错误码ID	错误信息
10000001	Memory operation failed.
10000002	Parcel operation failed.
10000003	System service operation failed.
10000004	IPC failed.
10000006	Failed to get the application information.
10000007	Failed to get the system time.

示例：

import { BusinessError } from '@ohos.base';

usageStatistics.queryNotificationEventStats(0, 20000000000000, (err: BusinessError, res: Array<usageStatistics.DeviceEventStats>) => {
  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));
  }
});

HapModuleInfo

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

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

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

名称	类型	必填	说明
deviceId	string	否	FA所属deviceId。
bundleName	string	是	FA所属应用Bundle名称。
moduleName	string	是	FA所属module名。
abilityName	string	否	FA的MainAbility名。
appLabelId	number	否	FA的应用labelId。
labelId	number	否	FA所属module的labelId。
descriptionId	number	否	FA所属的应用descriptionId。
abilityLableId	number	否	FA的MainAbility labelId。
abilityDescriptionId	number	否	FA的MainAbility descriptionId。
abilityIconId	number	否	FA的MainAbility iconId。
launchedCount	number	是	FA的启动次数。
lastModuleUsedTime	number	是	FA的上一次使用时间。
formRecords	Array<HapFormInfo>	是	FA中卡片的使用记录。

HapFormInfo

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

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

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

名称	类型	必填	说明
formName	string	是	卡片名称。
formDimension	number	是	卡片尺寸。
formId	number	是	卡片Id。
formLastUsedTime	number	是	卡片的上一次点击时间。
count	number	是	卡片的点击次数。

AppGroupCallbackInfo

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

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

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

名称	类型	必填	说明
appOldGroup	number	是	变化前的应用分组
appNewGroup	number	是	变化后的应用分组
userId	number	是	用户id
changeReason	number	是	分组变化原因
bundleName	string	是	应用名称

BundleStatsInfo

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

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

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

名称	类型	必填	说明
bundleName	string	否	应用包名。
abilityPrevAccessTime	number	否	应用最后一次使用的时间。
abilityInFgTotalTime	number	否	应用在前台使用的总时间。
id	number	是	用户id。
abilityPrevSeenTime	number	否	应用最后一次在前台可见的时间。
abilitySeenTotalTime	number	否	应用在前台可见的总时间。
fgAbilityAccessTotalTime	number	否	应用访问前台的总时间。
fgAbilityPrevAccessTime	number	否	应用最后一次访问前台的时间。
infosBeginTime	number	否	BundleActiveInfo对象中第一条应用使用统计的记录时间。
infosEndTime	number	否	BundleActiveInfo对象中最后一条应用使用统计的记录时间。

BundleEvents

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

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

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

名称	类型	必填	说明
bundleName	string	否	应用包名。
eventId	number	否	应用事件类型。
eventOccurredTime	number	否	应用事件发生的时间戳。
appGroup	number	否	应用程序的使用优先级组。
indexOfLink	string	否	快捷方式id。
nameOfClass	string	否	类名。

BundleStatsMap

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

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

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

名称	类型	必填	说明
[key: string]	BundleStatsInfo	是	不同应用的使用时长统计信息。

DeviceEventStats

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

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

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

名称	类型	必填	说明
name	string	是	通知应用包名或者系统事件名。
eventId	number	是	通知、系统事件类型。
count	number	是	应用通知次数或者系统事件触发次数。

IntervalType

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

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

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

名称	值	说明
BY_OPTIMIZED	0	表示系统自行判断最合适的查询类型（天、周、月、年）去查询指定时间段间隔的应用使用时长信息。
BY_DAILY	1	表示系统按照天去查询指定时间段间隔的应用使用时长信息。
BY_WEEKLY	2	表示系统按照周去查询指定时间段间隔的应用使用时长信息。
BY_MONTHLY	3	表示系统按照月去查询指定时间段间隔的应用使用时长信息。
BY_ANNUALLY	4	表示系统按照年去查询指定时间段间隔的应用使用时长信息。

GroupType

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

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

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

名称	值	说明
ALIVE_GROUP	10	活跃分组。
DAILY_GROUP	20	经常使用，但当前并未在活跃态。
FIXED_GROUP	30	常用分组，定期使用，但不是每天使用。
RARE_GROUP	40	极少使用分组，不经常使用。
LIMITED_GROUP	50	受限使用分组。
NEVER_GROUP	60	从未使用分组，安装但是从未运行过。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙接口

harmony 鸿蒙系统公共事件定义(待停用)

harmony 鸿蒙系统公共事件定义

harmony 鸿蒙开发说明

harmony 鸿蒙企业设备管理概述（仅对系统应用开放）

harmony 鸿蒙BundleStatusCallback

harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager模块)

harmony 鸿蒙@ohos.distributedBundle (分布式包管理)

harmony 鸿蒙@ohos.bundle (Bundle模块)

harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (企业设备管理扩展能力)

0 赞

所属分类： 后端技术
本文标签：
版权声明： 原创文章如转载，请注明本文链接: https://m.seaxiang.com/blog/19ad4926b7264d3192487973f2ea38b6

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

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

导入模块

usageStatistics.isIdleState

usageStatistics.isIdleState

usageStatistics.isIdleStateSync10+

usageStatistics.queryAppGroup

usageStatistics.queryAppGroup

usageStatistics.queryAppGroupSync10+

usageStatistics.queryAppGroupSync10+

usageStatistics.queryBundleStatsInfos

usageStatistics.queryBundleStatsInfos

usageStatistics.queryBundleStatsInfoByInterval

usageStatistics.queryBundleStatsInfoByInterval

usageStatistics.queryBundleEvents

usageStatistics.queryBundleEvents

usageStatistics.queryCurrentBundleEvents

usageStatistics.queryCurrentBundleEvents

usageStatistics.queryModuleUsageRecords

usageStatistics.queryModuleUsageRecords

usageStatistics.queryModuleUsageRecords

usageStatistics.queryModuleUsageRecords

usageStatistics.queryAppGroup

usageStatistics.queryAppGroup

usageStatistics.setAppGroup

usageStatistics.setAppGroup

usageStatistics.registerAppGroupCallBack

usageStatistics.registerAppGroupCallBack

usageStatistics.unregisterAppGroupCallBack

usageStatistics.unregisterAppGroupCallBack

usageStatistics.queryDeviceEventStats

usageStatistics.queryDeviceEventStats

usageStatistics.queryNotificationEventStats

usageStatistics.queryNotificationEventStats

HapModuleInfo

HapFormInfo

AppGroupCallbackInfo

BundleStatsInfo

BundleEvents

BundleStatsMap

DeviceEventStats

IntervalType

GroupType

你可能感兴趣的鸿蒙文章

热门推荐

标签云

最新文章

本文目录

usageStatistics.isIdleStateSync¹⁰⁺

usageStatistics.queryAppGroupSync¹⁰⁺

usageStatistics.queryAppGroupSync¹⁰⁺