From ce84ee6acf663d52f88574fbf35a00a24c2d6af0 Mon Sep 17 00:00:00 2001 From: "yupeng74@huawei.com" Date: Tue, 7 Jun 2022 15:13:19 +0800 Subject: [PATCH] =?UTF-8?q?=E5=BA=94=E7=94=A8=E5=88=86=E7=BB=84=E4=BF=A1?= =?UTF-8?q?=E6=81=AFdocs?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: yupeng74@huawei.com --- .../device-usage-statistics-dev-guide.md | 9 +- .../apis/js-apis-deviceUsageStatistics.md | 86 ++++--------------- 2 files changed, 22 insertions(+), 73 deletions(-) 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 9306c71b1f..60c9360c52 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 @@ -19,15 +19,14 @@ import stats from '@ohos.bundleState'; | 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 queryAppUsagePriorityGroup(bundleName？：string， callback: AsyncCallback<number>): void | 查询（返回）当前调用者应用或者指定应用的使用优先级群组。callback形式。 | -| function queryAppUsagePriorityGroup(bundleName? : string): Promise; | 查询（返回）当前调用者应用或者指定应用的使用优先级群组。promise形式。 | +| function queryAppUsagePriorityGroup(bundleName? : string, callback: AsyncCallback<number>): void | 查询当前调用者应用或者指定应用的使用优先级群组。callback形式。 | +| function queryAppUsagePriorityGroup(bundleName? : string): Promise; | 查询当前调用者应用或者指定应用的使用优先级群组。promise形式。 | | function isIdleState(bundleName: string, callback: AsyncCallback<boolean>): void | 判断指定Bundle Name的应用当前是否是空闲状态。 | | function getRecentlyUsedModules(maxNum: number, callback: AsyncCallback<BundleActiveModuleInfo>): void | 根据maxNum，查询FA使用记录，返回不超过maxNum条FA使用记录。 | | function queryAppNotificationNumber(begin: number, end: number, callback: AsyncCallback<Array<BundleActiveEventState>>): void | 通过指定起始和结束时间查询所有应用的通知次数。 | | function queryBundleActiveEventStates(begin: number, end: number, callback: AsyncCallback<Array<BundleActiveEventState>>): void | 通过指定起始和结束时间查询系统事件（休眠、唤醒、解锁、锁屏）统计信息。 | -| function setBundleGroup(bundleName: string, newGroup: GroupType, callback: AsyncCallback): void | 给应用名是bundleName的应用分组设置成newGroup，返回设置结果是否成功，callback形式 | -| function setBundleGroup(bundleName: string, newGroup: GroupType): Promise; | 给应用名是bundleName的应用分组设置成newGroup，返回设置结果是否成功，promise形式 | +| function setBundleGroup(bundleName : string, newGroup: GroupType, callback: AsyncCallback): void | 给应用名是bundleName的应用分组设置成newGroup，返回设置结果是否成功，callback形式 | +| function setBundleGroup(bundleName : string, newGroup : GroupType): Promise; | 给应用名是bundleName的应用分组设置成newGroup，返回设置结果是否成功，promise形式 | | function registerGroupCallBack(callback: Callback, callback: AsyncCallback): void | 注册应用分组变化监听回调，返回注册是否成功，当应用分组发生变化时，会给所有已注册的监听者返回回调信息，callback | | function registerGroupCallBack(callback: Callback): Promise; | 注册应用分组变化监听回调，返回注册是否成功，当应用分组发生变化时，会给所有已注册的监听者返回回调信息，promise | | function unRegisterGroupCallBack(callback: AsyncCallback): void | 解除应用分组监听回调，callback形式 | 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 164504b48d..d6f4af0501 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-deviceUsageStatistics.md +++ b/zh-cn/application-dev/reference/apis/js-apis-deviceUsageStatistics.md @@ -69,69 +69,19 @@ isIdleState(bundleName: string): Promise<boolean> ## bundleState.queryAppUsagePriorityGroup -queryAppUsagePriorityGroup(callback: AsyncCallback<number>): void - -查询（返回）当前调用者应用的使用优先级群组，使用Callback形式返回。 - -**系统能力**：SystemCapability.ResourceSchedule.UsageStatistics.AppGroup - -**参数**： - - | 参数名 | 类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | callback | AsyncCallback<number> | 是 | 指定的callback回调方法。返回当前调用者应用的使用优先级群组。| - -**示例**： - - ```js - bundleState.queryAppUsagePriorityGroup((err, res) => { - if (err) { - console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup callback failed. because: ' + err.code); - } else { - console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup callback succeeded. result: ' + JSON.stringify(res)); - } - }); - ``` - -## bundleState.queryAppUsagePriorityGroup - -queryAppUsagePriorityGroup(): Promise<number> - -查询（返回）当前调用者应用的使用优先级群组，使用Promise形式返回。 - -**系统能力**：SystemCapability.ResourceSchedule.UsageStatistics.AppGroup - -**返回值**： - - | 类型 | 说明 | - | -------- | -------- | - | Promise<number> | 指定的Promise回调方法。查询（返回）当前调用者应用的使用优先级群组。| - -**示例**： - - ```js - bundleState.queryAppUsagePriorityGroup().then( res => { - console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup promise succeeded. result: ' + JSON.stringify(res)); - }).catch( err => { - console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup promise failed. because: ' + err.code); - }); - ``` - -## bundleState.queryAppUsagePriorityGroup9+ - queryAppUsagePriorityGroup(bundleName? : string): Promise 根据bundleName，查询对应的应用分组，使用Promise形式返回其应用分组。 **需要权限**：ohos.permission.BUNDLE_ACTIVE_INFO -**系统能力**：SystemCapability.ResourceSchedule.UsageStatistics.App +**系统能力**：SystemCapability.ResourceSchedule.UsageStatistics.AppGroup **参数**： -| 参数名 | 类型 | 必填 | 说明 | -| ---------- | ------ | ---- | ------------------------------------------------------------ | -| bundleName | string | 否 | 有参的时候查询名称为bundleName的应用的分组，没有参数则是查询自己 | +| 参数名 | 类型 | 必填 | 说明 | +| ----------------------- | ------ | ---- | ------------------------------------------------------------ | +| bundleName9+ | string | 否 | 有参的时候查询名称为bundleName的应用的分组，没有参数则是查询自己 | **返回值**： @@ -156,7 +106,7 @@ bundleState.queryAppUsagePriorityGroup().then( res => { }); ``` -## bundleState.queryAppUsagePriorityGroup9+ +## bundleState.queryAppUsagePriorityGroup queryAppUsagePriorityGroup(bundleName? : string, callback: AsyncCallback): void @@ -164,14 +114,14 @@ queryAppUsagePriorityGroup(bundleName? : string, callback: AsyncCallback **需要权限**：ohos.permission.BUNDLE_ACTIVE_INFO -**系统能力**：SystemCapability.ResourceSchedule.UsageStatistics.App +**系统能力**：SystemCapability.ResourceSchedule.UsageStatistics.AppGroup **参数**： -| 参数名 | 类型 | 必填 | 说明 | -| ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | -| bundleName | string | 否 | 有参的时候查询名称为bundleName的应用的分组，没有参数则是查询自己 | -| callback | AsyncCallback<Array<[BundleActiveModuleInfo](#bundleactivemoduleinfo9)>> | 是 | 指定的CallBack回调方法。返回查询的应用分组。 | +| 参数名 | 类型 | 必填 | 说明 | +| ----------------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | +| bundleName9+ | string | 否 | 有参的时候查询名称为bundleName的应用的分组，没有参数则是查询自己 | +| callback | AsyncCallback<Array<[BundleActiveModuleInfo](#bundleactivemoduleinfo9)>> | 是 | 指定的CallBack回调方法。返回查询的应用分组。 | **示例**： @@ -581,7 +531,7 @@ setBundleGroup(bundleName: string, newGroup: GroupType): Promise **需要权限**：ohos.permission.BUNDLE_ACTIVE_INFO -**系统能力**：SystemCapability.ResourceSchedule.UsageStatistics.App +**系统能力**：SystemCapability.ResourceSchedule.UsageStatistics.AppGroup **参数**： @@ -617,7 +567,7 @@ setBundleGroup(bundleName: string, newGroup: GroupType, callback: AsyncCallback< **需要权限**：ohos.permission.BUNDLE_ACTIVE_INFO -**系统能力**：SystemCapability.ResourceSchedule.UsageStatistics.App +**系统能力**：SystemCapability.ResourceSchedule.UsageStatistics.AppGroup **参数**： @@ -650,7 +600,7 @@ registerGroupCallBack(callback: Callback): Promis **需要权限**：ohos.permission.BUNDLE_ACTIVE_INFO -**系统能力**：SystemCapability.ResourceSchedule.UsageStatistics.App +**系统能力**：SystemCapability.ResourceSchedule.UsageStatistics.AppGroup **参数**： @@ -690,7 +640,7 @@ registerGroupCallBack(callback: Callback, callbac **需要权限**：ohos.permission.BUNDLE_ACTIVE_INFO -**系统能力**：SystemCapability.ResourceSchedule.UsageStatistics.App +**系统能力**：SystemCapability.ResourceSchedule.UsageStatistics.AppGroup **参数**： @@ -728,7 +678,7 @@ unRegisterGroupCallBack(): Promise **需要权限**：ohos.permission.BUNDLE_ACTIVE_INFO -**系统能力**：SystemCapability.ResourceSchedule.UsageStatistics.App +**系统能力**：SystemCapability.ResourceSchedule.UsageStatistics.AppGroup **参数**：无参数 @@ -756,7 +706,7 @@ unRegisterGroupCallBack(callback: AsyncCallback): void; **需要权限**：ohos.permission.BUNDLE_ACTIVE_INFO -**系统能力**：SystemCapability.ResourceSchedule.UsageStatistics.App +**系统能力**：SystemCapability.ResourceSchedule.UsageStatistics.AppGroup **参数**： @@ -961,7 +911,7 @@ FA卡片的使用信息的属性集合。 ### 属性 -**系统能力**：以下各项对应的系统能力均为SystemCapability.ResourceSchedule.UsageStatistics.App +**系统能力**：以下各项对应的系统能力均为SystemCapability.ResourceSchedule.UsageStatistics.AppGroup | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | @@ -1047,7 +997,7 @@ merge(toMerge: BundleStateInfo): void 提供应用分组的设置类型。 -**系统能力**：以下各项对应的系统能力均为SystemCapability.ResourceSchedule.UsageStatistics.App +**系统能力**：以下各项对应的系统能力均为SystemCapability.ResourceSchedule.UsageStatistics.AppGroup | 名称 | 默认值 | 说明 | | ------------------ | ------ | ---------------------------------- | -- GitLab