Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
b119db8e
D
Docs
项目概览
OpenHarmony
/
Docs
大约 1 年 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
未验证
提交
b119db8e
编写于
6月 13, 2022
作者:
O
openharmony_ci
提交者:
Gitee
6月 13, 2022
浏览文件
操作
浏览文件
下载
差异文件
!5266 应用信息统计docs文档修改
Merge pull request !5266 from yp99ustc/master
上级
3365fd21
9deae038
变更
3
隐藏空白更改
内联
并排
Showing
3 changed file
with
185 addition
and
105 deletion
+185
-105
zh-cn/application-dev/device-usage-statistics/device-usage-statistics-dev-guide.md
...ice-usage-statistics/device-usage-statistics-dev-guide.md
+63
-41
zh-cn/application-dev/device-usage-statistics/device-usage-statistics-overview.md
...vice-usage-statistics/device-usage-statistics-overview.md
+4
-3
zh-cn/application-dev/reference/apis/js-apis-deviceUsageStatistics.md
...ation-dev/reference/apis/js-apis-deviceUsageStatistics.md
+118
-61
未找到文件。
zh-cn/application-dev/device-usage-statistics/device-usage-statistics-dev-guide.md
浏览文件 @
b119db8e
...
...
@@ -19,18 +19,20 @@ 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(
bundleName? : string, callback: AsyncCallback
<
number
>
): void | 查询当前调用者应用或者指定
应用的使用优先级群组。callback形式。 |
| function queryAppUsagePriorityGroup(
bundleName? : string): Promise
<number>
; | 查询当前调用者应用或者指定
应用的使用优先级群组。promise形式。 |
| function queryAppUsagePriorityGroup(
callback: AsyncCallback
<
number
>
): void | 查询当前
应用的使用优先级群组。callback形式。 |
| function queryAppUsagePriorityGroup(
): Promise
<
number
>
; | 查询当前
应用的使用优先级群组。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
<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形式返回。 |
| function unRegisterGroupCallBack(): Promise
<boolean>
; | 解除应用分组监听回调,以promise形式返回。 |
| function queryAppUsagePriorityGroup(bundleName? : string, callback: AsyncCallback
<
number
>
): void | 查询当前调用者应用或者指定应用的使用优先级群组。callback形式。 |
| function queryAppUsagePriorityGroup(bundleName? : string): Promise
<
number
>
; | 查询当前调用者应用或者指定应用的使用优先级群组。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形式返回。 |
| function unRegisterGroupCallBack(): Promise
>
boolean
>
; | 解除应用分组监听回调,以promise形式返回。 |
## 开发步骤
...
...
@@ -172,19 +174,19 @@ import stats from '@ohos.bundleState';
});
```
6.
查询(无参)当前调用者应用的使用优先级群组,config.json中不需要配置权限。
查询(有参)指定应用的使用优先级群组,config.json中需要配置权限:ohos.permission.BUNDLE_ACTIVE_INFO。
6.
查询(无参)当前调用者应用的使用优先级群组,config.json中不需要配置权限。
```js
import stats from '@ohos.bundleState'
//
无参异步方法
promise方式
// promise方式
stats.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);
});
//
无参异步方法
callback方式
// callback方式
stats.queryAppUsagePriorityGroup((err, res) => {
if (err) {
console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup callback failed. because: ' + err.code);
...
...
@@ -192,24 +194,8 @@ import stats from '@ohos.bundleState';
console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup callback succeeded. result: ' + JSON.stringify(res));
}
});
//有参异步promise方式
stats.queryAppUsagePriorityGroup(this.bundleName).then( res => {
console.log('BUNDLE_ACTIVE QueryPackageGroup promise succeeded. result: ' + JSON.stringify(res));
}).catch( err => {
console.log('BUNDLE_ACTIVE QueryPackageGroup promise failed. because: ' + err.code);
});
//有参异步方法callback方式
stats.queryAppUsagePriorityGroup(this.bundleName, (err, res) => {
if(err) {
console.log('BUNDLE_ACTIVE QueryPackageGroup callback failed. because: ' + err.code);
} else {
console.log('BUNDLE_ACTIVE QueryPackageGroup callback succeeded. result: ' + JSON.stringify(res));
}
});
```
7.
判断指定Bundle Name的应用当前是否是空闲状态,config.json中不需要配置权限。
```js
...
...
@@ -334,23 +320,61 @@ import stats from '@ohos.bundleState';
});
```
11.
查询(无参)当前调用者应用的使用优先级群组,config.json中不需要配置权限。查询(有参)指定应用的使用优先级群组,config.json中需要配置权限:ohos.permission.BUNDLE_ACTIVE_INFO。
```js
import stats from '@ohos.bundleState'
// 无参异步方法promise方式
stats.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);
});
// 无参异步方法callback方式
stats.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));
}
});
//有参异步promise方式
stats.queryAppUsagePriorityGroup(this.bundleName).then( res => {
console.log('BUNDLE_ACTIVE QueryPackageGroup promise succeeded. result: ' + JSON.stringify(res));
}).catch( err => {
console.log('BUNDLE_ACTIVE QueryPackageGroup promise failed. because: ' + err.code);
});
//有参异步方法callback方式
stats.queryAppUsagePriorityGroup(this.bundleName, (err, res) => {
if(err) {
console.log('BUNDLE_ACTIVE QueryPackageGroup callback failed. because: ' + err.code);
} else {
console.log('BUNDLE_ACTIVE QueryPackageGroup callback succeeded. result: ' + JSON.stringify(res));
}
});
```
11.
给应用名是bundleName的应用分组设置成newGroup,返回设置结果是否成功
```javascript
import stats from '@ohos.bundleState'
//异步方法promise
stats.setBundleGroup(this.bundleName, this.newGroup).then(
res
=> {
console.log('BUNDLE_ACTIVE SetBundleGroup promise succeeded.
result: ' + JSON.stringify(res)
);
stats.setBundleGroup(this.bundleName, this.newGroup).then(
()
=> {
console.log('BUNDLE_ACTIVE SetBundleGroup promise succeeded.
'
);
}).catch( err => {
console.log('BUNDLE_ACTIVE SetBundleGroup promise failed. because: ' + err.code);
});
//异步方法callback
stats.setBundleGroup(this.bundleName, this.newGroup, (err
, res
) => {
stats.setBundleGroup(this.bundleName, this.newGroup, (err) => {
if(err) {
console.log('BUNDLE_ACTIVE SetBundleGroup callback failed. because: ' + err.code);
} else {
console.log('BUNDLE_ACTIVE SetBundleGroup callback succeeded.
result: ' + JSON.stringify(res)
);
console.log('BUNDLE_ACTIVE SetBundleGroup callback succeeded.
'
);
}
});
```
...
...
@@ -369,8 +393,8 @@ import stats from '@ohos.bundleState';
console.log('BUNDLE_ACTIVE onBundleGroupChanged RegisterGroupCallBack result userId is : ' + res.userId);
console.log('BUNDLE_ACTIVE onBundleGroupChanged RegisterGroupCallBack result bundleName is : ' + res.bundleName);
};
stats.registerGroupCallBack(onBundleGroupChanged).then(
res
=> {
console.log('BUNDLE_ACTIVE RegisterGroupCallBack promise succeeded.
result1: ' + JSON.stringify(res)
);
stats.registerGroupCallBack(onBundleGroupChanged).then(
()
=> {
console.log('BUNDLE_ACTIVE RegisterGroupCallBack promise succeeded.
'
);
}).catch( err => {
console.log('BUNDLE_ACTIVE RegisterGroupCallBack promise failed. because: ' + err.code);
});
...
...
@@ -383,34 +407,32 @@ import stats from '@ohos.bundleState';
console.log('BUNDLE_ACTIVE onBundleGroupChanged RegisterGroupCallBack result‘s userId is : ' + res.userId);
console.log('BUNDLE_ACTIVE onBundleGroupChanged RegisterGroupCallBack result‘s bundleName is : ' + res.bundleName);
};
stats.registerGroupCallBack(onBundleGroupChanged, (err
,res
)=>{
stats.registerGroupCallBack(onBundleGroupChanged, (err)=>{
if(err) {
console.log('BUNDLE_ACTIVE RegisterGroupCallBack callback failed, because: ' + err.code);
} else {
console.log('BUNDLE_ACTIVE RegisterGroupCallBack callback success.');
console.log('BUNDLE_ACTIVE RegisterGroupCallBack result is : ' + JSON.stringify(res));
}
});
```
13.
解除应用分组监听回调
```javascript
import stats from '@ohos.bundleState'
//promise
stats.unRegisterGroupCallBack().then(
res
=> {
console.log('BUNDLE_ACTIVE UnRegisterGroupCallBack promise succeeded.
result: ' + JSON.stringify(res)
);
stats.unRegisterGroupCallBack().then(
()
=> {
console.log('BUNDLE_ACTIVE UnRegisterGroupCallBack promise succeeded.
'
);
}).catch( err => {
console.log('BUNDLE_ACTIVE UnRegisterGroupCallBack promise failed. because: ' + err.code);
});
//callback
stats.unRegisterGroupCallBack((err
,res
)=>{
stats.unRegisterGroupCallBack((err)=>{
if(err) {
console.log('BUNDLE_ACTIVE UnRegisterGroupCallBack callback failed, because: ' + err.code);
} else {
console.log('BUNDLE_ACTIVE UnRegisterGroupCallBack callback success.');
console.log('BUNDLE_ACTIVE UnRegisterGroupCallBack result is : ' + JSON.stringify(res));
}
});
```
...
...
zh-cn/application-dev/device-usage-statistics/device-usage-statistics-overview.md
浏览文件 @
b119db8e
...
...
@@ -16,11 +16,12 @@
2.
根据起止时间查询应用的使用时长。
3.
根据起止时间查询当前应用的事件集合。
4.
根据interval(日、周、月、年)类型和起止时间查询应用的使用时长。
5.
查询调用者应用
或指定应用
的优先级群组。
5.
查询调用者应用的优先级群组。
6.
判断指定应用当前是否是空闲状态。
7.
查询FA使用记录。返回数量最大不超过maxNum设置的值,FA使用记录由近及远排序,maxNum最大为1000,若不填写maxNum参数,则maxNum默认为1000。
8.
根据起止时间查询应用通知次数。
9.
根据起止时间查询系统事件(休眠、唤醒、解锁、锁屏)统计信息。
9.
查询调用者应用或指定应用的优先级群组。
-
设置接口
...
...
@@ -35,5 +36,5 @@
1.
解除注册应用分组变化回调监听
### 设备使用信息统计使用权限
-
设备使用信息统计的queryBundleActiveStates、queryBundleStateInfos、queryBundleStateInfoByInterval、queryBundleActiveEventStates、queryAppNotificationNumber、queryAppUsagePriorityGroup(有参)、setBundleGroup、registerGroupCallBack、unRegisterGroupCallBack接口为系统api,调用前需要申请ohos.permission.BUNDLE_ACTIVE_INFO权限。
-
设备使用信息统计的queryCurrentBundleActiveStates、queryAppUsagePriorityGroup(无参)、isIdleState接口为三方api,调用时不需要申请权限。
\ No newline at end of file
-
设备使用信息统计的queryBundleActiveStates、queryBundleStateInfos、queryBundleStateInfoByInterval、queryBundleActiveEventStates、queryAppNotificationNumber、queryAppUsagePriorityGroup(bundleName?)、setBundleGroup、registerGroupCallBack、unRegisterGroupCallBack接口为系统api,调用前需要申请ohos.permission.BUNDLE_ACTIVE_INFO权限。
-
设备使用信息统计的queryCurrentBundleActiveStates、queryAppUsagePriorityGroup()、isIdleState接口为三方api,调用时不需要申请权限。
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-deviceUsageStatistics.md
浏览文件 @
b119db8e
...
...
@@ -69,20 +69,12 @@ isIdleState(bundleName: string): Promise<boolean>
## bundleState.queryAppUsagePriorityGroup
queryAppUsagePriorityGroup(bundleName? : string): Promise
<number>
可选参数。设置该参数时查询指定bundleName对应应用的分组。无参数时查询当前应用的分组。使用Promise形式返回其应用分组。
queryAppUsagePriorityGroup(): Promise
<number>
**需要权限**
:ohos.permission.BUNDLE_ACTIVE_INFO
查询当前应用的优先级分组。使用Promise形式返回其应用分组。
**系统能力**
:SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| ----------------------- | ------ | ---- | ------------------------------------------------------------ |
| bundleName
<sup>
9+
</sup>
| string | 否 | 可选参数。设置该参数时查询指定bundleName对应应用的分组。无参数时查询当前应用的分组。 |
**返回值**
:
| 类型 | 说明 |
...
...
@@ -92,13 +84,6 @@ queryAppUsagePriorityGroup(bundleName? : string): Promise<number>
**示例**
:
```
javascript
//有bundleName的promise
bundleState
.
queryAppUsagePriorityGroup
(
this
.
bundleName
).
then
(
res
=>
{
console
.
log
(
'
BUNDLE_ACTIVE QueryPackageGroup promise succeeded. result:
'
+
JSON
.
stringify
(
res
));
}).
catch
(
err
=>
{
console
.
log
(
'
BUNDLE_ACTIVE QueryPackageGroup promise failed. because:
'
+
err
.
code
);
});
//无bundleName的promise
bundleState
.
queryAppUsagePriorityGroup
().
then
(
res
=>
{
console
.
log
(
'
BUNDLE_ACTIVE QueryPackageGroup promise succeeded. result:
'
+
JSON
.
stringify
(
res
));
}).
catch
(
err
=>
{
...
...
@@ -108,20 +93,17 @@ bundleState.queryAppUsagePriorityGroup().then( res => {
## bundleState.queryAppUsagePriorityGroup
queryAppUsagePriorityGroup(
bundleName? : string,
callback: AsyncCallback
<number>
): void
queryAppUsagePriorityGroup(callback: AsyncCallback
<number>
): void
可选参数。设置该参数时查询指定bundleName对应应用的分组。无参数时查询当前应用的分组。使用callback形式返回其应用分组。
**需要权限**
:ohos.permission.BUNDLE_ACTIVE_INFO
查询当前应用的优先级分组。使用callback形式返回其应用分组。
**系统能力**
:SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| ----------------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| bundleName
<sup>
9+
</sup>
| string | 否 | 可选参数。设置该参数时查询指定bundleName对应应用的分组。无参数时查询当前应用的分组。 |
| callback | AsyncCallback
<
Array
<
[BundleActiveModuleInfo](#bundleactivemoduleinfo9)
>>
| 是 | 指定的CallBack回调方法。返回查询的应用分组。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------- | ---- | -------------------------------------------- |
| callback | AsyncCallback
<number>
| 是 | 指定的CallBack回调方法。返回查询的应用分组。 |
**示例**
:
...
...
@@ -523,9 +505,86 @@ getRecentlyUsedModules(maxNum?: number, callback: AsyncCallback<Array<Bund
});
```
## bundleState.queryAppUsagePriorityGroup<sup>9+</sup>
queryAppUsagePriorityGroup(bundleName? : string): Promise
<number>
可选参数。设置该参数时查询指定bundleName对应应用的分组。无参数时查询当前应用的分组。使用Promise形式返回其应用分组。
**需要权限**
:ohos.permission.BUNDLE_ACTIVE_INFO
**系统能力**
:SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | ------------------------------------------------------------ |
| bundleName | string | 否 | 可选参数。设置该参数时查询指定bundleName对应应用的分组。无参数时查询当前应用的分组。 |
**返回值**
:
| 类型 | 说明 |
| --------------- | ----------------------------------------------- |
| Promise
<number>
| 指定的Promise回调方法。返回查询的应用分组结果。 |
**示例**
:
```
javascript
//有bundleName的promise
bundleState
.
queryAppUsagePriorityGroup
(
this
.
bundleName
).
then
(
res
=>
{
console
.
log
(
'
BUNDLE_ACTIVE QueryPackageGroup promise succeeded. result:
'
+
JSON
.
stringify
(
res
));
}).
catch
(
err
=>
{
console
.
log
(
'
BUNDLE_ACTIVE QueryPackageGroup promise failed. because:
'
+
err
.
code
);
});
//无bundleName的promise
bundleState
.
queryAppUsagePriorityGroup
().
then
(
res
=>
{
console
.
log
(
'
BUNDLE_ACTIVE QueryPackageGroup promise succeeded. result:
'
+
JSON
.
stringify
(
res
));
}).
catch
(
err
=>
{
console
.
log
(
'
BUNDLE_ACTIVE QueryPackageGroup promise failed. because:
'
+
err
.
code
);
});
```
## bundleState.queryAppUsagePriorityGroup<sup>9+</sup>
queryAppUsagePriorityGroup(bundleName? : string, callback: AsyncCallback
<number>
): void
可选参数。设置该参数时查询指定bundleName对应应用的分组。无参数时查询当前应用的分组。使用callback形式返回其应用分组。
**需要权限**
:ohos.permission.BUNDLE_ACTIVE_INFO
**系统能力**
:SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | --------------------- | ---- | ------------------------------------------------------------ |
| bundleName | string | 否 | 可选参数。设置该参数时查询指定bundleName对应应用的分组。无参数时查询当前应用的分组。 |
| callback | AsyncCallback
<number>
| 是 | 指定的CallBack回调方法。返回查询的应用分组。 |
**示例**
:
```
javascript
//有bundleName的callback
bundleState
.
queryAppUsagePriorityGroup
(
this
.
bundleName
,
(
err
,
res
)
=>
{
if
(
err
)
{
console
.
log
(
'
BUNDLE_ACTIVE QueryPackageGroup callback failed. because:
'
+
err
.
code
);
}
else
{
console
.
log
(
'
BUNDLE_ACTIVE QueryPackageGroup callback succeeded. result:
'
+
JSON
.
stringify
(
res
));
}
});
//无bundleName的callback
bundleState
.
queryAppUsagePriorityGroup
((
err
,
res
)
=>
{
if
(
err
)
{
console
.
log
(
'
BUNDLE_ACTIVE QueryPackageGroup callback failed. because:
'
+
err
.
code
);
}
else
{
console
.
log
(
'
BUNDLE_ACTIVE QueryPackageGroup callback succeeded. result:
'
+
JSON
.
stringify
(
res
));
}
});
```
## bundleState.setBundleGroup<sup>9+</sup>
setBundleGroup(bundleName: string, newGroup: GroupType): Promise
<
boolean
>
setBundleGroup(bundleName: string, newGroup: GroupType): Promise
<
void
>
将指定的bundleName的应用的分组设置为newGroup,使用Promise形式返回设置是否成功。
...
...
@@ -542,9 +601,9 @@ setBundleGroup(bundleName: string, newGroup: GroupType): Promise<boolean>
**返回值**
:
| 类型
| 说明 |
| -------------
---
| ------------------------------------------- |
| Promise
<
boolean
>
| 指定的Promise回调方法。返回本次设置是否成功 |
| 类型 | 说明 |
| ------------- | ------------------------------------------- |
| Promise
<
void
>
| 指定的Promise回调方法。返回本次设置是否成功 |
**示例**
:
...
...
@@ -552,8 +611,8 @@ setBundleGroup(bundleName: string, newGroup: GroupType): Promise<boolean>
this
.
bundleName
=
"
com.example.deviceUsageStatistics
"
;
this
.
newGroup
=
stats
.
GroupType
.
ACTIVE_GROUP_DAILY
;
bundleState
.
setBundleGroup
(
this
.
bundleName
,
this
.
newGroup
).
then
(
res
=>
{
console
.
log
(
'
BUNDLE_ACTIVE SetBundleGroup promise succeeded.
result:
'
+
JSON
.
stringify
(
res
)
);
bundleState
.
setBundleGroup
(
this
.
bundleName
,
this
.
newGroup
).
then
(
()
=>
{
console
.
log
(
'
BUNDLE_ACTIVE SetBundleGroup promise succeeded.
'
);
}).
catch
(
err
=>
{
console
.
log
(
'
BUNDLE_ACTIVE SetBundleGroup promise failed. because:
'
+
err
.
code
);
});
...
...
@@ -561,7 +620,7 @@ bundleState.setBundleGroup(this.bundleName, this.newGroup).then( res => {
## bundleState.setBundleGroup<sup>9+</sup>
setBundleGroup(bundleName: string, newGroup: GroupType, callback: AsyncCallback
<
boolean
>
): void
setBundleGroup(bundleName: string, newGroup: GroupType, callback: AsyncCallback
<
void
>
): void
将指定的bundleName的应用的分组设置为newGroup,使用CallBack形式返回设置是否成功。
...
...
@@ -571,11 +630,11 @@ setBundleGroup(bundleName: string, newGroup: GroupType, callback: AsyncCallback<
**参数**
:
| 参数名 | 类型
| 必填 | 说明 |
| ---------- | -------------------
---
| ---- | ------------------------------------------ |
| bundleName | string
| 是 | 应用名称 |
| newGroup | GroupType
| 是 | 应用分组 |
| callback | AsyncCallback
<
boolean
>
| 是 | 指定的CallBack回调方法。返回设置是否成功。 |
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------------------- | ---- | ------------------------------------------ |
| bundleName | string | 是 | 应用名称 |
| newGroup | GroupType | 是 | 应用分组 |
| callback | AsyncCallback
<
void
>
| 是 | 指定的CallBack回调方法。返回设置是否成功。 |
**示例**
:
...
...
@@ -583,18 +642,18 @@ setBundleGroup(bundleName: string, newGroup: GroupType, callback: AsyncCallback<
this
.
bundleName
=
"
com.example.deviceUsageStatistics
"
;
this
.
newGroup
=
stats
.
GroupType
.
ACTIVE_GROUP_DAILY
;
bundleState
.
setBundleGroup
(
this
.
bundleName
,
this
.
newGroup
,
(
err
,
res
)
=>
{
bundleState
.
setBundleGroup
(
this
.
bundleName
,
this
.
newGroup
,
(
err
)
=>
{
if
(
err
)
{
console
.
log
(
'
BUNDLE_ACTIVE SetBundleGroup callback failed. because:
'
+
err
.
code
);
}
else
{
console
.
log
(
'
BUNDLE_ACTIVE SetBundleGroup callback succeeded.
result:
'
+
JSON
.
stringify
(
res
)
);
console
.
log
(
'
BUNDLE_ACTIVE SetBundleGroup callback succeeded.
'
);
}
});
```
## bundleState.registerGroupCallBack<sup>9+</sup>
registerGroupCallBack(callback: Callback
<BundleActiveGroupCallbackInfo>
): Promise
<
boolean
>
registerGroupCallBack(callback: Callback
<BundleActiveGroupCallbackInfo>
): Promise
<
void
>
应用分组变化注册,待用户名下的某个应用分组发生变化时,通过callback形式向所有已注册的应用返回BundleActiveGroupCallbackInfo。使用Promise形式返回注册是否成功。
...
...
@@ -610,9 +669,9 @@ registerGroupCallBack(callback: Callback<BundleActiveGroupCallbackInfo>): Promis
**返回值**
:
| 类型
| 说明 |
| -------------
---
| --------------------------------------- |
| Promise
<
boolean
>
| 指定的Promise回调方法。返回注册是否成功 |
| 类型 | 说明 |
| ------------- | --------------------------------------- |
| Promise
<
void
>
| 指定的Promise回调方法。返回注册是否成功 |
**示例**
:
...
...
@@ -625,8 +684,8 @@ let onBundleGroupChanged = (err,res) =>{
console
.
log
(
'
BUNDLE_ACTIVE onBundleGroupChanged RegisterGroupCallBack result userId is :
'
+
res
.
userId
);
console
.
log
(
'
BUNDLE_ACTIVE onBundleGroupChanged RegisterGroupCallBack result bundleName is :
'
+
res
.
bundleName
);
};
bundleState
.
registerGroupCallBack
(
onBundleGroupChanged
).
then
(
res
=>
{
console
.
log
(
'
BUNDLE_ACTIVE RegisterGroupCallBack promise succeeded.
result1:
'
+
JSON
.
stringify
(
res
)
);
bundleState
.
registerGroupCallBack
(
onBundleGroupChanged
).
then
(
()
=>
{
console
.
log
(
'
BUNDLE_ACTIVE RegisterGroupCallBack promise succeeded.
'
);
}).
catch
(
err
=>
{
console
.
log
(
'
BUNDLE_ACTIVE RegisterGroupCallBack promise failed. because:
'
+
err
.
code
);
});
...
...
@@ -634,7 +693,7 @@ bundleState.registerGroupCallBack(onBundleGroupChanged).then( res => {
## bundleState.registerGroupCallBack<sup>9+</sup>
registerGroupCallBack(callback: Callback
<BundleActiveGroupCallbackInfo>
, callback: AsyncCallback
<
boolean
>
): void
registerGroupCallBack(callback: Callback
<BundleActiveGroupCallbackInfo>
, callback: AsyncCallback
<
void
>
): void
应用分组变化注册,待用户名下的某个应用分组发生变化时,通过callback形式向所有已注册的应用返回BundleActiveGroupCallbackInfo。使用异步callback形式返回注册是否成功。
...
...
@@ -647,7 +706,7 @@ registerGroupCallBack(callback: Callback<BundleActiveGroupCallbackInfo>, callbac
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------------------- | ---- | -------------------------- |
| callback | Callback
<BundleActiveGroupCallbackInfo>
| 是 | 应用分组变化的回调函数 |
| callback | AsyncCallback
<
boolean>
| 是 | 注册是否成功的异步回调函数 |
| callback | AsyncCallback
<
void>
| 是 | 注册是否成功的异步回调函数 |
**示例**
:
...
...
@@ -660,19 +719,18 @@ let onBundleGroupChanged = (err,res) =>{
console
.
log
(
'
BUNDLE_ACTIVE onBundleGroupChanged RegisterGroupCallBack result‘s userId is :
'
+
res
.
userId
);
console
.
log
(
'
BUNDLE_ACTIVE onBundleGroupChanged RegisterGroupCallBack result‘s bundleName is :
'
+
res
.
bundleName
);
};
bundleState
.
registerGroupCallBack
(
onBundleGroupChanged
,
(
err
,
res
)
=>
{
bundleState
.
registerGroupCallBack
(
onBundleGroupChanged
,
(
err
)
=>
{
if
(
err
)
{
console
.
log
(
'
BUNDLE_ACTIVE RegisterGroupCallBack callback failed, because:
'
+
err
.
code
);
}
else
{
console
.
log
(
'
BUNDLE_ACTIVE RegisterGroupCallBack callback success.
'
);
console
.
log
(
'
BUNDLE_ACTIVE RegisterGroupCallBack result is :
'
+
JSON
.
stringify
(
res
));
}
});
```
## bundleState.unRegisterGroupCallBack<sup>9+</sup>
unRegisterGroupCallBack(): Promise
<
boolean
>
unRegisterGroupCallBack(): Promise
<
void
>
应用分组变化解注册,将之前注册的解除注册。使用Promise形式返回注册是否成功。
...
...
@@ -684,15 +742,15 @@ unRegisterGroupCallBack(): Promise<boolean>
**返回值**
:
| 类型
| 说明 |
| -------------
---
| ----------------------------------------- |
| Promise
<
boolean
>
| 指定的Promise回调方法。返回解注册是否成功 |
| 类型 | 说明 |
| ------------- | ----------------------------------------- |
| Promise
<
void
>
| 指定的Promise回调方法。返回解注册是否成功 |
**示例**
:
```
javascript
bundleState
.
unRegisterGroupCallBack
().
then
(
res
=>
{
console
.
log
(
'
BUNDLE_ACTIVE UnRegisterGroupCallBack promise succeeded.
result:
'
+
JSON
.
stringify
(
res
)
);
bundleState
.
unRegisterGroupCallBack
().
then
(
()
=>
{
console
.
log
(
'
BUNDLE_ACTIVE UnRegisterGroupCallBack promise succeeded.
'
);
}).
catch
(
err
=>
{
console
.
log
(
'
BUNDLE_ACTIVE UnRegisterGroupCallBack promise failed. because:
'
+
err
.
code
);
});
...
...
@@ -700,7 +758,7 @@ bundleState.unRegisterGroupCallBack().then( res => {
## bundleState.unRegisterGroupCallBack<sup>9+</sup>
unRegisterGroupCallBack(callback: AsyncCallback
<
boolean
>
): void;
unRegisterGroupCallBack(callback: AsyncCallback
<
void
>
): void;
应用分组变化解注册,将之前注册的解除注册。使用异步callback形式返回注册是否成功。
...
...
@@ -710,19 +768,18 @@ unRegisterGroupCallBack(callback: AsyncCallback<boolean>): void;
**参数**
:
| 参数名 | 类型
| 必填 | 说明 |
| -------- | -------------------
---
| ---- | ---------------------------- |
| callback | AsyncCallback
<
boolean
>
| 是 | 解注册是否成功的异步回调函数 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------- | ---- | ---------------------------- |
| callback | AsyncCallback
<
void
>
| 是 | 解注册是否成功的异步回调函数 |
**示例**
:
```
javascript
bundleState
.
unRegisterGroupCallBack
((
err
,
res
)
=>
{
bundleState
.
unRegisterGroupCallBack
((
err
)
=>
{
if
(
err
)
{
console
.
log
(
'
BUNDLE_ACTIVE UnRegisterGroupCallBack callback failed, because:
'
+
err
.
code
);
}
else
{
console
.
log
(
'
BUNDLE_ACTIVE UnRegisterGroupCallBack callback success.
'
);
console
.
log
(
'
BUNDLE_ACTIVE UnRegisterGroupCallBack result is :
'
+
JSON
.
stringify
(
res
));
}
});
```
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录