Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
96158a76
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看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
96158a76
编写于
6月 06, 2022
作者:
O
openharmony_ci
提交者:
Gitee
6月 06, 2022
浏览文件
操作
浏览文件
下载
差异文件
!4960 设备应用统计资料修改
Merge pull request !4960 from wangyuanchao/master
上级
f403cb41
693e1a94
变更
3
显示空白变更内容
内联
并排
Showing
3 changed file
with
194 addition
and
1 deletion
+194
-1
zh-cn/application-dev/device-usage-statistics/device-usage-statistics-dev-guide.md
...ice-usage-statistics/device-usage-statistics-dev-guide.md
+49
-0
zh-cn/application-dev/device-usage-statistics/device-usage-statistics-overview.md
...vice-usage-statistics/device-usage-statistics-overview.md
+3
-1
zh-cn/application-dev/reference/apis/js-apis-deviceUsageStatistics.md
...ation-dev/reference/apis/js-apis-deviceUsageStatistics.md
+142
-0
未找到文件。
zh-cn/application-dev/device-usage-statistics/device-usage-statistics-dev-guide.md
浏览文件 @
96158a76
...
@@ -22,6 +22,8 @@ import stats from '@ohos.bundleState';
...
@@ -22,6 +22,8 @@ import stats from '@ohos.bundleState';
| function queryAppUsagePriorityGroup(callback: AsyncCallback
<
number
>
): void | 查询(返回)当前调用者应用的使用优先级群组。 |
| function queryAppUsagePriorityGroup(callback: AsyncCallback
<
number
>
): void | 查询(返回)当前调用者应用的使用优先级群组。 |
| function isIdleState(bundleName: string, callback: AsyncCallback
<
boolean
>
): void | 判断指定Bundle Name的应用当前是否是空闲状态。 |
| function isIdleState(bundleName: string, callback: AsyncCallback
<
boolean
>
): void | 判断指定Bundle Name的应用当前是否是空闲状态。 |
| function getRecentlyUsedModules(maxNum: number, callback: AsyncCallback
<
BundleActiveModuleInfo
>
): void | 根据maxNum,查询FA使用记录,返回不超过maxNum条FA使用记录。 |
| 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 | 通过指定起始和结束时间查询系统事件(休眠、唤醒、解锁、锁屏)统计信息。 |
## 开发步骤
## 开发步骤
...
@@ -261,3 +263,50 @@ import stats from '@ohos.bundleState';
...
@@ -261,3 +263,50 @@ import stats from '@ohos.bundleState';
});
});
```
```
9.
通过指定起始和结束时间查询所有应用的通知次数,config.json中需要配置权限:ohos.permission.BUNDLE_ACTIVE_INFO。
```js
import stats from '@ohos.bundleState'
// 异步方法promise方式
stats.queryAppNotificationNumber(0, 20000000000000).then( res => {
console.log('BUNDLE_ACTIVE queryAppNotificationNumber promise success.');
console.log('BUNDLE_ACTIVE queryAppNotificationNumber promise result ' + JSON.stringify(res));
}).catch( err => {
console.log('BUNDLE_ACTIVE queryAppNotificationNumber promise failed, because: ' + err.code);
});
// 异步方法callback方式
stats.queryAppNotificationNumber(0, 20000000000000, (err, res) => {
if (err) {
console.log('BUNDLE_ACTIVE queryAppNotificationNumber callback failed, because: ' + err.code);
} else {
console.log('BUNDLE_ACTIVE queryAppNotificationNumber callback success.');
console.log('BUNDLE_ACTIVE queryAppNotificationNumber callback result ' + JSON.stringify(res));
}
});
```
10.
通过指定起始和结束时间查询系统事件(休眠、唤醒、解锁、锁屏)统计信息,config.json中需要配置权限:ohos.permission.BUNDLE_ACTIVE_INFO。
```js
import stats from '@ohos.bundleState'
// 异步方法promise方式
stats.queryBundleActiveEventStates(0, 20000000000000).then( res => {
console.log('BUNDLE_ACTIVE queryBundleActiveEventStates promise success.');
console.log('BUNDLE_ACTIVE queryBundleActiveEventStates promise result ' + JSON.stringify(res));
}).catch( err => {
console.log('BUNDLE_ACTIVE queryBundleActiveEventStates promise failed, because: ' + err.code);
});
// 异步方法callback方式
stats.queryBundleActiveEventStates(0, 20000000000000, (err, res) => {
if (err) {
console.log('BUNDLE_ACTIVE queryBundleActiveEventStates callback failed, because: ' + err.code);
} else {
console.log('BUNDLE_ACTIVE queryBundleActiveEventStates callback success.');
console.log('BUNDLE_ACTIVE queryBundleActiveEventStates callback result ' + JSON.stringify(res));
}
});
```
\ No newline at end of file
zh-cn/application-dev/device-usage-statistics/device-usage-statistics-overview.md
浏览文件 @
96158a76
...
@@ -19,7 +19,9 @@
...
@@ -19,7 +19,9 @@
5.
查询调用者应用的优先级群组。
5.
查询调用者应用的优先级群组。
6.
判断指定应用当前是否是空闲状态。
6.
判断指定应用当前是否是空闲状态。
7.
查询FA使用记录。返回数量最大不超过maxNum设置的值,FA使用记录由近及远排序,maxNum最大为1000,若不填写maxNum参数,则maxNum默认为1000。
7.
查询FA使用记录。返回数量最大不超过maxNum设置的值,FA使用记录由近及远排序,maxNum最大为1000,若不填写maxNum参数,则maxNum默认为1000。
8.
根据起止时间查询应用通知次数。
9.
根据起止时间查询系统事件(休眠、唤醒、解锁、锁屏)统计信息。
### 设备使用信息统计使用权限
### 设备使用信息统计使用权限
-
设备使用信息统计的queryBundleActiveStates、queryBundleStateInfos、queryBundleStateInfoByInterval接口为系统api,调用前需要申请ohos.permission.BUNDLE_ACTIVE_INFO权限。
-
设备使用信息统计的queryBundleActiveStates、queryBundleStateInfos、queryBundleStateInfoByInterval
、queryBundleActiveEventStates、queryAppNotificationNumber
接口为系统api,调用前需要申请ohos.permission.BUNDLE_ACTIVE_INFO权限。
-
设备使用信息统计的queryCurrentBundleActiveStates、queryAppUsagePriorityGroup、isIdleState接口为三方api,调用时不需要申请权限。
-
设备使用信息统计的queryCurrentBundleActiveStates、queryAppUsagePriorityGroup、isIdleState接口为三方api,调用时不需要申请权限。
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-deviceUsageStatistics.md
浏览文件 @
96158a76
...
@@ -496,6 +496,136 @@ getRecentlyUsedModules(maxNum?: number, callback: AsyncCallback<Array<Bund
...
@@ -496,6 +496,136 @@ getRecentlyUsedModules(maxNum?: number, callback: AsyncCallback<Array<Bund
});
});
```
```
## bundleState.queryBundleActiveEventStates<sup>9+</sup>
queryBundleActiveEventStates(begin: number, end: number): Promise
<
Array
<
BundleActiveEventState
>>
通过指定起始和结束时间查询系统事件(休眠、唤醒、解锁、锁屏)统计信息,使用Promise形式返回。
**需要权限**
:ohos.permission.BUNDLE_ACTIVE_INFO
**系统能力**
:SystemCapability.ResourceSchedule.UsageStatistics.App
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| begin | number | 是 | 起始时间。|
| end | number | 是 | 结束时间。|
**返回值**
:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
Array
<
[BundleActiveEventState](#bundleactiveeventstate9)
>>
| 指定的Promise回调方法。返回指定起始和结束时间查询系统事件(休眠、唤醒、解锁、锁屏)统计信息。|
**示例**
:
```
js
bundleState
.
queryBundleActiveEventStates
(
0
,
20000000000000
).
then
(
res
=>
{
console
.
log
(
'
BUNDLE_ACTIVE queryBundleActiveEventStates promise success.
'
);
console
.
log
(
'
BUNDLE_ACTIVE queryBundleActiveEventStates promise result
'
+
JSON
.
stringify
(
res
));
}).
catch
(
err
=>
{
console
.
log
(
'
BUNDLE_ACTIVE queryBundleActiveEventStates promise failed, because:
'
+
err
.
code
);
});
```
## bundleState.queryBundleActiveEventStates<sup>9+</sup>
queryBundleActiveEventStates(begin: number, end: number, callback: AsyncCallback
<
Array
<
BundleActiveEventState
>>
): void
通过指定起始和结束时间查询系统事件(休眠、唤醒、解锁、锁屏)统计信息,使用Callback形式返回。
**需要权限**
:ohos.permission.BUNDLE_ACTIVE_INFO
**系统能力**
:SystemCapability.ResourceSchedule.UsageStatistics.App
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| begin | number | 是 | 起始时间。|
| end | number | 是 | 结束时间。|
| callback | AsyncCallback
<
Array
<
[BundleActiveEventState](#bundleactiveeventstate9)
>>
| 是 | 指定的callback回调方法。返回指定起始和结束时间查询系统事件(休眠、唤醒、解锁、锁屏)统计信息。|
**示例**
:
```
js
bundleState
.
queryBundleActiveEventStates
(
0
,
20000000000000
,
(
err
,
res
)
=>
{
if
(
err
)
{
console
.
log
(
'
BUNDLE_ACTIVE queryBundleActiveEventStates callback failed, because:
'
+
err
.
code
);
}
else
{
console
.
log
(
'
BUNDLE_ACTIVE queryBundleActiveEventStates callback success.
'
);
console
.
log
(
'
BUNDLE_ACTIVE queryBundleActiveEventStates callback result
'
+
JSON
.
stringify
(
res
));
}
});
```
## bundleState.queryAppNotificationNumber<sup>9+</sup>
queryAppNotificationNumber(begin: number, end: number): Promise
<
Array
<
BundleActiveEventState
>>
通过指定起始和结束时间查询所有应用的通知次数信息,使用Promise形式返回。
**需要权限**
:ohos.permission.BUNDLE_ACTIVE_INFO
**系统能力**
:SystemCapability.ResourceSchedule.UsageStatistics.App
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| begin | number | 是 | 起始时间。|
| end | number | 是 | 结束时间。|
**返回值**
:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
Array
<
[BundleActiveEventState](#bundleactiveeventstate9)
>>
| 指定的Promise回调方法。返回指定起始和结束时间查询所有应用的通知次数信息。|
**示例**
:
```
js
bundleState
.
queryAppNotificationNumber
(
0
,
20000000000000
).
then
(
res
=>
{
console
.
log
(
'
BUNDLE_ACTIVE queryAppNotificationNumber promise success.
'
);
console
.
log
(
'
BUNDLE_ACTIVE queryAppNotificationNumber promise result
'
+
JSON
.
stringify
(
res
));
}).
catch
(
err
=>
{
console
.
log
(
'
BUNDLE_ACTIVE queryAppNotificationNumber promise failed, because:
'
+
err
.
code
);
});
```
## bundleState.queryAppNotificationNumber<sup>9+</sup>
queryAppNotificationNumber(begin: number, end: number, callback: AsyncCallback
<
Array
<
BundleActiveEventState
>>
): void
通过指定起始和结束时间查询所有应用的通知次数信息,使用Callback形式返回。
**需要权限**
:ohos.permission.BUNDLE_ACTIVE_INFO
**系统能力**
:SystemCapability.ResourceSchedule.UsageStatistics.App
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| begin | number | 是 | 起始时间。|
| end | number | 是 | 结束时间。|
| callback | AsyncCallback
<
Array
<
[BundleActiveEventState](#bundleactiveeventstate9)
>>
| 是 | 指定的callback回调方法。返回通过指定起始和结束时间查询所有应用的通知次数信息。|
**示例**
:
```
js
bundleState
.
queryAppNotificationNumber
(
0
,
20000000000000
,
(
err
,
res
)
=>
{
if
(
err
)
{
console
.
log
(
'
BUNDLE_ACTIVE queryAppNotificationNumberCallBack callback failed, because:
'
+
err
.
code
);
}
else
{
console
.
log
(
'
BUNDLE_ACTIVE queryAppNotificationNumberCallBack callback success.
'
);
console
.
log
(
'
BUNDLE_ACTIVE queryAppNotificationNumberCallBack callback result
'
+
JSON
.
stringify
(
res
));
}
});
```
## BundleActiveModuleInfo<sup>9+</sup>
## BundleActiveModuleInfo<sup>9+</sup>
FA的使用信息的属性集合。
FA的使用信息的属性集合。
...
@@ -591,6 +721,18 @@ merge(toMerge: BundleStateInfo): void
...
@@ -591,6 +721,18 @@ merge(toMerge: BundleStateInfo): void
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
|
[
key: string]: BundleStateInfo | [key: string]: [BundleStateInfo
](
#bundlestateinfo
)
| 是 | 不同应用的使用时长统计信息。|
|
[
key: string]: BundleStateInfo | [key: string]: [BundleStateInfo
](
#bundlestateinfo
)
| 是 | 不同应用的使用时长统计信息。|
## BundleActiveEventState<sup>9+</sup>
提供通知、系统事件的统计信息。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.ResourceSchedule.UsageStatistics.App
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| name | string | 是 | 通知应用包名或者系统事件名。|
| eventId | number | 是 | 通知、系统事件类型。|
| count | number | 是 | 应用通知次数或者系统事件触发次数。|
## IntervalType
## IntervalType
提供应用使用时长的查询类型。
提供应用使用时长的查询类型。
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录