Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
4bd61abd
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看板
未验证
提交
4bd61abd
编写于
3月 14, 2022
作者:
O
openharmony_ci
提交者:
Gitee
3月 14, 2022
浏览文件
操作
浏览文件
下载
差异文件
!2019 modify format
Merge pull request !2019 from wangyuanchao/master
上级
473dd6aa
ea67fa2d
变更
2
隐藏空白更改
内联
并排
Showing
2 changed file
with
153 addition
and
207 deletion
+153
-207
zh-cn/application-dev/device-usage-statistics/device-usage-statistics-dev-guide.md
...ice-usage-statistics/device-usage-statistics-dev-guide.md
+6
-6
zh-cn/application-dev/reference/apis/js-apis-deviceUsageStatistics.md
...ation-dev/reference/apis/js-apis-deviceUsageStatistics.md
+147
-201
未找到文件。
zh-cn/application-dev/device-usage-statistics/device-usage-statistics-dev-guide.md
浏览文件 @
4bd61abd
...
...
@@ -15,12 +15,12 @@ import stats from '@ohos.bundleState';
| 接口名 | 描述 |
| -------- | -------- |
| function queryBundleActiveStates(begin:
number, end:number, callback:AsyncCallback
<
Array
<
BundleActiveState
>>
):
void | 通过指定起始和结束时间查询所有应用的事件集合。 |
| function queryBundleStateInfos(begin:
number, end:number, callback:AsyncCallback
<
BundleStateInfoResponse
>
):
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 isIdleState(bundleName:
string, callback:AsyncCallback
<
boolean
>
):
void | 判断指定Bundle Name的应用当前是否是空闲状态。 |
| function queryBundleActiveStates(begin:
number, end: number, callback: AsyncCallback
<
Array
<
BundleActiveState
>>
):
void | 通过指定起始和结束时间查询所有应用的事件集合。 |
| 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 isIdleState(bundleName:
string, callback: AsyncCallback
<
boolean
>
):
void | 判断指定Bundle Name的应用当前是否是空闲状态。 |
## 开发步骤
...
...
zh-cn/application-dev/reference/apis/js-apis-deviceUsageStatistics.md
浏览文件 @
4bd61abd
...
...
@@ -7,32 +7,26 @@
## 导入模块
```
import
stats
from '@ohos.bundleState'
import
bundleState
from '@ohos.bundleState'
```
## bundleState.isIdleState
isIdleState(bundleName: string, callback: AsyncCallback
<boolean>
): void
-
**系统能力**
:
SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
-
**说明**
:
isIdleState(bundleName: string, callback: AsyncCallback
<
boolean
>
): void
<br>
判断指定bundleName的应用当前是否是空闲状态,使用Callback形式返回。
-
**参数**
:
**系统能力**
:SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 应用的bundleName。|
| callback | AsyncCallback
<boolean>
| 是 | 指定的callback回调方法。如果指定的bundleName有效,则返回指定bundleName的应用当前是否是空闲状态;否则返回null。 |
| callback | AsyncCallback
<
boolean
>
| 是 | 指定的callback回调方法。如果指定的bundleName有效,则返回指定bundleName的应用当前是否是空闲状态;否则返回null。 |
-
**权限**
:
无权限
-
**示例**
:
**示例**
:
```
stats
.isIdleState("com.ohos.camera", (err, res) => {
bundleState
.isIdleState("com.ohos.camera", (err, res) => {
if(err.code === 0) {
console.log('BUNDLE_ACTIVE isIdleState callback succeeded, result: ' + JSON.stringify(res));
} else {
...
...
@@ -42,33 +36,27 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
```
## bundleState.isIdleState
isIdleState(bundleName: string): Promise
<boolean>
;
-
**系统能力**
:
SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
-
**说明**
:
isIdleState(bundleName: string): Promise
<
boolean
>
<br>
判断指定bundleName的应用当前是否是空闲状态,使用Promise形式返回。
-
**参数**
:
**系统能力**
:SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 应用的bundleName。|
-
**返回值**
:
**返回值**
:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<boolean>
| 指定的Promise回调方法。如果指定的bundleName有效,则返回指定bundleName的应用当前是否是空闲状态;否则返回null。 |
-
**权限**
:
无权限
| Promise
<
boolean
>
| 指定的Promise回调方法。如果指定的bundleName有效,则返回指定bundleName的应用当前是否是空闲状态;否则返回null。 |
-
**示例**
:
**示例**
:
```
stats
.isIdleState("com.ohos.camera").then( res => {
bundleState
.isIdleState("com.ohos.camera").then( res => {
console.log('BUNDLE_ACTIVE isIdleState promise succeeded, result: ' + JSON.stringify(res));
}).catch( err => {
console.log('BUNDLE_ACTIVE isIdleState promise failed, because: ' + err.code);
...
...
@@ -76,27 +64,21 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
```
## bundleState.queryAppUsagePriorityGroup
queryAppUsagePriorityGroup(callback: AsyncCallback
<number>
): void
-
**系统能力**
:
SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
-
**说明**
:
queryAppUsagePriorityGroup(callback: AsyncCallback
<
number
>
): void
<br>
查询(返回)当前调用者应用的使用优先级群组,使用Callback形式返回。
-
**参数**
:
**系统能力**
:SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback
<number>
| 是 | 指定的callback回调方法。返回当前调用者应用的使用优先级群组。|
| callback | AsyncCallback
<
number
>
| 是 | 指定的callback回调方法。返回当前调用者应用的使用优先级群组。|
-
**权限**
:
无权限
-
**示例**
:
**示例**
:
```
stats
.queryAppUsagePriorityGroup((err, res) => {
bundleState
.queryAppUsagePriorityGroup((err, res) => {
if(err.code === 0) {
console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup callback succeeded. result: ' + JSON.stringify(res));
} else {
...
...
@@ -106,27 +88,21 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
```
## bundleState.queryAppUsagePriorityGroup
queryAppUsagePriorityGroup(): Promise
<number>
-
**系统能力**
:
SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
-
**说明**
:
queryAppUsagePriorityGroup(): Promise
<
number
>
<br>
查询(返回)当前调用者应用的使用优先级群组,使用Promise形式返回。
-
**返回值**
:
**系统能力**
:SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
**返回值**
:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<number>
| 指定的Promise回调方法。查询(返回)当前调用者应用的使用优先级群组。|
-
**权限**
:
无权限
| Promise
<
number
>
| 指定的Promise回调方法。查询(返回)当前调用者应用的使用优先级群组。|
-
**示例**
:
**示例**
:
```
stats
.queryAppUsagePriorityGroup().then( res => {
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);
...
...
@@ -134,29 +110,24 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
```
## bundleState.queryBundleStateInfos
queryBundleStateInfos(begin: number, end: number, callback: AsyncCallback
<BundleActiveInfoResponse>
): void
-
**系统能力**
:
SystemCapability.ResourceSchedule.UsageStatistics.App
queryBundleStateInfos(begin: number, end: number, callback: AsyncCallback
<
BundleActiveInfoResponse
>
): void
<br>
通过指定起始和结束时间查询应用使用时长统计信息,使用Callback形式返回。
<br>
**需要权限**
:ohos.permission.BUNDLE_ACTIVE_INFO
-
**说明**
:
通过指定起始和结束时间查询应用使用时长统计信息,使用Callback形式返回。
**系统能力**
:SystemCapability.ResourceSchedule.UsageStatistics.App
-
**参数**
:
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| begin | number | 是 | 起始时间。|
| end | number | 是 | 结束时间。|
| callback | AsyncCallback
<BundleActiveInfoResponse>
| 是 | 指定的callback回调方法。返回指定起始和结束时间内应用使用时长统计信息。|
| callback | AsyncCallback
<
BundleActiveInfoResponse
>
| 是 | 指定的callback回调方法。返回指定起始和结束时间内应用使用时长统计信息。|
-
**权限**
:
ohos.permission.BUNDLE_ACTIVE_INFO
-
**示例**
:
**示例**
:
```
stats
.queryBundleStateInfos(0, 20000000000000, (err, res) => {
bundleState
.queryBundleStateInfos(0, 20000000000000, (err, res) => {
if(err.code == 0) {
console.log('BUNDLE_ACTIVE queryBundleStateInfos callback success.');
let i = 1;
...
...
@@ -172,34 +143,29 @@ ohos.permission.BUNDLE_ACTIVE_INFO
```
## bundleState.queryBundleStateInfos
queryBundleStateInfos(begin: number, end: number): Promise
<BundleActiveInfoResponse>
-
**系统能力**
:
SystemCapability.ResourceSchedule.UsageStatistics.App
queryBundleStateInfos(begin: number, end: number): Promise
<
BundleActiveInfoResponse
>
<br>
通过指定起始和结束时间查询应用使用时长统计信息,使用Promise形式返回。
<br>
**需要权限**
:ohos.permission.BUNDLE_ACTIVE_INFO
-
**说明**
:
通过指定起始和结束时间查询应用使用时长统计信息,使用Promise形式返回。
**系统能力**
:SystemCapability.ResourceSchedule.UsageStatistics.App
-
**参数**
:
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| begin | number | 是 | 起始时间。|
| end | number | 是 | 结束时间。|
-
**返回值**
:
**返回值**
:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<BundleActiveInfoResponse>
| 指定的Promise回调方法。返回指定起始和结束时间内应用使用时长统计信息。|
-
**权限**
:
ohos.permission.BUNDLE_ACTIVE_INFO
| Promise
<
BundleActiveInfoResponse
>
| 指定的Promise回调方法。返回指定起始和结束时间内应用使用时长统计信息。|
-
**示例**
:
**示例**
:
```
stats
.queryBundleStateInfos(0, 20000000000000).then( res => {
bundleState
.queryBundleStateInfos(0, 20000000000000).then( res => {
console.log('BUNDLE_ACTIVE queryBundleStateInfos promise success.');
let i = 1;
for(let key in res){
...
...
@@ -213,30 +179,25 @@ ohos.permission.BUNDLE_ACTIVE_INFO
```
## bundleState.queryBundleStateInfoByInterval
queryBundleStateInfoByInterval(byInterval: IntervalType, begin: number, end: number, callback: AsyncCallback
<Array
<
BundleStateInfo
>
>): void
queryBundleStateInfoByInterval(byInterval: IntervalType, begin: number, end: number, callback: AsyncCallback
<
Array
<
BundleStateInfo
>>
): void
<br>
通过指定时间段间隔(天、周、月、年)查询应用使用时长统计信息,使用Callback形式返回。
<br>
**需要权限**
:ohos.permission.BUNDLE_ACTIVE_INFO
-
**系统能力**
:
SystemCapability.ResourceSchedule.UsageStatistics.App
**系统能力**
:SystemCapability.ResourceSchedule.UsageStatistics.App
-
**说明**
:
通过指定时间段间隔(天、周、月、年)查询应用使用时长统计信息,使用Callback形式返回。
-
**参数**
:
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| byInterval | IntervalType | 是 | 查询类型。|
| begin | number | 是 | 起始时间。|
| end | number | 是 | 结束时间。|
| callback | AsyncCallback
<Array
<
BundleStateInfo
>
> | 是 | 指定的callback回调方法。返回指定时间段间隔(天、周、月、年)查询应用使用时长统计信息。|
-
**权限**
:
ohos.permission.BUNDLE_ACTIVE_INFO
| callback | AsyncCallback
<
Array
<
BundleStateInfo
>>
| 是 | 指定的callback回调方法。返回指定时间段间隔(天、周、月、年)查询应用使用时长统计信息。|
-
**示例**
:
**示例**
:
```
stats
.queryBundleStateInfoByInterval(0, 0, 20000000000000, (err, res) => {
bundleState
.queryBundleStateInfoByInterval(0, 0, 20000000000000, (err, res) => {
if(err.code == 0) {
console.log('BUNDLE_ACTIVE queryBundleStateInfoByInterval callback success.');
for (let i = 0; i < res.length; i++) {
...
...
@@ -250,15 +211,13 @@ ohos.permission.BUNDLE_ACTIVE_INFO
```
## bundleState.queryBundleStateInfoByInterval
queryBundleStateInfoByInterval(byInterval: IntervalType, begin: number, end: number): Promise
<Array
<
BundleStateInfo
>
>
queryBundleStateInfoByInterval(byInterval: IntervalType, begin: number, end: number): Promise
<
Array
<
BundleStateInfo
>>
<br>
通过指定时间段间隔(天、周、月、年)查询应用使用时长统计信息,使用Promise形式返回。
<br>
**需要权限**
:ohos.permission.BUNDLE_ACTIVE_INFO
-
**系统能力**
:
SystemCapability.ResourceSchedule.UsageStatistics.App
**系统能力**
:SystemCapability.ResourceSchedule.UsageStatistics.App
-
**说明**
:
通过指定时间段间隔(天、周、月、年)查询应用使用时长统计信息,使用Promise形式返回。
-
**参数**
:
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
...
...
@@ -266,19 +225,16 @@ SystemCapability.ResourceSchedule.UsageStatistics.App
| begin | number | 是 | 起始时间。|
| end | number | 是 | 结束时间。|
-
**返回值**
:
**返回值**
:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<Array
<
BundleStateInfo
>
> | 指定的Promise回调方法。返回指定时间段间隔(天、周、月、年)查询应用使用时长统计信息。|
-
**权限**
:
ohos.permission.BUNDLE_ACTIVE_INFO
| Promise
<
Array
<
BundleStateInfo
>>
| 指定的Promise回调方法。返回指定时间段间隔(天、周、月、年)查询应用使用时长统计信息。|
-
**示例**
:
**示例**
:
```
stats
.queryBundleStateInfoByInterval(0, 0, 20000000000000).then( res => {
bundleState
.queryBundleStateInfoByInterval(0, 0, 20000000000000).then( res => {
console.log('BUNDLE_ACTIVE queryBundleStateInfoByInterval promise success.');
for (let i = 0; i < res.length; i++) {
console.log('BUNDLE_ACTIVE queryBundleStateInfoByInterval promise number : ' + (i + 1));
...
...
@@ -290,29 +246,24 @@ ohos.permission.BUNDLE_ACTIVE_INFO
```
## bundleState.queryBundleActiveStates
queryBundleActiveStates(begin: number, end: number, callback: AsyncCallback
<Array
<
BundleActiveState
>
>): void
-
**系统能力**
:
SystemCapability.ResourceSchedule.UsageStatistics.App
queryBundleActiveStates(begin: number, end: number, callback: AsyncCallback
<
Array
<
BundleActiveState
>>
): void
<br>
通过指定起始和结束时间查询所有应用的事件集合,使用Callback形式返回。
<br>
**需要权限**
:ohos.permission.BUNDLE_ACTIVE_INFO
-
**说明**
:
通过指定起始和结束时间查询所有应用的事件集合,使用Callback形式返回。
**系统能力**
:SystemCapability.ResourceSchedule.UsageStatistics.App
-
**参数**
:
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| begin | number | 是 | 起始时间。|
| end | number | 是 | 结束时间。|
| callback | AsyncCallback
<Array
<
BundleActiveState
>
>
| 是 | 指定的callback回调方法。返回指定起始和结束时间查询所有应用的事件集合。|
| callback | AsyncCallback
<
Array
<
BundleActiveState
>>
| 是 | 指定的callback回调方法。返回指定起始和结束时间查询所有应用的事件集合。|
-
**权限**
:
ohos.permission.BUNDLE_ACTIVE_INFO
-
**示例**
:
**示例**
:
```
stats
.queryBundleActiveStates(0, 20000000000000, (err, res) => {
bundleState
.queryBundleActiveStates(0, 20000000000000, (err, res) => {
if(err.code == 0) {
console.log('BUNDLE_ACTIVE queryBundleActiveStates callback success.');
for (let i = 0; i < res.length; i++) {
...
...
@@ -326,34 +277,29 @@ ohos.permission.BUNDLE_ACTIVE_INFO
```
## bundleState.queryBundleActiveStates
queryBundleActiveStates(begin: number, end: number): Promise
<Array
<
BundleActiveState
>
>
-
**系统能力**
:
SystemCapability.ResourceSchedule.UsageStatistics.App
queryBundleActiveStates(begin: number, end: number): Promise
<
Array
<
BundleActiveState
>>
<br>
通过指定起始和结束时间查询所有应用的事件集合,使用Promise形式返回。
<br>
**需要权限**
:ohos.permission.BUNDLE_ACTIVE_INFO
-
**说明**
:
通过指定起始和结束时间查询所有应用的事件集合,使用Promise形式返回。
**系统能力**
:SystemCapability.ResourceSchedule.UsageStatistics.App
-
**参数**
:
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| begin | number | 是 | 起始时间。|
| end | number | 是 | 结束时间。|
-
**返回值**
:
**返回值**
:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<Array
<
BundleActiveState
>
> | 指定的Promise回调方法。返回指定起始和结束时间查询所有应用的事件集合。|
-
**权限**
:
ohos.permission.BUNDLE_ACTIVE_INFO
| Promise
<
Array
<
BundleActiveState
>>
| 指定的Promise回调方法。返回指定起始和结束时间查询所有应用的事件集合。|
-
**示例**
:
**示例**
:
```
stats
.queryBundleActiveStates(0, 20000000000000).then( res => {
bundleState
.queryBundleActiveStates(0, 20000000000000).then( res => {
console.log('BUNDLE_ACTIVE queryBundleActiveStates promise success.');
for (let i = 0; i < res.length; i++) {
console.log('BUNDLE_ACTIVE queryBundleActiveStates promise number : ' + (i + 1));
...
...
@@ -365,29 +311,23 @@ ohos.permission.BUNDLE_ACTIVE_INFO
```
## bundleState.queryCurrentBundleActiveStates
queryCurrentBundleActiveStates(begin: number, end: number, callback: AsyncCallback
<Array
<
BundleActiveState
>
>): void
-
**系统能力**
:
SystemCapability.ResourceSchedule.UsageStatistics.App
-
**说明**
:
queryCurrentBundleActiveStates(begin: number, end: number, callback: AsyncCallback
<
Array
<
BundleActiveState
>>
): void
<br>
通过指定起始和结束时间查询当前应用的事件集合,使用Callback形式返回。
-
**参数**
:
**系统能力**
:SystemCapability.ResourceSchedule.UsageStatistics.App
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| begin | number | 是 | 起始时间。|
| end | number | 是 | 结束时间。|
| callback | AsyncCallback
<Array
<
BundleActiveState
>
>
| 是 | 指定的callback回调方法。返回指定起始和结束时间查询当前应用的事件集合。|
| callback | AsyncCallback
<
Array
<
BundleActiveState
>>
| 是 | 指定的callback回调方法。返回指定起始和结束时间查询当前应用的事件集合。|
-
**权限**
:
无权限
-
**示例**
:
**示例**
:
```
stats
.queryCurrentBundleActiveStates(0, 20000000000000, (err, res) => {
bundleState
.queryCurrentBundleActiveStates(0, 20000000000000, (err, res) => {
if(err.code == 0) {
console.log('BUNDLE_ACTIVE queryCurrentBundleActiveStates callback success.');
for (let i = 0; i < res.length; i++) {
...
...
@@ -401,34 +341,28 @@ SystemCapability.ResourceSchedule.UsageStatistics.App
```
## bundleState.queryCurrentBundleActiveStates
queryCurrentBundleActiveStates(begin: number, end: number): Promise
<Array
<
BundleActiveState
>
>
-
**系统能力**
:
SystemCapability.ResourceSchedule.UsageStatistics.App
-
**说明**
:
queryCurrentBundleActiveStates(begin: number, end: number): Promise
<
Array
<
BundleActiveState
>>
<br>
通过指定起始和结束时间查询当前应用的事件集合,使用Promise形式返回。
-
**参数**
:
**系统能力**
:SystemCapability.ResourceSchedule.UsageStatistics.App
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| begin | number | 是 | 起始时间。|
| end | number | 是 | 结束时间。|
-
**返回值**
:
**返回值**
:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<Array
<
BundleActiveState
>
> | 指定的Promise回调方法。返回指定起始和结束时间查询当前应用的事件集合。|
-
**权限**
:
无权限
| Promise
<
Array
<
BundleActiveState
>>
| 指定的Promise回调方法。返回指定起始和结束时间查询当前应用的事件集合。|
-
**示例**
:
**示例**
:
```
stats
.queryCurrentBundleActiveStates(0, 20000000000000).then( res => {
bundleState
.queryCurrentBundleActiveStates(0, 20000000000000).then( res => {
console.log('BUNDLE_ACTIVE queryCurrentBundleActiveStates promise success.');
for (let i = 0; i < res.length; i++) {
console.log('BUNDLE_ACTIVE queryCurrentBundleActiveStates promise number : ' + (i + 1));
...
...
@@ -439,58 +373,70 @@ SystemCapability.ResourceSchedule.UsageStatistics.App
});
```
## bundleState.BundleStateInfo
-
**系统能力**
:
SystemCapability.ResourceSchedule.UsageStatistics.App
## BundleStateInfo
提供应用使用时长的具体信息。
-
**参数**
:
### 属性
**系统能力**
:以下各项对应的系统能力均为SystemCapability.ResourceSchedule.UsageStatistics.App
提供应用使用时长的具体信息。
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 应用包名。|
| abilityPrevAccessTime | number | 是 | 应用最后一次使用的时间。|
| abilityInFgTotalTime | number | 是 | 应用在前台使用的总时间。|
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| 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版本中提供使用支持。|
| infosBeginTime | number | 否 | BundleActiveInfo对象中最后一条应用使用统计的记录时间。
<br>
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。|
## bundleState.BundleActiveState
-
**系统能力**
:
SystemCapability.ResourceSchedule.UsageStatistics.App
### merge
merge(toMerge: BundleStateInfo): void
合并相同包名的应用使用信息。
<br>
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
-
**参数**
:
**系统能力**
:SystemCapability.ResourceSchedule.UsageStatistics.App
提供应用事件的具体信息。
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 应用包名。|
| stateType | number | 是 | 应用事件类型。|
| stateOccurredTime | number | 是 | 应用事件发生的时间戳。|
| toMerge | BundleStateInfo | 是 | 相同包名的应用使用统计信息。|
## bundleState.BundleActiveInfoResponse
-
**系统能力**
:
SystemCapability.ResourceSchedule.UsageStatistics.App
## BundleActiveState
提供应用事件的具体信息。
-
**参数**
:
**系统能力**
:以下各项对应的系统能力均为SystemCapability.ResourceSchedule.UsageStatistics.App
提供应用使用时长的具体信息。
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| 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版本中提供使用支持。|
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| [key: string]: BundleStateInfo | BundleStateInfo | 是 | 不同应用的使用时长统计信息。|
## BundleActiveInfoResponse
提供应用使用时长的具体信息。
## bundleState.IntervalType
-
**系统能力**
:
SystemCapability.ResourceSchedule.UsageStatistics.App
**系统能力**
:SystemCapability.ResourceSchedule.UsageStatistics.App
-
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| [key: string]: BundleStateInfo | BundleStateInfo | 是 | 不同应用的使用时长统计信息。|
## bundleState.IntervalType
提供应用使用时长的查询类型。
提供查询的类型
**系统能力**
:以下各项对应的系统能力均为SystemCapability.ResourceSchedule.UsageStatistics.App
|名称 |默认值 |说明|
| -------- | -------- | -------- |
| BY_OPTIMIZED | 0 | 表示系统自己判断最合适的查询类型(天、周、月、年)去查询指定时间段间隔的应用使用时长信息。|
| BY_DAILY | 1 | 表示系统按照天去查询指定时间段间隔的应用使用时长信息。|
| BY_WEEKLY | 2 | 表示系统按照周去查询指定时间段间隔的应用使用时长信息。|
| BY_MONTHLY | 3 | 表示系统按照月去查询指定时间段间隔的应用使用时长信息。|
| BY_ANNUALLY | 4 | 表示系统按照年去查询指定时间段间隔的应用使用时长信息。|
\ No newline at end of file
|名称 |默认值 |说明|
| -------- | -------- | -------- |
| BY_OPTIMIZED | 0 | 表示系统自行判断最合适的查询类型(天、周、月、年)去查询指定时间段间隔的应用使用时长信息。|
| BY_DAILY | 1 | 表示系统按照天去查询指定时间段间隔的应用使用时长信息。|
| BY_WEEKLY | 2 | 表示系统按照周去查询指定时间段间隔的应用使用时长信息。|
| BY_MONTHLY | 3 | 表示系统按照月去查询指定时间段间隔的应用使用时长信息。|
| BY_ANNUALLY | 4 | 表示系统按照年去查询指定时间段间隔的应用使用时长信息。|
\ No newline at end of file
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录