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

!2019 modify format

Merge pull request !2019 from wangyuanchao/master
...@@ -15,12 +15,12 @@ import stats from '@ohos.bundleState'; ...@@ -15,12 +15,12 @@ import stats from '@ohos.bundleState';
| 接口名 | 描述 | | 接口名 | 描述 |
| -------- | -------- | | -------- | -------- |
| function queryBundleActiveStates(begin:number, end:number, callback:AsyncCallback<Array<BundleActiveState>>):void | 通过指定起始和结束时间查询所有应用的事件集合。 | | function queryBundleActiveStates(begin: number, end: number, callback: AsyncCallback<Array<BundleActiveState>>): void | 通过指定起始和结束时间查询所有应用的事件集合。 |
| function queryBundleStateInfos(begin:number, end:number, callback:AsyncCallback<BundleStateInfoResponse>):void | 通过指定起始和结束时间查询应用使用时长统计信息。 | | function queryBundleStateInfos(begin: number, end: number, callback: AsyncCallback<BundleActiveInfoResponse>): void | 通过指定起始和结束时间查询应用使用时长统计信息。 |
| function queryCurrentBundleActiveStates(begin:number, end:number, callback:AsyncCallback<Array<BundleActiveState>>):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 queryBundleStateInfoByInterval(byInterval: IntervalType, begin: number, end: number, callback: AsyncCallback<Array<BundleStateInfo>>): void | 通过指定时间段间隔(天、周、月、年)查询应用使用时长统计信息。 |
| 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的应用当前是否是空闲状态。 |
## 开发步骤 ## 开发步骤
......
...@@ -7,32 +7,26 @@ ...@@ -7,32 +7,26 @@
## 导入模块 ## 导入模块
``` ```
import stats from '@ohos.bundleState' import bundleState from '@ohos.bundleState'
``` ```
## bundleState.isIdleState ## bundleState.isIdleState
isIdleState(bundleName: string, callback: AsyncCallback<boolean>): void isIdleState(bundleName: string, callback: AsyncCallback&lt;boolean&gt;): void<br>
- **系统能力**
SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
- **说明**
判断指定bundleName的应用当前是否是空闲状态,使用Callback形式返回。 判断指定bundleName的应用当前是否是空闲状态,使用Callback形式返回。
- **参数** **系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
**参数**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 应用的bundleName。| | 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) { if(err.code === 0) {
console.log('BUNDLE_ACTIVE isIdleState callback succeeded, result: ' + JSON.stringify(res)); console.log('BUNDLE_ACTIVE isIdleState callback succeeded, result: ' + JSON.stringify(res));
} else { } else {
...@@ -42,33 +36,27 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup ...@@ -42,33 +36,27 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
``` ```
## bundleState.isIdleState ## bundleState.isIdleState
isIdleState(bundleName: string): Promise<boolean>; isIdleState(bundleName: string): Promise&lt;boolean&gt;<br>
- **系统能力**
SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
- **说明**
判断指定bundleName的应用当前是否是空闲状态,使用Promise形式返回。 判断指定bundleName的应用当前是否是空闲状态,使用Promise形式返回。
- **参数** **系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
**参数**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 应用的bundleName。| | 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)); console.log('BUNDLE_ACTIVE isIdleState promise succeeded, result: ' + JSON.stringify(res));
}).catch( err => { }).catch( err => {
console.log('BUNDLE_ACTIVE isIdleState promise failed, because: ' + err.code); console.log('BUNDLE_ACTIVE isIdleState promise failed, because: ' + err.code);
...@@ -76,27 +64,21 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup ...@@ -76,27 +64,21 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
``` ```
## bundleState.queryAppUsagePriorityGroup ## bundleState.queryAppUsagePriorityGroup
queryAppUsagePriorityGroup(callback: AsyncCallback<number>): void queryAppUsagePriorityGroup(callback: AsyncCallback&lt;number&gt;): void<br>
- **系统能力**
SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
- **说明**
查询(返回)当前调用者应用的使用优先级群组,使用Callback形式返回。 查询(返回)当前调用者应用的使用优先级群组,使用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) { if(err.code === 0) {
console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup callback succeeded. result: ' + JSON.stringify(res)); console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup callback succeeded. result: ' + JSON.stringify(res));
} else { } else {
...@@ -106,27 +88,21 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup ...@@ -106,27 +88,21 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
``` ```
## bundleState.queryAppUsagePriorityGroup ## bundleState.queryAppUsagePriorityGroup
queryAppUsagePriorityGroup(): Promise<number> queryAppUsagePriorityGroup(): Promise&lt;number&gt;<br>
- **系统能力**
SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
- **说明**
查询(返回)当前调用者应用的使用优先级群组,使用Promise形式返回。 查询(返回)当前调用者应用的使用优先级群组,使用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)); console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup promise succeeded. result: ' + JSON.stringify(res));
}).catch( err => { }).catch( err => {
console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup promise failed. because: ' + err.code); console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup promise failed. because: ' + err.code);
...@@ -134,29 +110,24 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup ...@@ -134,29 +110,24 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
``` ```
## bundleState.queryBundleStateInfos ## bundleState.queryBundleStateInfos
queryBundleStateInfos(begin: number, end: number, callback: AsyncCallback<BundleActiveInfoResponse>): void queryBundleStateInfos(begin: number, end: number, callback: AsyncCallback&lt;BundleActiveInfoResponse&gt;): void<br>
通过指定起始和结束时间查询应用使用时长统计信息,使用Callback形式返回。<br>
- **系统能力** **需要权限**:ohos.permission.BUNDLE_ACTIVE_INFO
SystemCapability.ResourceSchedule.UsageStatistics.App
- **说明** **系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App
通过指定起始和结束时间查询应用使用时长统计信息,使用Callback形式返回。
- **参数** **参数**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| begin | number | 是 | 起始时间。| | begin | number | 是 | 起始时间。|
| end | 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) { if(err.code == 0) {
console.log('BUNDLE_ACTIVE queryBundleStateInfos callback success.'); console.log('BUNDLE_ACTIVE queryBundleStateInfos callback success.');
let i = 1; let i = 1;
...@@ -172,34 +143,29 @@ ohos.permission.BUNDLE_ACTIVE_INFO ...@@ -172,34 +143,29 @@ ohos.permission.BUNDLE_ACTIVE_INFO
``` ```
## bundleState.queryBundleStateInfos ## bundleState.queryBundleStateInfos
queryBundleStateInfos(begin: number, end: number): Promise<BundleActiveInfoResponse> queryBundleStateInfos(begin: number, end: number): Promise&lt;BundleActiveInfoResponse&gt;<br>
通过指定起始和结束时间查询应用使用时长统计信息,使用Promise形式返回。<br>
- **系统能力** **需要权限**:ohos.permission.BUNDLE_ACTIVE_INFO
SystemCapability.ResourceSchedule.UsageStatistics.App
- **说明** **系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App
通过指定起始和结束时间查询应用使用时长统计信息,使用Promise形式返回。
- **参数** **参数**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| begin | number | 是 | 起始时间。| | begin | number | 是 | 起始时间。|
| end | number | 是 | 结束时间。| | end | number | 是 | 结束时间。|
- **返回值** **返回值**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise<BundleActiveInfoResponse> | 指定的Promise回调方法。返回指定起始和结束时间内应用使用时长统计信息。| | Promise&lt;BundleActiveInfoResponse&gt; | 指定的Promise回调方法。返回指定起始和结束时间内应用使用时长统计信息。|
- **权限**
ohos.permission.BUNDLE_ACTIVE_INFO
- **示例** **示例**
``` ```
stats.queryBundleStateInfos(0, 20000000000000).then( res => { bundleState.queryBundleStateInfos(0, 20000000000000).then( res => {
console.log('BUNDLE_ACTIVE queryBundleStateInfos promise success.'); console.log('BUNDLE_ACTIVE queryBundleStateInfos promise success.');
let i = 1; let i = 1;
for(let key in res){ for(let key in res){
...@@ -213,30 +179,25 @@ ohos.permission.BUNDLE_ACTIVE_INFO ...@@ -213,30 +179,25 @@ ohos.permission.BUNDLE_ACTIVE_INFO
``` ```
## bundleState.queryBundleStateInfoByInterval ## 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 | 是 | 查询类型。| | byInterval | IntervalType | 是 | 查询类型。|
| begin | number | 是 | 起始时间。| | begin | number | 是 | 起始时间。|
| end | number | 是 | 结束时间。| | end | number | 是 | 结束时间。|
| callback | AsyncCallback<Array<BundleStateInfo>> | 是 | 指定的callback回调方法。返回指定时间段间隔(天、周、月、年)查询应用使用时长统计信息。| | callback | AsyncCallback&lt;Array&lt;BundleStateInfo&gt;&gt; | 是 | 指定的callback回调方法。返回指定时间段间隔(天、周、月、年)查询应用使用时长统计信息。|
- **权限**
ohos.permission.BUNDLE_ACTIVE_INFO
- **示例** **示例**
``` ```
stats.queryBundleStateInfoByInterval(0, 0, 20000000000000, (err, res) => { bundleState.queryBundleStateInfoByInterval(0, 0, 20000000000000, (err, res) => {
if(err.code == 0) { if(err.code == 0) {
console.log('BUNDLE_ACTIVE queryBundleStateInfoByInterval callback success.'); console.log('BUNDLE_ACTIVE queryBundleStateInfoByInterval callback success.');
for (let i = 0; i < res.length; i++) { for (let i = 0; i < res.length; i++) {
...@@ -250,15 +211,13 @@ ohos.permission.BUNDLE_ACTIVE_INFO ...@@ -250,15 +211,13 @@ ohos.permission.BUNDLE_ACTIVE_INFO
``` ```
## bundleState.queryBundleStateInfoByInterval ## 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 ...@@ -266,19 +225,16 @@ SystemCapability.ResourceSchedule.UsageStatistics.App
| begin | number | 是 | 起始时间。| | begin | number | 是 | 起始时间。|
| end | number | 是 | 结束时间。| | end | number | 是 | 结束时间。|
- **返回值** **返回值**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise<Array<BundleStateInfo>> | 指定的Promise回调方法。返回指定时间段间隔(天、周、月、年)查询应用使用时长统计信息。| | Promise&lt;Array&lt;BundleStateInfo&gt;&gt; | 指定的Promise回调方法。返回指定时间段间隔(天、周、月、年)查询应用使用时长统计信息。|
- **权限**
ohos.permission.BUNDLE_ACTIVE_INFO
- **示例** **示例**
``` ```
stats.queryBundleStateInfoByInterval(0, 0, 20000000000000).then( res => { bundleState.queryBundleStateInfoByInterval(0, 0, 20000000000000).then( res => {
console.log('BUNDLE_ACTIVE queryBundleStateInfoByInterval promise success.'); console.log('BUNDLE_ACTIVE queryBundleStateInfoByInterval promise success.');
for (let i = 0; i < res.length; i++) { for (let i = 0; i < res.length; i++) {
console.log('BUNDLE_ACTIVE queryBundleStateInfoByInterval promise number : ' + (i + 1)); console.log('BUNDLE_ACTIVE queryBundleStateInfoByInterval promise number : ' + (i + 1));
...@@ -290,29 +246,24 @@ ohos.permission.BUNDLE_ACTIVE_INFO ...@@ -290,29 +246,24 @@ ohos.permission.BUNDLE_ACTIVE_INFO
``` ```
## bundleState.queryBundleActiveStates ## bundleState.queryBundleActiveStates
queryBundleActiveStates(begin: number, end: number, callback: AsyncCallback<Array<BundleActiveState>>): void queryBundleActiveStates(begin: number, end: number, callback: AsyncCallback&lt;Array&lt;BundleActiveState&gt;&gt;): void<br>
通过指定起始和结束时间查询所有应用的事件集合,使用Callback形式返回。<br>
- **系统能力** **需要权限**:ohos.permission.BUNDLE_ACTIVE_INFO
SystemCapability.ResourceSchedule.UsageStatistics.App
- **说明** **系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App
通过指定起始和结束时间查询所有应用的事件集合,使用Callback形式返回。
- **参数** **参数**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| begin | number | 是 | 起始时间。| | begin | number | 是 | 起始时间。|
| end | 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) { if(err.code == 0) {
console.log('BUNDLE_ACTIVE queryBundleActiveStates callback success.'); console.log('BUNDLE_ACTIVE queryBundleActiveStates callback success.');
for (let i = 0; i < res.length; i++) { for (let i = 0; i < res.length; i++) {
...@@ -326,34 +277,29 @@ ohos.permission.BUNDLE_ACTIVE_INFO ...@@ -326,34 +277,29 @@ ohos.permission.BUNDLE_ACTIVE_INFO
``` ```
## bundleState.queryBundleActiveStates ## bundleState.queryBundleActiveStates
queryBundleActiveStates(begin: number, end: number): Promise<Array<BundleActiveState>> queryBundleActiveStates(begin: number, end: number): Promise&lt;Array&lt;BundleActiveState&gt;&gt;<br>
通过指定起始和结束时间查询所有应用的事件集合,使用Promise形式返回。<br>
- **系统能力** **需要权限**:ohos.permission.BUNDLE_ACTIVE_INFO
SystemCapability.ResourceSchedule.UsageStatistics.App
- **说明** **系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App
通过指定起始和结束时间查询所有应用的事件集合,使用Promise形式返回。
- **参数** **参数**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| begin | number | 是 | 起始时间。| | begin | number | 是 | 起始时间。|
| end | number | 是 | 结束时间。| | end | number | 是 | 结束时间。|
- **返回值** **返回值**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise<Array<BundleActiveState>> | 指定的Promise回调方法。返回指定起始和结束时间查询所有应用的事件集合。| | Promise&lt;Array&lt;BundleActiveState&gt;&gt; | 指定的Promise回调方法。返回指定起始和结束时间查询所有应用的事件集合。|
- **权限**
ohos.permission.BUNDLE_ACTIVE_INFO
- **示例** **示例**
``` ```
stats.queryBundleActiveStates(0, 20000000000000).then( res => { bundleState.queryBundleActiveStates(0, 20000000000000).then( res => {
console.log('BUNDLE_ACTIVE queryBundleActiveStates promise success.'); console.log('BUNDLE_ACTIVE queryBundleActiveStates promise success.');
for (let i = 0; i < res.length; i++) { for (let i = 0; i < res.length; i++) {
console.log('BUNDLE_ACTIVE queryBundleActiveStates promise number : ' + (i + 1)); console.log('BUNDLE_ACTIVE queryBundleActiveStates promise number : ' + (i + 1));
...@@ -365,29 +311,23 @@ ohos.permission.BUNDLE_ACTIVE_INFO ...@@ -365,29 +311,23 @@ ohos.permission.BUNDLE_ACTIVE_INFO
``` ```
## bundleState.queryCurrentBundleActiveStates ## bundleState.queryCurrentBundleActiveStates
queryCurrentBundleActiveStates(begin: number, end: number, callback: AsyncCallback<Array<BundleActiveState>>): void queryCurrentBundleActiveStates(begin: number, end: number, callback: AsyncCallback&lt;Array&lt;BundleActiveState&gt;&gt;): void<br>
- **系统能力**
SystemCapability.ResourceSchedule.UsageStatistics.App
- **说明**
通过指定起始和结束时间查询当前应用的事件集合,使用Callback形式返回。 通过指定起始和结束时间查询当前应用的事件集合,使用Callback形式返回。
- **参数** **系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App
**参数**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| begin | number | 是 | 起始时间。| | begin | number | 是 | 起始时间。|
| end | 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) { if(err.code == 0) {
console.log('BUNDLE_ACTIVE queryCurrentBundleActiveStates callback success.'); console.log('BUNDLE_ACTIVE queryCurrentBundleActiveStates callback success.');
for (let i = 0; i < res.length; i++) { for (let i = 0; i < res.length; i++) {
...@@ -401,34 +341,28 @@ SystemCapability.ResourceSchedule.UsageStatistics.App ...@@ -401,34 +341,28 @@ SystemCapability.ResourceSchedule.UsageStatistics.App
``` ```
## bundleState.queryCurrentBundleActiveStates ## bundleState.queryCurrentBundleActiveStates
queryCurrentBundleActiveStates(begin: number, end: number): Promise<Array<BundleActiveState>> queryCurrentBundleActiveStates(begin: number, end: number): Promise&lt;Array&lt;BundleActiveState&gt;&gt;<br>
- **系统能力**
SystemCapability.ResourceSchedule.UsageStatistics.App
- **说明**
通过指定起始和结束时间查询当前应用的事件集合,使用Promise形式返回。 通过指定起始和结束时间查询当前应用的事件集合,使用Promise形式返回。
- **参数** **系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App
**参数**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| begin | number | 是 | 起始时间。| | begin | number | 是 | 起始时间。|
| end | 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.'); console.log('BUNDLE_ACTIVE queryCurrentBundleActiveStates promise success.');
for (let i = 0; i < res.length; i++) { for (let i = 0; i < res.length; i++) {
console.log('BUNDLE_ACTIVE queryCurrentBundleActiveStates promise number : ' + (i + 1)); console.log('BUNDLE_ACTIVE queryCurrentBundleActiveStates promise number : ' + (i + 1));
...@@ -439,58 +373,70 @@ SystemCapability.ResourceSchedule.UsageStatistics.App ...@@ -439,58 +373,70 @@ SystemCapability.ResourceSchedule.UsageStatistics.App
}); });
``` ```
## bundleState.BundleStateInfo ## BundleStateInfo
- **系统能力** 提供应用使用时长的具体信息。
SystemCapability.ResourceSchedule.UsageStatistics.App
- **参数** ### 属性
**系统能力**:以下各项对应的系统能力均为SystemCapability.ResourceSchedule.UsageStatistics.App
提供应用使用时长的具体信息。 | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| 参数名 | 类型 | 必填 | 说明 | | bundleName | string | 是 | 应用包名。|
| -------- | -------- | -------- | -------- | | abilityPrevAccessTime | number | 是 | 应用最后一次使用的时间。|
| bundleName | string | 是 | 应用包名。| | abilityInFgTotalTime | number | 是 | 应用在前台使用的总时间。|
| abilityPrevAccessTime | number | 是 | 应用最后一次使用的时间。| | id | number | 否 | 用户id。<br>本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。|
| abilityInFgTotalTime | number | 是 | 应用在前台使用的总时间。| | 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 ### merge
- **系统能力** merge(toMerge: BundleStateInfo): void
SystemCapability.ResourceSchedule.UsageStatistics.App 合并相同包名的应用使用信息。<br>
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
- **参数** **系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App
提供应用事件的具体信息。 **参数**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 应用包名。| | toMerge | BundleStateInfo | 是 | 相同包名的应用使用统计信息。|
| stateType | number | 是 | 应用事件类型。|
| stateOccurredTime | number | 是 | 应用事件发生的时间戳。|
## bundleState.BundleActiveInfoResponse ## BundleActiveState
- **系统能力** 提供应用事件的具体信息。
SystemCapability.ResourceSchedule.UsageStatistics.App
- **参数** **系统能力**:以下各项对应的系统能力均为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版本中提供使用支持。|
| 参数名 | 类型 | 必填 | 说明 | ## BundleActiveInfoResponse
| -------- | -------- | -------- | -------- | 提供应用使用时长的具体信息。
| [key: string]: BundleStateInfo | BundleStateInfo | 是 | 不同应用的使用时长统计信息。|
## bundleState.IntervalType **系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App
- **系统能力**
SystemCapability.ResourceSchedule.UsageStatistics.App
- **参数** | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| [key: string]: BundleStateInfo | BundleStateInfo | 是 | 不同应用的使用时长统计信息。|
## bundleState.IntervalType
提供应用使用时长的查询类型。
提供查询的类型 **系统能力**:以下各项对应的系统能力均为SystemCapability.ResourceSchedule.UsageStatistics.App
|名称 |默认值 |说明| |名称 |默认值 |说明|
| -------- | -------- | -------- | | -------- | -------- | -------- |
| BY_OPTIMIZED | 0 | 表示系统自己判断最合适的查询类型(天、周、月、年)去查询指定时间段间隔的应用使用时长信息。| | BY_OPTIMIZED | 0 | 表示系统自行判断最合适的查询类型(天、周、月、年)去查询指定时间段间隔的应用使用时长信息。|
| BY_DAILY | 1 | 表示系统按照天去查询指定时间段间隔的应用使用时长信息。| | BY_DAILY | 1 | 表示系统按照天去查询指定时间段间隔的应用使用时长信息。|
| BY_WEEKLY | 2 | 表示系统按照周去查询指定时间段间隔的应用使用时长信息。| | BY_WEEKLY | 2 | 表示系统按照周去查询指定时间段间隔的应用使用时长信息。|
| BY_MONTHLY | 3 | 表示系统按照月去查询指定时间段间隔的应用使用时长信息。| | BY_MONTHLY | 3 | 表示系统按照月去查询指定时间段间隔的应用使用时长信息。|
| BY_ANNUALLY | 4 | 表示系统按照年去查询指定时间段间隔的应用使用时长信息。| | BY_ANNUALLY | 4 | 表示系统按照年去查询指定时间段间隔的应用使用时长信息。|
\ No newline at end of file \ No newline at end of file
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册