1# 设备使用信息统计概述 2 3设备使用信息统计，包括app usage、notification usage、system usage等使用统计，目前只支持app usage使用统计。应用使用信息统计，用于保存和查询应用使用详情（app usage）、事件日志数据（event log）、应用分组（bundle group）情况。部件缓存的应用记录（使用历史统计和使用事件记录）会在事件上报后30分钟内刷新到数据库持久化保存。 4 5## 设备使用信息统计功能说明 6 7设备使用信息统计接口众多，目前只支持app usage使用统计，接下来介绍下应用使用详情（app usage）的接口逻辑。 8 9- **应用使用统计信息落盘时机**： 10 1. 每隔30分钟触发一次刷新。 11 2. 系统时间变更触发一次刷新。 12 3. 下一天开始触发一次刷新。 13 14- **应用查询接口**： 15 1. 根据起止时间查询所有应用的事件集合。 16 2. 根据起止时间查询应用的使用时长。 17 3. 根据起止时间查询当前应用的事件集合。 18 4. 根据interval（日、周、月、年）类型和起止时间查询应用的使用时长。 19 5. 查询调用者应用的优先级群组。 20 6. 判断指定应用当前是否是空闲状态。 21 7. 查询FA使用记录。返回数量最大不超过maxNum设置的值，FA使用记录由近及远排序，maxNum最大为1000，若不填写maxNum参数，则maxNum默认为1000。 22 8. 根据起止时间查询应用通知次数。 23 9. 根据起止时间查询系统事件（休眠、唤醒、解锁、锁屏）统计信息。 24 10. 查询调用者应用或指定应用的优先级群组。 25 26- **设置接口** 27 28 给应用名称为bundleName的应用分组设置为newGroup。 29 30- **注册接口** 31 32 注册应用分组变化回调监听，当应用分组发生变化，会给所有已注册的应用返回变化信息。 33 34- **解除注册接口** 35 36 解除注册应用分组变化回调监听。 37 38## 设备使用信息统计使用权限 39- 设备使用信息统计的isIdleState、queryBundleEvents、queryBundleStatsInfos、queryBundleStatsInfoByInterval、queryDeviceEventStats、queryNotificationEventStats、queryAppGroup(bundleName)、setAppGroup、registerAppGroupCallBack、unregisterAppGroupCallBack、queryModuleUsageRecords和queryModuleUsageRecords(maxnum)接口为系统api，调用前需要申请ohos.permission.BUNDLE_ACTIVE_INFO权限。 40- 设备使用信息统计的queryCurrentBundleEvents、queryAppGroup()接口为三方api，调用时不需要申请权限。