diff --git a/zh-cn/application-dev/device-usage-statistics/device-usage-statistics-dev-guide.md b/zh-cn/application-dev/device-usage-statistics/device-usage-statistics-dev-guide.md index 5cc72d56f4fe05ca70ba36492e5e61c696dac9f4..a0d5e22b3e34e673058f9ee5763c0bd54b645c95 100644 --- a/zh-cn/application-dev/device-usage-statistics/device-usage-statistics-dev-guide.md +++ b/zh-cn/application-dev/device-usage-statistics/device-usage-statistics-dev-guide.md @@ -15,12 +15,12 @@ import stats from '@ohos.bundleState'; | 接口名 | 描述 | | -------- | -------- | -| function queryBundleActiveStates(begin:number, end:number, callback:AsyncCallback<Array<BundleActiveState>>):void | 通过指定起始和结束时间查询所有应用的事件集合。 | -| function queryBundleStateInfos(begin:number, end:number, callback:AsyncCallback<BundleStateInfoResponse>):void | 通过指定起始和结束时间查询应用使用时长统计信息。 | -| function queryCurrentBundleActiveStates(begin:number, end:number, callback:AsyncCallback<Array<BundleActiveState>>):void | 通过指定起始和结束时间查询当前应用的事件集合。 | -| function queryBundleStateInfoByInterval(byInterval:intervalType, begin:number, end:number, callback:AsyncCallback<Array<BundleStateInfo>>):void | 通过指定时间段间隔(天、周、月、年)查询应用使用时长统计信息。 | -| function queryAppUsagePriorityGroup(callback:AsyncCallback<number>):void | 查询(返回)当前调用者应用的使用优先级群组。 | -| function isIdleState(bundleName:string, callback:AsyncCallback<boolean>):void | 判断指定Bundle Name的应用当前是否是空闲状态。 | +| function queryBundleActiveStates(begin: number, end: number, callback: AsyncCallback<Array<BundleActiveState>>): void | 通过指定起始和结束时间查询所有应用的事件集合。 | +| function queryBundleStateInfos(begin: number, end: number, callback: AsyncCallback<BundleActiveInfoResponse>): void | 通过指定起始和结束时间查询应用使用时长统计信息。 | +| function queryCurrentBundleActiveStates(begin: number, end: number, callback: AsyncCallback<Array<BundleActiveState>>): void | 通过指定起始和结束时间查询当前应用的事件集合。 | +| function queryBundleStateInfoByInterval(byInterval: IntervalType, begin: number, end: number, callback: AsyncCallback<Array<BundleStateInfo>>): void | 通过指定时间段间隔(天、周、月、年)查询应用使用时长统计信息。 | +| function queryAppUsagePriorityGroup(callback: AsyncCallback<number>): void | 查询(返回)当前调用者应用的使用优先级群组。 | +| function isIdleState(bundleName: string, callback: AsyncCallback<boolean>): void | 判断指定Bundle Name的应用当前是否是空闲状态。 | ## 开发步骤 diff --git a/zh-cn/application-dev/reference/apis/js-apis-deviceUsageStatistics.md b/zh-cn/application-dev/reference/apis/js-apis-deviceUsageStatistics.md index 8a8634363b7ed99e777444ce9c95a747951cd49b..6318668112ceb4b67ff71c4339bf8d514e1d6c9a 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-deviceUsageStatistics.md +++ b/zh-cn/application-dev/reference/apis/js-apis-deviceUsageStatistics.md @@ -7,32 +7,26 @@ ## 导入模块 ``` -import stats from '@ohos.bundleState' +import bundleState from '@ohos.bundleState' ``` ## bundleState.isIdleState -isIdleState(bundleName: string, callback: AsyncCallback): void - -- **系统能力**: -SystemCapability.ResourceSchedule.UsageStatistics.AppGroup - -- **说明**: +isIdleState(bundleName: string, callback: AsyncCallback<boolean>): void
判断指定bundleName的应用当前是否是空闲状态,使用Callback形式返回。 -- **参数**: +**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.AppGroup + +**参数**: | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | bundleName | string | 是 | 应用的bundleName。| - | callback | AsyncCallback | 是 | 指定的callback回调方法。如果指定的bundleName有效,则返回指定bundleName的应用当前是否是空闲状态;否则返回null。 | + | callback | AsyncCallback<boolean> | 是 | 指定的callback回调方法。如果指定的bundleName有效,则返回指定bundleName的应用当前是否是空闲状态;否则返回null。 | -- **权限**: -无权限 - -- **示例**: +**示例**: ``` - stats.isIdleState("com.ohos.camera", (err, res) => { + bundleState.isIdleState("com.ohos.camera", (err, res) => { if(err.code === 0) { console.log('BUNDLE_ACTIVE isIdleState callback succeeded, result: ' + JSON.stringify(res)); } else { @@ -42,33 +36,27 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup ``` ## bundleState.isIdleState -isIdleState(bundleName: string): Promise; - -- **系统能力**: -SystemCapability.ResourceSchedule.UsageStatistics.AppGroup - -- **说明**: +isIdleState(bundleName: string): Promise<boolean>
判断指定bundleName的应用当前是否是空闲状态,使用Promise形式返回。 -- **参数**: +**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.AppGroup + +**参数**: | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | bundleName | string | 是 | 应用的bundleName。| -- **返回值**: +**返回值**: | 类型 | 说明 | | -------- | -------- | - | Promise | 指定的Promise回调方法。如果指定的bundleName有效,则返回指定bundleName的应用当前是否是空闲状态;否则返回null。 | - -- **权限**: -无权限 + | Promise<boolean> | 指定的Promise回调方法。如果指定的bundleName有效,则返回指定bundleName的应用当前是否是空闲状态;否则返回null。 | -- **示例**: +**示例**: ``` - stats.isIdleState("com.ohos.camera").then( res => { + 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); @@ -76,27 +64,21 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup ``` ## bundleState.queryAppUsagePriorityGroup -queryAppUsagePriorityGroup(callback: AsyncCallback): void - -- **系统能力**: -SystemCapability.ResourceSchedule.UsageStatistics.AppGroup - -- **说明**: +queryAppUsagePriorityGroup(callback: AsyncCallback<number>): void
查询(返回)当前调用者应用的使用优先级群组,使用Callback形式返回。 -- **参数**: +**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.AppGroup + +**参数**: | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | callback | AsyncCallback | 是 | 指定的callback回调方法。返回当前调用者应用的使用优先级群组。| + | callback | AsyncCallback<number> | 是 | 指定的callback回调方法。返回当前调用者应用的使用优先级群组。| -- **权限**: -无权限 - -- **示例**: +**示例**: ``` - stats.queryAppUsagePriorityGroup((err, res) => { + bundleState.queryAppUsagePriorityGroup((err, res) => { if(err.code === 0) { console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup callback succeeded. result: ' + JSON.stringify(res)); } else { @@ -106,27 +88,21 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup ``` ## bundleState.queryAppUsagePriorityGroup -queryAppUsagePriorityGroup(): Promise - -- **系统能力**: -SystemCapability.ResourceSchedule.UsageStatistics.AppGroup - -- **说明**: +queryAppUsagePriorityGroup(): Promise<number>
查询(返回)当前调用者应用的使用优先级群组,使用Promise形式返回。 -- **返回值**: +**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.AppGroup + +**返回值**: | 类型 | 说明 | | -------- | -------- | - | Promise | 指定的Promise回调方法。查询(返回)当前调用者应用的使用优先级群组。| - -- **权限**: -无权限 + | Promise<number> | 指定的Promise回调方法。查询(返回)当前调用者应用的使用优先级群组。| -- **示例**: +**示例**: ``` - stats.queryAppUsagePriorityGroup().then( res => { + 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); @@ -134,29 +110,24 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup ``` ## bundleState.queryBundleStateInfos -queryBundleStateInfos(begin: number, end: number, callback: AsyncCallback): void - -- **系统能力**: -SystemCapability.ResourceSchedule.UsageStatistics.App +queryBundleStateInfos(begin: number, end: number, callback: AsyncCallback<BundleActiveInfoResponse>): void
+通过指定起始和结束时间查询应用使用时长统计信息,使用Callback形式返回。
+**需要权限**:ohos.permission.BUNDLE_ACTIVE_INFO -- **说明**: -通过指定起始和结束时间查询应用使用时长统计信息,使用Callback形式返回。 +**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App -- **参数**: +**参数**: | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | begin | number | 是 | 起始时间。| | end | number | 是 | 结束时间。| - | callback | AsyncCallback | 是 | 指定的callback回调方法。返回指定起始和结束时间内应用使用时长统计信息。| + | callback | AsyncCallback<BundleActiveInfoResponse> | 是 | 指定的callback回调方法。返回指定起始和结束时间内应用使用时长统计信息。| -- **权限**: -ohos.permission.BUNDLE_ACTIVE_INFO - -- **示例**: +**示例**: ``` - stats.queryBundleStateInfos(0, 20000000000000, (err, res) => { + bundleState.queryBundleStateInfos(0, 20000000000000, (err, res) => { if(err.code == 0) { console.log('BUNDLE_ACTIVE queryBundleStateInfos callback success.'); let i = 1; @@ -172,34 +143,29 @@ ohos.permission.BUNDLE_ACTIVE_INFO ``` ## bundleState.queryBundleStateInfos -queryBundleStateInfos(begin: number, end: number): Promise - -- **系统能力**: -SystemCapability.ResourceSchedule.UsageStatistics.App +queryBundleStateInfos(begin: number, end: number): Promise<BundleActiveInfoResponse>
+通过指定起始和结束时间查询应用使用时长统计信息,使用Promise形式返回。
+**需要权限**:ohos.permission.BUNDLE_ACTIVE_INFO -- **说明**: -通过指定起始和结束时间查询应用使用时长统计信息,使用Promise形式返回。 +**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App -- **参数**: +**参数**: | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | begin | number | 是 | 起始时间。| | end | number | 是 | 结束时间。| -- **返回值**: +**返回值**: | 类型 | 说明 | | -------- | -------- | - | Promise | 指定的Promise回调方法。返回指定起始和结束时间内应用使用时长统计信息。| - -- **权限**: -ohos.permission.BUNDLE_ACTIVE_INFO + | Promise<BundleActiveInfoResponse> | 指定的Promise回调方法。返回指定起始和结束时间内应用使用时长统计信息。| -- **示例**: +**示例**: ``` - stats.queryBundleStateInfos(0, 20000000000000).then( res => { + bundleState.queryBundleStateInfos(0, 20000000000000).then( res => { console.log('BUNDLE_ACTIVE queryBundleStateInfos promise success.'); let i = 1; for(let key in res){ @@ -213,30 +179,25 @@ ohos.permission.BUNDLE_ACTIVE_INFO ``` ## bundleState.queryBundleStateInfoByInterval -queryBundleStateInfoByInterval(byInterval: IntervalType, begin: number, end: number, callback: AsyncCallback>): void +queryBundleStateInfoByInterval(byInterval: IntervalType, begin: number, end: number, callback: AsyncCallback<Array<BundleStateInfo>>): void
+通过指定时间段间隔(天、周、月、年)查询应用使用时长统计信息,使用Callback形式返回。
+**需要权限**:ohos.permission.BUNDLE_ACTIVE_INFO -- **系统能力**: -SystemCapability.ResourceSchedule.UsageStatistics.App +**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App -- **说明**: -通过指定时间段间隔(天、周、月、年)查询应用使用时长统计信息,使用Callback形式返回。 - -- **参数**: +**参数**: | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | byInterval | IntervalType | 是 | 查询类型。| | begin | number | 是 | 起始时间。| | end | number | 是 | 结束时间。| - | callback | AsyncCallback> | 是 | 指定的callback回调方法。返回指定时间段间隔(天、周、月、年)查询应用使用时长统计信息。| - -- **权限**: -ohos.permission.BUNDLE_ACTIVE_INFO + | callback | AsyncCallback<Array<BundleStateInfo>> | 是 | 指定的callback回调方法。返回指定时间段间隔(天、周、月、年)查询应用使用时长统计信息。| -- **示例**: +**示例**: ``` - stats.queryBundleStateInfoByInterval(0, 0, 20000000000000, (err, res) => { + bundleState.queryBundleStateInfoByInterval(0, 0, 20000000000000, (err, res) => { if(err.code == 0) { console.log('BUNDLE_ACTIVE queryBundleStateInfoByInterval callback success.'); for (let i = 0; i < res.length; i++) { @@ -250,15 +211,13 @@ ohos.permission.BUNDLE_ACTIVE_INFO ``` ## bundleState.queryBundleStateInfoByInterval -queryBundleStateInfoByInterval(byInterval: IntervalType, begin: number, end: number): Promise> +queryBundleStateInfoByInterval(byInterval: IntervalType, begin: number, end: number): Promise<Array<BundleStateInfo>>
+通过指定时间段间隔(天、周、月、年)查询应用使用时长统计信息,使用Promise形式返回。
+**需要权限**:ohos.permission.BUNDLE_ACTIVE_INFO -- **系统能力**: -SystemCapability.ResourceSchedule.UsageStatistics.App +**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App -- **说明**: -通过指定时间段间隔(天、周、月、年)查询应用使用时长统计信息,使用Promise形式返回。 - -- **参数**: +**参数**: | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | @@ -266,19 +225,16 @@ SystemCapability.ResourceSchedule.UsageStatistics.App | begin | number | 是 | 起始时间。| | end | number | 是 | 结束时间。| -- **返回值**: +**返回值**: | 类型 | 说明 | | -------- | -------- | - | Promise> | 指定的Promise回调方法。返回指定时间段间隔(天、周、月、年)查询应用使用时长统计信息。| - -- **权限**: -ohos.permission.BUNDLE_ACTIVE_INFO + | Promise<Array<BundleStateInfo>> | 指定的Promise回调方法。返回指定时间段间隔(天、周、月、年)查询应用使用时长统计信息。| -- **示例**: +**示例**: ``` - stats.queryBundleStateInfoByInterval(0, 0, 20000000000000).then( res => { + 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)); @@ -290,29 +246,24 @@ ohos.permission.BUNDLE_ACTIVE_INFO ``` ## bundleState.queryBundleActiveStates -queryBundleActiveStates(begin: number, end: number, callback: AsyncCallback>): void - -- **系统能力**: -SystemCapability.ResourceSchedule.UsageStatistics.App +queryBundleActiveStates(begin: number, end: number, callback: AsyncCallback<Array<BundleActiveState>>): void
+通过指定起始和结束时间查询所有应用的事件集合,使用Callback形式返回。
+**需要权限**:ohos.permission.BUNDLE_ACTIVE_INFO -- **说明**: -通过指定起始和结束时间查询所有应用的事件集合,使用Callback形式返回。 +**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App -- **参数**: +**参数**: | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | begin | number | 是 | 起始时间。| | end | number | 是 | 结束时间。| - | callback | AsyncCallback> | 是 | 指定的callback回调方法。返回指定起始和结束时间查询所有应用的事件集合。| + | callback | AsyncCallback<Array<BundleActiveState>> | 是 | 指定的callback回调方法。返回指定起始和结束时间查询所有应用的事件集合。| -- **权限**: -ohos.permission.BUNDLE_ACTIVE_INFO - -- **示例**: +**示例**: ``` - stats.queryBundleActiveStates(0, 20000000000000, (err, res) => { + bundleState.queryBundleActiveStates(0, 20000000000000, (err, res) => { if(err.code == 0) { console.log('BUNDLE_ACTIVE queryBundleActiveStates callback success.'); for (let i = 0; i < res.length; i++) { @@ -326,34 +277,29 @@ ohos.permission.BUNDLE_ACTIVE_INFO ``` ## bundleState.queryBundleActiveStates -queryBundleActiveStates(begin: number, end: number): Promise> - -- **系统能力**: -SystemCapability.ResourceSchedule.UsageStatistics.App +queryBundleActiveStates(begin: number, end: number): Promise<Array<BundleActiveState>>
+通过指定起始和结束时间查询所有应用的事件集合,使用Promise形式返回。
+**需要权限**:ohos.permission.BUNDLE_ACTIVE_INFO -- **说明**: -通过指定起始和结束时间查询所有应用的事件集合,使用Promise形式返回。 +**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App -- **参数**: +**参数**: | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | begin | number | 是 | 起始时间。| | end | number | 是 | 结束时间。| -- **返回值**: +**返回值**: | 类型 | 说明 | | -------- | -------- | - | Promise> | 指定的Promise回调方法。返回指定起始和结束时间查询所有应用的事件集合。| - -- **权限**: -ohos.permission.BUNDLE_ACTIVE_INFO + | Promise<Array<BundleActiveState>> | 指定的Promise回调方法。返回指定起始和结束时间查询所有应用的事件集合。| -- **示例**: +**示例**: ``` - stats.queryBundleActiveStates(0, 20000000000000).then( res => { + 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)); @@ -365,29 +311,23 @@ ohos.permission.BUNDLE_ACTIVE_INFO ``` ## bundleState.queryCurrentBundleActiveStates -queryCurrentBundleActiveStates(begin: number, end: number, callback: AsyncCallback>): void - -- **系统能力**: -SystemCapability.ResourceSchedule.UsageStatistics.App - -- **说明**: +queryCurrentBundleActiveStates(begin: number, end: number, callback: AsyncCallback<Array<BundleActiveState>>): void
通过指定起始和结束时间查询当前应用的事件集合,使用Callback形式返回。 -- **参数**: +**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App + +**参数**: | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | begin | number | 是 | 起始时间。| | end | number | 是 | 结束时间。| - | callback | AsyncCallback> | 是 | 指定的callback回调方法。返回指定起始和结束时间查询当前应用的事件集合。| + | callback | AsyncCallback<Array<BundleActiveState>> | 是 | 指定的callback回调方法。返回指定起始和结束时间查询当前应用的事件集合。| -- **权限**: -无权限 - -- **示例**: +**示例**: ``` - stats.queryCurrentBundleActiveStates(0, 20000000000000, (err, res) => { + bundleState.queryCurrentBundleActiveStates(0, 20000000000000, (err, res) => { if(err.code == 0) { console.log('BUNDLE_ACTIVE queryCurrentBundleActiveStates callback success.'); for (let i = 0; i < res.length; i++) { @@ -401,34 +341,28 @@ SystemCapability.ResourceSchedule.UsageStatistics.App ``` ## bundleState.queryCurrentBundleActiveStates -queryCurrentBundleActiveStates(begin: number, end: number): Promise> - -- **系统能力**: -SystemCapability.ResourceSchedule.UsageStatistics.App - -- **说明**: +queryCurrentBundleActiveStates(begin: number, end: number): Promise<Array<BundleActiveState>>
通过指定起始和结束时间查询当前应用的事件集合,使用Promise形式返回。 -- **参数**: +**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App + +**参数**: | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | begin | number | 是 | 起始时间。| | end | number | 是 | 结束时间。| -- **返回值**: +**返回值**: | 类型 | 说明 | | -------- | -------- | - | Promise> | 指定的Promise回调方法。返回指定起始和结束时间查询当前应用的事件集合。| - -- **权限**: -无权限 + | Promise<Array<BundleActiveState>> | 指定的Promise回调方法。返回指定起始和结束时间查询当前应用的事件集合。| -- **示例**: +**示例**: ``` - stats.queryCurrentBundleActiveStates(0, 20000000000000).then( res => { + 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)); @@ -439,58 +373,70 @@ SystemCapability.ResourceSchedule.UsageStatistics.App }); ``` -## bundleState.BundleStateInfo -- **系统能力**: -SystemCapability.ResourceSchedule.UsageStatistics.App +## BundleStateInfo +提供应用使用时长的具体信息。 -- **参数**: +### 属性 +**系统能力**:以下各项对应的系统能力均为SystemCapability.ResourceSchedule.UsageStatistics.App - 提供应用使用时长的具体信息。 - - | 参数名 | 类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | bundleName | string | 是 | 应用包名。| - | abilityPrevAccessTime | number | 是 | 应用最后一次使用的时间。| - | abilityInFgTotalTime | number | 是 | 应用在前台使用的总时间。| +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| bundleName | string | 是 | 应用包名。| +| abilityPrevAccessTime | number | 是 | 应用最后一次使用的时间。| +| abilityInFgTotalTime | number | 是 | 应用在前台使用的总时间。| +| id | number | 否 | 用户id。
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。| +| abilityPrevSeenTime | number | 否 | 应用最后一次在前台可见的时间。
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。| +| abilitySeenTotalTime | number | 否 | 应用在前台可见的总时间。
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。| +| fgAbilityAccessTotalTime | number | 否 | 应用访问前台的总时间。
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。| +| fgAbilityPrevAccessTime | number | 否 | 应用最后一次访问前台的时间。
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。| +| infosBeginTime | number | 否 | BundleActiveInfo对象中第一条应用使用统计的记录时间。
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。| +| infosBeginTime | number | 否 | BundleActiveInfo对象中最后一条应用使用统计的记录时间。
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。| -## bundleState.BundleActiveState -- **系统能力**: -SystemCapability.ResourceSchedule.UsageStatistics.App +### merge +merge(toMerge: BundleStateInfo): void +合并相同包名的应用使用信息。
+本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。 -- **参数**: +**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App - 提供应用事件的具体信息。 +**参数**: | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | - | bundleName | string | 是 | 应用包名。| - | stateType | number | 是 | 应用事件类型。| - | stateOccurredTime | number | 是 | 应用事件发生的时间戳。| + | toMerge | BundleStateInfo | 是 | 相同包名的应用使用统计信息。| -## bundleState.BundleActiveInfoResponse -- **系统能力**: -SystemCapability.ResourceSchedule.UsageStatistics.App +## BundleActiveState +提供应用事件的具体信息。 -- **参数**: +**系统能力**:以下各项对应的系统能力均为SystemCapability.ResourceSchedule.UsageStatistics.App - 提供应用使用时长的具体信息。 +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| bundleName | string | 是 | 应用包名。| +| stateType | number | 是 | 应用事件类型。| +| stateOccurredTime | number | 是 | 应用事件发生的时间戳。| +| appUsagePriorityGroup | number | 否 | 应用程序的使用优先级组。
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。| +| indexOfLink | string | 否 | 快捷方式id。
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。| +| nameOfClass | string | 否 | 类名。
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。| - | 参数名 | 类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | [key: string]: BundleStateInfo | BundleStateInfo | 是 | 不同应用的使用时长统计信息。| +## BundleActiveInfoResponse +提供应用使用时长的具体信息。 -## bundleState.IntervalType -- **系统能力**: -SystemCapability.ResourceSchedule.UsageStatistics.App +**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App -- **参数**: +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| [key: string]: BundleStateInfo | BundleStateInfo | 是 | 不同应用的使用时长统计信息。| + +## bundleState.IntervalType +提供应用使用时长的查询类型。 - 提供查询的类型 +**系统能力**:以下各项对应的系统能力均为SystemCapability.ResourceSchedule.UsageStatistics.App - |名称 |默认值 |说明| - | -------- | -------- | -------- | - | BY_OPTIMIZED | 0 | 表示系统自己判断最合适的查询类型(天、周、月、年)去查询指定时间段间隔的应用使用时长信息。| - | BY_DAILY | 1 | 表示系统按照天去查询指定时间段间隔的应用使用时长信息。| - | BY_WEEKLY | 2 | 表示系统按照周去查询指定时间段间隔的应用使用时长信息。| - | BY_MONTHLY | 3 | 表示系统按照月去查询指定时间段间隔的应用使用时长信息。| - | BY_ANNUALLY | 4 | 表示系统按照年去查询指定时间段间隔的应用使用时长信息。| \ No newline at end of file +|名称 |默认值 |说明| +| -------- | -------- | -------- | +| BY_OPTIMIZED | 0 | 表示系统自行判断最合适的查询类型(天、周、月、年)去查询指定时间段间隔的应用使用时长信息。| +| BY_DAILY | 1 | 表示系统按照天去查询指定时间段间隔的应用使用时长信息。| +| BY_WEEKLY | 2 | 表示系统按照周去查询指定时间段间隔的应用使用时长信息。| +| BY_MONTHLY | 3 | 表示系统按照月去查询指定时间段间隔的应用使用时长信息。| +| BY_ANNUALLY | 4 | 表示系统按照年去查询指定时间段间隔的应用使用时长信息。| \ No newline at end of file