未验证 提交 4bd61abd 编写于 作者: O openharmony_ci 提交者: Gitee

!2019 modify format

Merge pull request !2019 from wangyuanchao/master
......@@ -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的应用当前是否是空闲状态。 |
## 开发步骤
......
......@@ -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&lt;boolean&gt;): void<br>
判断指定bundleName的应用当前是否是空闲状态,使用Callback形式返回。
- **参数**
**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
**参数**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 应用的bundleName。|
| callback | AsyncCallback<boolean> | 是 | 指定的callback回调方法。如果指定的bundleName有效,则返回指定bundleName的应用当前是否是空闲状态;否则返回null。 |
| callback | AsyncCallback&lt;boolean&gt; | 是 | 指定的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&lt;boolean&gt;<br>
判断指定bundleName的应用当前是否是空闲状态,使用Promise形式返回。
- **参数**
**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
**参数**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 应用的bundleName。|
- **返回值**
**返回值**
| 类型 | 说明 |
| -------- | -------- |
| Promise<boolean> | 指定的Promise回调方法。如果指定的bundleName有效,则返回指定bundleName的应用当前是否是空闲状态;否则返回null。 |
- **权限**
无权限
| Promise&lt;boolean&gt; | 指定的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&lt;number&gt;): void<br>
查询(返回)当前调用者应用的使用优先级群组,使用Callback形式返回。
- **参数**
**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
**参数**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback<number> | 是 | 指定的callback回调方法。返回当前调用者应用的使用优先级群组。|
| callback | AsyncCallback&lt;number&gt; | 是 | 指定的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&lt;number&gt;<br>
查询(返回)当前调用者应用的使用优先级群组,使用Promise形式返回。
- **返回值**
**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
**返回值**
| 类型 | 说明 |
| -------- | -------- |
| Promise<number> | 指定的Promise回调方法。查询(返回)当前调用者应用的使用优先级群组。|
- **权限**
无权限
| Promise&lt;number&gt; | 指定的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&lt;BundleActiveInfoResponse&gt;): void<br>
通过指定起始和结束时间查询应用使用时长统计信息,使用Callback形式返回。<br>
**需要权限**:ohos.permission.BUNDLE_ACTIVE_INFO
- **说明**
通过指定起始和结束时间查询应用使用时长统计信息,使用Callback形式返回。
**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App
- **参数**
**参数**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| begin | number | 是 | 起始时间。|
| end | number | 是 | 结束时间。|
| callback | AsyncCallback<BundleActiveInfoResponse> | 是 | 指定的callback回调方法。返回指定起始和结束时间内应用使用时长统计信息。|
| callback | AsyncCallback&lt;BundleActiveInfoResponse&gt; | 是 | 指定的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&lt;BundleActiveInfoResponse&gt;<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&lt;BundleActiveInfoResponse&gt; | 指定的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&lt;Array&lt;BundleStateInfo&gt;&gt;): 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&lt;Array&lt;BundleStateInfo&gt;&gt; | 是 | 指定的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&lt;Array&lt;BundleStateInfo&gt;&gt;<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&lt;Array&lt;BundleStateInfo&gt;&gt; | 指定的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&lt;Array&lt;BundleActiveState&gt;&gt;): 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&lt;Array&lt;BundleActiveState&gt;&gt; | 是 | 指定的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&lt;Array&lt;BundleActiveState&gt;&gt;<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&lt;Array&lt;BundleActiveState&gt;&gt; | 指定的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&lt;Array&lt;BundleActiveState&gt;&gt;): void<br>
通过指定起始和结束时间查询当前应用的事件集合,使用Callback形式返回。
- **参数**
**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App
**参数**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| begin | number | 是 | 起始时间。|
| end | number | 是 | 结束时间。|
| callback | AsyncCallback<Array<BundleActiveState>> | 是 | 指定的callback回调方法。返回指定起始和结束时间查询当前应用的事件集合。|
| callback | AsyncCallback&lt;Array&lt;BundleActiveState&gt;&gt; | 是 | 指定的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&lt;Array&lt;BundleActiveState&gt;&gt;<br>
通过指定起始和结束时间查询当前应用的事件集合,使用Promise形式返回。
- **参数**
**系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App
**参数**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| begin | number | 是 | 起始时间。|
| end | number | 是 | 结束时间。|
- **返回值**
**返回值**
| 类型 | 说明 |
| -------- | -------- |
| Promise<Array<BundleActiveState>> | 指定的Promise回调方法。返回指定起始和结束时间查询当前应用的事件集合。|
- **权限**
无权限
| Promise&lt;Array&lt;BundleActiveState&gt;&gt; | 指定的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.
先完成此消息的编辑!
想要评论请 注册