提交 ce84ee6a 编写于 作者: Y yupeng74@huawei.com

应用分组信息docs

Signed-off-by: Nyupeng74@huawei.com <yupeng74@huawei.com>
上级 94f75a1d
......@@ -19,15 +19,14 @@ import stats from '@ohos.bundleState';
| function queryBundleStateInfos(begin: number, end: number, callback: AsyncCallback&lt;BundleActiveInfoResponse&gt;): void | 通过指定起始和结束时间查询应用使用时长统计信息。 |
| function queryCurrentBundleActiveStates(begin: number, end: number, callback: AsyncCallback&lt;Array&lt;BundleActiveState&gt;&gt;): void | 通过指定起始和结束时间查询当前应用的事件集合。 |
| function queryBundleStateInfoByInterval(byInterval: IntervalType, begin: number, end: number, callback: AsyncCallback&lt;Array&lt;BundleStateInfo&gt;&gt;): void | 通过指定时间段间隔(天、周、月、年)查询应用使用时长统计信息。 |
| function queryAppUsagePriorityGroup(callback: AsyncCallback&lt;number&gt;): void | 查询(返回)当前调用者应用的使用优先级群组。 |
| function queryAppUsagePriorityGroup(bundleName?:string, callback: AsyncCallback&lt;number&gt;): void | 查询(返回)当前调用者应用或者指定应用的使用优先级群组。callback形式。 |
| function queryAppUsagePriorityGroup(bundleName? : string): Promise<number>; | 查询(返回)当前调用者应用或者指定应用的使用优先级群组。promise形式。 |
| function queryAppUsagePriorityGroup(bundleName? : string, callback: AsyncCallback&lt;number&gt;): void | 查询当前调用者应用或者指定应用的使用优先级群组。callback形式。 |
| function queryAppUsagePriorityGroup(bundleName? : string): Promise<number>; | 查询当前调用者应用或者指定应用的使用优先级群组。promise形式。 |
| function isIdleState(bundleName: string, callback: AsyncCallback&lt;boolean&gt;): void | 判断指定Bundle Name的应用当前是否是空闲状态。 |
| function getRecentlyUsedModules(maxNum: number, callback: AsyncCallback&lt;BundleActiveModuleInfo&gt;): void | 根据maxNum,查询FA使用记录,返回不超过maxNum条FA使用记录。 |
| function queryAppNotificationNumber(begin: number, end: number, callback: AsyncCallback&lt;Array&lt;BundleActiveEventState&gt;&gt;): void | 通过指定起始和结束时间查询所有应用的通知次数。 |
| function queryBundleActiveEventStates(begin: number, end: number, callback: AsyncCallback&lt;Array&lt;BundleActiveEventState&gt;&gt;): void | 通过指定起始和结束时间查询系统事件(休眠、唤醒、解锁、锁屏)统计信息。 |
| function setBundleGroup(bundleName: string, newGroup: GroupType, callback: AsyncCallback<boolean>): void | 给应用名是bundleName的应用分组设置成newGroup,返回设置结果是否成功,callback形式 |
| function setBundleGroup(bundleName: string, newGroup: GroupType): Promise<boolean>; | 给应用名是bundleName的应用分组设置成newGroup,返回设置结果是否成功,promise形式 |
| function setBundleGroup(bundleName : string, newGroup: GroupType, callback: AsyncCallback<boolean>): void | 给应用名是bundleName的应用分组设置成newGroup,返回设置结果是否成功,callback形式 |
| function setBundleGroup(bundleName : string, newGroup : GroupType): Promise<boolean>; | 给应用名是bundleName的应用分组设置成newGroup,返回设置结果是否成功,promise形式 |
| function registerGroupCallBack(callback: Callback<BundleActiveGroupCallbackInfo>, callback: AsyncCallback<boolean>): void | 注册应用分组变化监听回调,返回注册是否成功,当应用分组发生变化时,会给所有已注册的监听者返回回调信息,callback |
| function registerGroupCallBack(callback: Callback<BundleActiveGroupCallbackInfo>): Promise<boolean>; | 注册应用分组变化监听回调,返回注册是否成功,当应用分组发生变化时,会给所有已注册的监听者返回回调信息,promise |
| function unRegisterGroupCallBack(callback: AsyncCallback<boolean>): void | 解除应用分组监听回调,callback形式 |
......
......@@ -69,69 +69,19 @@ isIdleState(bundleName: string): Promise&lt;boolean&gt;
## bundleState.queryAppUsagePriorityGroup
queryAppUsagePriorityGroup(callback: AsyncCallback&lt;number&gt;): void
查询(返回)当前调用者应用的使用优先级群组,使用Callback形式返回。
**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
**参数**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;number&gt; | 是 | 指定的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&lt;number&gt;
查询(返回)当前调用者应用的使用优先级群组,使用Promise形式返回。
**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
**返回值**
| 类型 | 说明 |
| -------- | -------- |
| Promise&lt;number&gt; | 指定的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.queryAppUsagePriorityGroup<sup>9+</sup>
queryAppUsagePriorityGroup(bundleName? : string): Promise<number>
根据bundleName,查询对应的应用分组,使用Promise形式返回其应用分组。
**需要权限**:ohos.permission.BUNDLE_ACTIVE_INFO
**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App
**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
**参数**
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | ------------------------------------------------------------ |
| bundleName | string | 否 | 有参的时候查询名称为bundleName的应用的分组,没有参数则是查询自己 |
| 参数名 | 类型 | 必填 | 说明 |
| ----------------------- | ------ | ---- | ------------------------------------------------------------ |
| bundleName<sup>9+</sup> | string | 否 | 有参的时候查询名称为bundleName的应用的分组,没有参数则是查询自己 |
**返回值**
......@@ -156,7 +106,7 @@ bundleState.queryAppUsagePriorityGroup().then( res => {
});
```
## bundleState.queryAppUsagePriorityGroup<sup>9+</sup>
## bundleState.queryAppUsagePriorityGroup
queryAppUsagePriorityGroup(bundleName? : string, callback: AsyncCallback<number>): void
......@@ -164,14 +114,14 @@ queryAppUsagePriorityGroup(bundleName? : string, callback: AsyncCallback<number>
**需要权限**:ohos.permission.BUNDLE_ACTIVE_INFO
**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App
**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
**参数**
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| bundleName | string | 否 | 有参的时候查询名称为bundleName的应用的分组,没有参数则是查询自己 |
| callback | AsyncCallback&lt;Array&lt;[BundleActiveModuleInfo](#bundleactivemoduleinfo9)&gt;&gt; | 是 | 指定的CallBack回调方法。返回查询的应用分组。 |
| 参数名 | 类型 | 必填 | 说明 |
| ----------------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| bundleName<sup>9+</sup> | string | 否 | 有参的时候查询名称为bundleName的应用的分组,没有参数则是查询自己 |
| callback | AsyncCallback&lt;Array&lt;[BundleActiveModuleInfo](#bundleactivemoduleinfo9)&gt;&gt; | 是 | 指定的CallBack回调方法。返回查询的应用分组。 |
**示例**
......@@ -581,7 +531,7 @@ setBundleGroup(bundleName: string, newGroup: GroupType): Promise<boolean>
**需要权限**: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<BundleActiveGroupCallbackInfo>): Promis
**需要权限**:ohos.permission.BUNDLE_ACTIVE_INFO
**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App
**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
**参数**
......@@ -690,7 +640,7 @@ registerGroupCallBack(callback: Callback<BundleActiveGroupCallbackInfo>, callbac
**需要权限**:ohos.permission.BUNDLE_ACTIVE_INFO
**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App
**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
**参数**
......@@ -728,7 +678,7 @@ unRegisterGroupCallBack(): Promise<boolean>
**需要权限**:ohos.permission.BUNDLE_ACTIVE_INFO
**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App
**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
**参数**:无参数
......@@ -756,7 +706,7 @@ unRegisterGroupCallBack(callback: AsyncCallback<boolean>): 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
| 名称 | 默认值 | 说明 |
| ------------------ | ------ | ---------------------------------- |
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册