Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
ea40f2c9
D
Docs
项目概览
OpenHarmony
/
Docs
12 个月 前同步成功
通知
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,发现更多精彩内容 >>
提交
ea40f2c9
编写于
10月 25, 2022
作者:
Y
yupeng74@huawei.com
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
错误信息修改
Signed-off-by:
N
yupeng74@huawei.com
<
yupeng74@huawei.com
>
上级
3aaa08b1
变更
5
隐藏空白更改
内联
并排
Showing
5 changed file
with
58 addition
and
72 deletion
+58
-72
zh-cn/application-dev/device-usage-statistics/device-usage-statistics-dev-guide.md
...ice-usage-statistics/device-usage-statistics-dev-guide.md
+10
-20
zh-cn/application-dev/device-usage-statistics/device-usage-statistics-use-guide.md
...ice-usage-statistics/device-usage-statistics-use-guide.md
+17
-27
zh-cn/application-dev/reference/apis/js-apis-deviceUsageStatistics.md
...ation-dev/reference/apis/js-apis-deviceUsageStatistics.md
+15
-11
zh-cn/application-dev/reference/apis/js-apis-resourceschedule-deviceUsageStatistics.md
...ce/apis/js-apis-resourceschedule-deviceUsageStatistics.md
+13
-11
zh-cn/application-dev/reference/errorcodes/errcode-DeviceUsageStatistics.md
...dev/reference/errorcodes/errcode-DeviceUsageStatistics.md
+3
-3
未找到文件。
zh-cn/application-dev/device-usage-statistics/device-usage-statistics-dev-guide.md
浏览文件 @
ea40f2c9
# 设备使用信息统计
# 设备使用信息统计
(API7)
## 场景介绍
...
...
@@ -27,21 +27,11 @@ import stats from '@ohos.bundleState';
## 开发步骤
1.
在config.json文件中配置设备使用信息统计权限。
```json
"module": {
"package": "com.example.deviceUsageStatistics",
...,
"reqPermissions": [
{
"name": "ohos.permission.BUNDLE_ACTIVE_INFO"
}
]
}
```
1.
获取设备使用信息之前,需要检查是否已经配置请求相应的权限。
系统提供的设备使用信息统计的权限是ohos.permission.BUNDLE_ACTIVE_INFO
具体配置方式请参考
[
权限申请声明
](
../security/accesstoken-guidelines.md
)
2.
通过指定起始和结束时间查询所有应用的事件集合,
config.json中需要配置权限:ohos.permission.BUNDLE_ACTIVE_INFO
。
2.
通过指定起始和结束时间查询所有应用的事件集合,
需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限
。
```js
import stats from '@ohos.bundleState'
...
...
@@ -57,7 +47,7 @@ import stats from '@ohos.bundleState';
});
```
3.
通过指定起始和结束时间查询应用使用时长统计信息,
config.json中需要配置权限:ohos.permission.BUNDLE_ACTIVE_INFO
。
3.
通过指定起始和结束时间查询应用使用时长统计信息,
需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限
。
```js
import stats from '@ohos.bundleState'
...
...
@@ -75,7 +65,7 @@ import stats from '@ohos.bundleState';
});
```
4.
通过指定起始和结束时间查询当前应用的事件集合,
config.json中
不需要配置权限。
4.
通过指定起始和结束时间查询当前应用的事件集合,不需要配置权限。
```js
import stats from '@ohos.bundleState'
...
...
@@ -91,7 +81,7 @@ import stats from '@ohos.bundleState';
});
```
5.
通过指定时间段间隔(天、周、月、年)查询应用使用时长统计信息,
config.json中需要配置权限:ohos.permission.BUNDLE_ACTIVE_INFO
。
5.
通过指定时间段间隔(天、周、月、年)查询应用使用时长统计信息,
需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限
。
```js
import stats from '@ohos.bundleState'
...
...
@@ -108,7 +98,7 @@ import stats from '@ohos.bundleState';
```
6.
查询(无参)当前调用者应用的使用优先级群组,
config.json中
不需要配置权限。
6.
查询(无参)当前调用者应用的使用优先级群组,不需要配置权限。
```js
import stats from '@ohos.bundleState'
...
...
@@ -120,7 +110,7 @@ import stats from '@ohos.bundleState';
});
```
7.
判断指定Bundle Name的应用当前是否是空闲状态,
config.json中需要配置权限:ohos.permission.BUNDLE_ACTIVE_INFO
,三方应用只能查询自身的空闲状态。
7.
判断指定Bundle Name的应用当前是否是空闲状态,
需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限
,三方应用只能查询自身的空闲状态。
```js
import stats from '@ohos.bundleState'
...
...
zh-cn/application-dev/device-usage-statistics/device-usage-statistics-use-guide.md
浏览文件 @
ea40f2c9
# 设备使用信息统计
# 设备使用信息统计
(API9)
## 场景介绍
...
...
@@ -37,21 +37,11 @@ import usageStatistics from '@ohos.resourceschedule.usageStatistics';
## 开发步骤
1.
在config.json文件中配置设备使用信息统计权限。
1.
获取设备使用信息之前,需要检查是否已经配置请求相应的权限。
系统提供的设备使用信息统计的权限是ohos.permission.BUNDLE_ACTIVE_INFO
具体配置方式请参考
[
权限申请声明
](
../security/accesstoken-guidelines.md
)
```json
"module": {
"package": "com.example.deviceUsageStatistics",
...,
"reqPermissions": [
{
"name": "ohos.permission.BUNDLE_ACTIVE_INFO"
}
]
}
```
2.
通过指定起始和结束时间查询所有应用的事件集合,config.json中需要配置权限:ohos.permission.BUNDLE_ACTIVE_INFO。
2.
通过指定起始和结束时间查询所有应用的事件集合,需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限。
```js
import usageStatistics from '@ohos.resourceschedule.usageStatistics'
...
...
@@ -89,7 +79,7 @@ import usageStatistics from '@ohos.resourceschedule.usageStatistics';
}
```
3.
通过指定起始和结束时间查询应用使用时长统计信息,
config.json中需要配置权限:ohos.permission.BUNDLE_ACTIVE_INFO
。
3.
通过指定起始和结束时间查询应用使用时长统计信息,
需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限
。
```js
import usageStatistics from '@ohos.resourceschedule.usageStatistics'
...
...
@@ -131,7 +121,7 @@ import usageStatistics from '@ohos.resourceschedule.usageStatistics';
}
```
4.
通过指定起始和结束时间查询当前应用的事件集合,
config.json中
不需要配置权限。
4.
通过指定起始和结束时间查询当前应用的事件集合,不需要配置权限。
```js
import usageStatistics from '@ohos.resourceschedule.usageStatistics'
...
...
@@ -169,7 +159,7 @@ import usageStatistics from '@ohos.resourceschedule.usageStatistics';
}
```
5.
通过指定时间段间隔(天、周、月、年)查询应用使用时长统计信息,
config.json中需要配置权限:ohos.permission.BUNDLE_ACTIVE_INFO
。
5.
通过指定时间段间隔(天、周、月、年)查询应用使用时长统计信息,
需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限
。
```js
import usageStatistics from '@ohos.resourceschedule.usageStatistics'
...
...
@@ -207,7 +197,7 @@ import usageStatistics from '@ohos.resourceschedule.usageStatistics';
}
```
6.
查询(无参)当前调用者应用的使用优先级群组,
config.json中
不需要配置权限。
6.
查询(无参)当前调用者应用的使用优先级群组,不需要配置权限。
```js
import usageStatistics from '@ohos.resourceschedule.usageStatistics'
...
...
@@ -237,7 +227,7 @@ import usageStatistics from '@ohos.resourceschedule.usageStatistics';
}
```
7.
判断指定Bundle Name的应用当前是否是空闲状态,
config.json中
不需要配置权限,三方应用只能查询自身的空闲状态。
7.
判断指定Bundle Name的应用当前是否是空闲状态,不需要配置权限,三方应用只能查询自身的空闲状态。
```js
import usageStatistics from '@ohos.resourceschedule.usageStatistics'
...
...
@@ -267,7 +257,7 @@ import usageStatistics from '@ohos.resourceschedule.usageStatistics';
}
```
8.
查询FA使用记录。返回数量最大不超过maxNum设置的值,若不传入maxNum参数,则默认maxNum为1000
。config.json中需要配置权限:ohos.permission.BUNDLE_ACTIVE_INFO
。
8.
查询FA使用记录。返回数量最大不超过maxNum设置的值,若不传入maxNum参数,则默认maxNum为1000
, 需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限
。
```js
import usageStatistics from '@ohos.resourceschedule.usageStatistics'
...
...
@@ -337,7 +327,7 @@ import usageStatistics from '@ohos.resourceschedule.usageStatistics';
}
```
9.
通过指定起始和结束时间查询所有应用的通知次数,
config.json中需要配置权限:ohos.permission.BUNDLE_ACTIVE_INFO
。
9.
通过指定起始和结束时间查询所有应用的通知次数,
需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限
。
```js
import usageStatistics from '@ohos.resourceschedule.usageStatistics'
...
...
@@ -369,7 +359,7 @@ import usageStatistics from '@ohos.resourceschedule.usageStatistics';
}
```
10.
通过指定起始和结束时间查询系统事件(休眠、唤醒、解锁、锁屏)统计信息,
config.json中需要配置权限:ohos.permission.BUNDLE_ACTIVE_INFO
。
10.
通过指定起始和结束时间查询系统事件(休眠、唤醒、解锁、锁屏)统计信息,
需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限
。
```js
import usageStatistics from '@ohos.resourceschedule.usageStatistics'
...
...
@@ -401,7 +391,7 @@ import usageStatistics from '@ohos.resourceschedule.usageStatistics';
}
```
11.
查询(无参)当前调用者应用的使用优先级群组,config.json中不需要配置权限。查询(有参)指定应用的使用优先级群组,
config.json中需要配置权限:ohos.permission.BUNDLE_ACTIVE_INFO
。
11.
查询(无参)当前调用者应用的使用优先级群组,config.json中不需要配置权限。查询(有参)指定应用的使用优先级群组,
需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限
。
```js
import usageStatistics from '@ohos.resourceschedule.usageStatistics'
...
...
@@ -433,7 +423,7 @@ import usageStatistics from '@ohos.resourceschedule.usageStatistics';
}
```
11.
给应用名是bundleName的应用分组设置成newGroup,返回设置结果是否成功
11.
给应用名是bundleName的应用分组设置成newGroup,返回设置结果是否成功
, 需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限。
```javascript
import usageStatistics from '@ohos.resourceschedule.usageStatistics'
...
...
@@ -469,7 +459,7 @@ import usageStatistics from '@ohos.resourceschedule.usageStatistics';
}
```
12.
注册应用分组变化监听回调,返回注册是否成功,当应用分组发生变化时,会给所有已注册的监听者返回回调信息
12.
注册应用分组变化监听回调,返回注册是否成功,当应用分组发生变化时,会给所有已注册的监听者返回回调信息
, 需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限
```javascript
import usageStatistics from '@ohos.resourceschedule.usageStatistics'
...
...
@@ -515,7 +505,7 @@ import usageStatistics from '@ohos.resourceschedule.usageStatistics';
}
```
13.
解除应用分组监听回调
13.
解除应用分组监听回调
, 需要配置ohos.permission.BUNDLE_ACTIVE_INFO权限
```javascript
import usageStatistics from '@ohos.resourceschedule.usageStatistics'
...
...
zh-cn/application-dev/reference/apis/js-apis-deviceUsageStatistics.md
浏览文件 @
ea40f2c9
...
...
@@ -14,8 +14,12 @@
-
查询应用分组信息(仅限自身应用)。
-
查询应用事件(仅限自身应用)。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> **说明:**
>
> 从API version9开始,该接口不再维护,推荐使用新接口[@ohos.resourceschedule.usageStatistics(设备使用信息统计)](js-apis-resourceschedule-deviceUsageStatistics.md)
>
> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
>
## 导入模块
...
...
@@ -442,13 +446,13 @@ queryCurrentBundleActiveStates(begin: number, end: number): Promise<Array<
| bundleName | string | 是 | 应用包名。 |
| abilityPrevAccessTime | number | 是 | 应用最后一次使用的时间。 |
| abilityInFgTotalTime | number | 是 | 应用在前台使用的总时间。 |
| id | number | 否 | 用户id。
<br>
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
|
| abilityPrevSeenTime | number | 否 | 应用最后一次在前台可见的时间。
<br>
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
|
| abilitySeenTotalTime | number | 否 | 应用在前台可见的总时间。
<br>
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
|
| fgAbilityAccessTotalTime | number | 否 | 应用访问前台的总时间。
<br>
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
|
| fgAbilityPrevAccessTime | number | 否 | 应用最后一次访问前台的时间。
<br>
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
|
| infosBeginTime | number | 否 | BundleActiveInfo对象中第一条应用使用统计的记录时间。
<br>
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
|
| infosEndTime | number | 否 | BundleActiveInfo对象中最后一条应用使用统计的记录时间。
<br>
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
|
| id | number | 否 | 用户id。|
| abilityPrevSeenTime | number | 否 | 应用最后一次在前台可见的时间。|
| abilitySeenTotalTime | number | 否 | 应用在前台可见的总时间。|
| fgAbilityAccessTotalTime | number | 否 | 应用访问前台的总时间。|
| fgAbilityPrevAccessTime | number | 否 | 应用最后一次访问前台的时间。|
| infosBeginTime | number | 否 | BundleActiveInfo对象中第一条应用使用统计的记录时间。|
| infosEndTime | number | 否 | BundleActiveInfo对象中最后一条应用使用统计的记录时间。|
## BundleActiveState
...
...
@@ -463,9 +467,9 @@ queryCurrentBundleActiveStates(begin: number, end: number): Promise<Array<
| bundleName | string | 是 | 应用包名。 |
| stateType | number | 是 | 应用事件类型。 |
| stateOccurredTime | number | 是 | 应用事件发生的时间戳。 |
| appUsagePriorityGroup | number | 否 | 应用程序的使用优先级组。
<br>
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
|
| indexOfLink | string | 否 | 快捷方式id。
<br>
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
|
| nameOfClass | string | 否 | 类名。
<br>
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
|
| appUsagePriorityGroup | number | 否 | 应用程序的使用优先级组。|
| indexOfLink | string | 否 | 快捷方式id。|
| nameOfClass | string | 否 | 类名。|
## BundleActiveInfoResponse
...
...
zh-cn/application-dev/reference/apis/js-apis-resourceschedule-deviceUsageStatistics.md
浏览文件 @
ea40f2c9
...
...
@@ -17,8 +17,10 @@
-
查询应用分组信息(仅限自身应用)。
-
查询应用事件(仅限自身应用)。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> **说明:**
>
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
>
## 导入模块
...
...
@@ -1537,13 +1539,13 @@ FA卡片的使用信息的属性集合。
| bundleName | string | 是 | 应用包名。 |
| abilityPrevAccessTime | number | 是 | 应用最后一次使用的时间。 |
| abilityInFgTotalTime | number | 是 | 应用在前台使用的总时间。 |
| id | number | 否 | 用户id。
<br>
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
|
| abilityPrevSeenTime | number | 否 | 应用最后一次在前台可见的时间。
<br>
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
|
| abilitySeenTotalTime | number | 否 | 应用在前台可见的总时间。
<br>
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
|
| fgAbilityAccessTotalTime | number | 否 | 应用访问前台的总时间。
<br>
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
|
| fgAbilityPrevAccessTime | number | 否 | 应用最后一次访问前台的时间。
<br>
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
|
| infosBeginTime | number | 否 | BundleActiveInfo对象中第一条应用使用统计的记录时间。
<br>
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
|
| infosEndTime | number | 否 | BundleActiveInfo对象中最后一条应用使用统计的记录时间。
<br>
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
|
| id | number | 否 | 用户id。 |
| abilityPrevSeenTime | number | 否 | 应用最后一次在前台可见的时间。 |
| abilitySeenTotalTime | number | 否 | 应用在前台可见的总时间。 |
| fgAbilityAccessTotalTime | number | 否 | 应用访问前台的总时间。 |
| fgAbilityPrevAccessTime | number | 否 | 应用最后一次访问前台的时间。|
| infosBeginTime | number | 否 | BundleActiveInfo对象中第一条应用使用统计的记录时间。 |
| infosEndTime | number | 否 | BundleActiveInfo对象中最后一条应用使用统计的记录时间。 |
## BundleEvents
...
...
@@ -1556,9 +1558,9 @@ FA卡片的使用信息的属性集合。
| bundleName | string | 是 | 应用包名。 |
| eventId | number | 是 | 应用事件类型。 |
| eventOccurredTime | number | 是 | 应用事件发生的时间戳。 |
| appGroup | number | 否 | 应用程序的使用优先级组。
<br>
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
|
| indexOfLink | string | 否 | 快捷方式id。
<br>
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
|
| nameOfClass | string | 否 | 类名。
<br>
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
|
| appGroup | number | 否 | 应用程序的使用优先级组。|
| indexOfLink | string | 否 | 快捷方式id。|
| nameOfClass | string | 否 | 类名。|
## BundleStatsMap
...
...
zh-cn/application-dev/reference/errorcodes/errcode-DeviceUsageStatistics.md
浏览文件 @
ea40f2c9
...
...
@@ -88,7 +88,7 @@ The application is not installed.
**处理步骤**
操作应用信息时请先检查应用是否
已安装且并未卸载
。
操作应用信息时请先检查应用是否
存在
。
## 10000006 获取应用信息失败
...
...
@@ -108,7 +108,7 @@ Get application info failed.
**处理步骤**
请检查入参合法性以及应用是否
安装且并未卸载
。
请检查入参合法性以及应用是否
存在
。
## 10000007 时间操作失败
...
...
@@ -163,5 +163,5 @@ Get application group info failed. The application group infomation cannot be fo
**处理步骤**
请检查入参bundleName的
正确性
。
请检查入参bundleName的
合法性和应用是否存在
。
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录