提交 05df3d46 编写于 作者: W wyuanchao

Modify format

Signed-off-by: Nwyuanchao <wangyuanchao5@huawei.com>
上级 67dd61b9
...@@ -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&lt;Array&lt;BundleActiveState&gt;&gt;):void | 通过指定起始和结束时间查询所有应用的事件集合。 | | function queryBundleActiveStates(begin: number, end: number, callback: AsyncCallback&lt;Array&lt;BundleActiveState&gt;&gt;): void | 通过指定起始和结束时间查询所有应用的事件集合。 |
| function queryBundleStateInfos(begin:number, end:number, callback:AsyncCallback&lt;BundleStateInfoResponse&gt;):void | 通过指定起始和结束时间查询应用使用时长统计信息。 | | function queryBundleStateInfos(begin: number, end: number, callback: AsyncCallback&lt;BundleActiveInfoResponse&gt;): void | 通过指定起始和结束时间查询应用使用时长统计信息。 |
| function queryCurrentBundleActiveStates(begin:number, end:number, callback:AsyncCallback&lt;Array&lt;BundleActiveState&gt;&gt;):void | 通过指定起始和结束时间查询当前应用的事件集合。 | | function queryCurrentBundleActiveStates(begin: number, end: number, callback: AsyncCallback&lt;Array&lt;BundleActiveState&gt;&gt;): void | 通过指定起始和结束时间查询当前应用的事件集合。 |
| function queryBundleStateInfoByInterval(byInterval:intervalType, begin:number, end:number, callback:AsyncCallback&lt;Array&lt;BundleStateInfo&gt;&gt;):void | 通过指定时间段间隔(天、周、月、年)查询应用使用时长统计信息。 | | function queryBundleStateInfoByInterval(byInterval: IntervalType, begin: number, end: number, callback: AsyncCallback&lt;Array&lt;BundleStateInfo&gt;&gt;): void | 通过指定时间段间隔(天、周、月、年)查询应用使用时长统计信息。 |
| function queryAppUsagePriorityGroup(callback:AsyncCallback&lt;number&gt;):void | 查询(返回)当前调用者应用的使用优先级群组。 | | function queryAppUsagePriorityGroup(callback: AsyncCallback&lt;number&gt;): void | 查询(返回)当前调用者应用的使用优先级群组。 |
| function isIdleState(bundleName:string, callback:AsyncCallback&lt;boolean&gt;):void | 判断指定Bundle Name的应用当前是否是空闲状态。 | | function isIdleState(bundleName: string, callback: AsyncCallback&lt;boolean&gt;): void | 判断指定Bundle Name的应用当前是否是空闲状态。 |
## 开发步骤 ## 开发步骤
......
...@@ -7,11 +7,11 @@ ...@@ -7,11 +7,11 @@
## 导入模块 ## 导入模块
``` ```
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
- **系统能力** - **系统能力**
SystemCapability.ResourceSchedule.UsageStatistics.AppGroup SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
...@@ -24,7 +24,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup ...@@ -24,7 +24,7 @@ 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。 |
- **权限** - **权限**
无权限 无权限
...@@ -32,7 +32,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup ...@@ -32,7 +32,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
- **示例** - **示例**
``` ```
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,7 +42,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup ...@@ -42,7 +42,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
``` ```
## bundleState.isIdleState ## bundleState.isIdleState
isIdleState(bundleName: string): Promise<boolean>; isIdleState(bundleName: string): Promise&lt;boolean&gt;
- **系统能力** - **系统能力**
SystemCapability.ResourceSchedule.UsageStatistics.AppGroup SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
...@@ -60,7 +60,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup ...@@ -60,7 +60,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise<boolean> | 指定的Promise回调方法。如果指定的bundleName有效,则返回指定bundleName的应用当前是否是空闲状态;否则返回null。 | | Promise&lt;boolean&gt; | 指定的Promise回调方法。如果指定的bundleName有效,则返回指定bundleName的应用当前是否是空闲状态;否则返回null。 |
- **权限** - **权限**
无权限 无权限
...@@ -68,7 +68,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup ...@@ -68,7 +68,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
- **示例** - **示例**
``` ```
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,7 +76,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup ...@@ -76,7 +76,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
``` ```
## bundleState.queryAppUsagePriorityGroup ## bundleState.queryAppUsagePriorityGroup
queryAppUsagePriorityGroup(callback: AsyncCallback<number>): void queryAppUsagePriorityGroup(callback: AsyncCallback&lt;number&gt;): void
- **系统能力** - **系统能力**
SystemCapability.ResourceSchedule.UsageStatistics.AppGroup SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
...@@ -88,7 +88,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup ...@@ -88,7 +88,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback<number> | 是 | 指定的callback回调方法。返回当前调用者应用的使用优先级群组。| | callback | AsyncCallback&lt;number&gt; | 是 | 指定的callback回调方法。返回当前调用者应用的使用优先级群组。|
- **权限** - **权限**
无权限 无权限
...@@ -96,7 +96,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup ...@@ -96,7 +96,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
- **示例** - **示例**
``` ```
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,7 +106,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup ...@@ -106,7 +106,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
``` ```
## bundleState.queryAppUsagePriorityGroup ## bundleState.queryAppUsagePriorityGroup
queryAppUsagePriorityGroup(): Promise<number> queryAppUsagePriorityGroup(): Promise&lt;number&gt;
- **系统能力** - **系统能力**
SystemCapability.ResourceSchedule.UsageStatistics.AppGroup SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
...@@ -118,7 +118,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup ...@@ -118,7 +118,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise<number> | 指定的Promise回调方法。查询(返回)当前调用者应用的使用优先级群组。| | Promise&lt;number&gt; | 指定的Promise回调方法。查询(返回)当前调用者应用的使用优先级群组。|
- **权限** - **权限**
无权限 无权限
...@@ -126,7 +126,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup ...@@ -126,7 +126,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
- **示例** - **示例**
``` ```
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,7 +134,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.AppGroup ...@@ -134,7 +134,7 @@ 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
- **系统能力** - **系统能力**
SystemCapability.ResourceSchedule.UsageStatistics.App SystemCapability.ResourceSchedule.UsageStatistics.App
...@@ -148,7 +148,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.App ...@@ -148,7 +148,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.App
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| begin | number | 是 | 起始时间。| | begin | number | 是 | 起始时间。|
| end | number | 是 | 结束时间。| | end | number | 是 | 结束时间。|
| callback | AsyncCallback<BundleActiveInfoResponse> | 是 | 指定的callback回调方法。返回指定起始和结束时间内应用使用时长统计信息。| | callback | AsyncCallback&lt;BundleActiveInfoResponse&gt; | 是 | 指定的callback回调方法。返回指定起始和结束时间内应用使用时长统计信息。|
- **权限** - **权限**
ohos.permission.BUNDLE_ACTIVE_INFO ohos.permission.BUNDLE_ACTIVE_INFO
...@@ -156,7 +156,7 @@ ohos.permission.BUNDLE_ACTIVE_INFO ...@@ -156,7 +156,7 @@ 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,7 +172,7 @@ ohos.permission.BUNDLE_ACTIVE_INFO ...@@ -172,7 +172,7 @@ 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;
- **系统能力** - **系统能力**
SystemCapability.ResourceSchedule.UsageStatistics.App SystemCapability.ResourceSchedule.UsageStatistics.App
...@@ -191,7 +191,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.App ...@@ -191,7 +191,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.App
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise<BundleActiveInfoResponse> | 指定的Promise回调方法。返回指定起始和结束时间内应用使用时长统计信息。| | Promise&lt;BundleActiveInfoResponse&gt; | 指定的Promise回调方法。返回指定起始和结束时间内应用使用时长统计信息。|
- **权限** - **权限**
ohos.permission.BUNDLE_ACTIVE_INFO ohos.permission.BUNDLE_ACTIVE_INFO
...@@ -199,7 +199,7 @@ ohos.permission.BUNDLE_ACTIVE_INFO ...@@ -199,7 +199,7 @@ 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,7 +213,7 @@ ohos.permission.BUNDLE_ACTIVE_INFO ...@@ -213,7 +213,7 @@ 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
- **系统能力** - **系统能力**
SystemCapability.ResourceSchedule.UsageStatistics.App SystemCapability.ResourceSchedule.UsageStatistics.App
...@@ -228,7 +228,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.App ...@@ -228,7 +228,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.App
| 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 ohos.permission.BUNDLE_ACTIVE_INFO
...@@ -236,7 +236,7 @@ ohos.permission.BUNDLE_ACTIVE_INFO ...@@ -236,7 +236,7 @@ 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,7 +250,7 @@ ohos.permission.BUNDLE_ACTIVE_INFO ...@@ -250,7 +250,7 @@ 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;
- **系统能力** - **系统能力**
SystemCapability.ResourceSchedule.UsageStatistics.App SystemCapability.ResourceSchedule.UsageStatistics.App
...@@ -270,7 +270,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.App ...@@ -270,7 +270,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.App
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise<Array<BundleStateInfo>> | 指定的Promise回调方法。返回指定时间段间隔(天、周、月、年)查询应用使用时长统计信息。| | Promise&lt;Array&lt;BundleStateInfo&gt;&gt; | 指定的Promise回调方法。返回指定时间段间隔(天、周、月、年)查询应用使用时长统计信息。|
- **权限** - **权限**
ohos.permission.BUNDLE_ACTIVE_INFO ohos.permission.BUNDLE_ACTIVE_INFO
...@@ -278,7 +278,7 @@ ohos.permission.BUNDLE_ACTIVE_INFO ...@@ -278,7 +278,7 @@ 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,7 +290,7 @@ ohos.permission.BUNDLE_ACTIVE_INFO ...@@ -290,7 +290,7 @@ 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
- **系统能力** - **系统能力**
SystemCapability.ResourceSchedule.UsageStatistics.App SystemCapability.ResourceSchedule.UsageStatistics.App
...@@ -304,7 +304,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.App ...@@ -304,7 +304,7 @@ 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回调方法。返回指定起始和结束时间查询所有应用的事件集合。|
- **权限** - **权限**
ohos.permission.BUNDLE_ACTIVE_INFO ohos.permission.BUNDLE_ACTIVE_INFO
...@@ -312,7 +312,7 @@ ohos.permission.BUNDLE_ACTIVE_INFO ...@@ -312,7 +312,7 @@ 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,7 +326,7 @@ ohos.permission.BUNDLE_ACTIVE_INFO ...@@ -326,7 +326,7 @@ 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;
- **系统能力** - **系统能力**
SystemCapability.ResourceSchedule.UsageStatistics.App SystemCapability.ResourceSchedule.UsageStatistics.App
...@@ -345,7 +345,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.App ...@@ -345,7 +345,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.App
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise<Array<BundleActiveState>> | 指定的Promise回调方法。返回指定起始和结束时间查询所有应用的事件集合。| | Promise&lt;Array&lt;BundleActiveState&gt;&gt; | 指定的Promise回调方法。返回指定起始和结束时间查询所有应用的事件集合。|
- **权限** - **权限**
ohos.permission.BUNDLE_ACTIVE_INFO ohos.permission.BUNDLE_ACTIVE_INFO
...@@ -353,7 +353,7 @@ ohos.permission.BUNDLE_ACTIVE_INFO ...@@ -353,7 +353,7 @@ 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,7 +365,7 @@ ohos.permission.BUNDLE_ACTIVE_INFO ...@@ -365,7 +365,7 @@ 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
- **系统能力** - **系统能力**
SystemCapability.ResourceSchedule.UsageStatistics.App SystemCapability.ResourceSchedule.UsageStatistics.App
...@@ -379,7 +379,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.App ...@@ -379,7 +379,7 @@ 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回调方法。返回指定起始和结束时间查询当前应用的事件集合。|
- **权限** - **权限**
无权限 无权限
...@@ -387,7 +387,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.App ...@@ -387,7 +387,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.App
- **示例** - **示例**
``` ```
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,7 +401,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.App ...@@ -401,7 +401,7 @@ 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;
- **系统能力** - **系统能力**
SystemCapability.ResourceSchedule.UsageStatistics.App SystemCapability.ResourceSchedule.UsageStatistics.App
...@@ -420,7 +420,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.App ...@@ -420,7 +420,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.App
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise<Array<BundleActiveState>> | 指定的Promise回调方法。返回指定起始和结束时间查询当前应用的事件集合。| | Promise&lt;Array&lt;BundleActiveState&gt;&gt; | 指定的Promise回调方法。返回指定起始和结束时间查询当前应用的事件集合。|
- **权限** - **权限**
无权限 无权限
...@@ -428,7 +428,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.App ...@@ -428,7 +428,7 @@ SystemCapability.ResourceSchedule.UsageStatistics.App
- **示例** - **示例**
``` ```
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 +439,63 @@ SystemCapability.ResourceSchedule.UsageStatistics.App ...@@ -439,58 +439,63 @@ SystemCapability.ResourceSchedule.UsageStatistics.App
}); });
``` ```
## bundleState.BundleStateInfo ## BundleStateInfo
- **系统能力** 提供应用使用时长的具体信息。
SystemCapability.ResourceSchedule.UsageStatistics.App
- **参数** **系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App
提供应用使用时长的具体信息。 ### 属性
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 应用包名。| | bundleName | string | 是 | 应用包名。|
| abilityPrevAccessTime | number | 是 | 应用最后一次使用的时间。| | abilityPrevAccessTime | number | 是 | 应用最后一次使用的时间。|
| abilityInFgTotalTime | number | 是 | 应用在前台使用的总时间。| | abilityInFgTotalTime | number | 是 | 应用在前台使用的总时间。|
| id | number | 否 | 用户id,本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。|
| abilityPrevSeenTime | number | 否 | 应用最后一次在前台可见的时间,本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。|
| abilitySeenTotalTime | number | 否 | 应用在前台可见的总时间,本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。|
| fgAbilityAccessTotalTime | number | 否 | 应用访问前台的总时间,本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。|
| fgAbilityPrevAccessTime | number | 否 | 应用最后一次访问前台的时间,本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。|
| infosBeginTime | number | 否 | BundleActiveInfo对象中第一条应用使用统计的记录时间,本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。|
| infosBeginTime | number | 否 | BundleActiveInfo对象中最后一条应用使用统计的记录时间,本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。|
## bundleState.BundleActiveState ### merge
- **系统能力** merge(toMerge: BundleStateInfo): void
SystemCapability.ResourceSchedule.UsageStatistics.App
- **参数** 合并相同包名的应用使用信息,本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
提供应用事件的具体信息。 ## BundleActiveState
提供应用事件的具体信息。
| 参数名 | 类型 | 必填 | 说明 | **系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App
| -------- | -------- | -------- | -------- |
| bundleName | string | 是 | 应用包名。|
| stateType | number | 是 | 应用事件类型。|
| stateOccurredTime | number | 是 | 应用事件发生的时间戳。|
## bundleState.BundleActiveInfoResponse | 参数名 | 类型 | 必填 | 说明 |
- **系统能力** | -------- | -------- | -------- | -------- |
SystemCapability.ResourceSchedule.UsageStatistics.App | bundleName | string | 是 | 应用包名。|
| stateType | number | 是 | 应用事件类型。|
| stateOccurredTime | number | 是 | 应用事件发生的时间戳。|
| appUsagePriorityGroup | number | 否 | 应用程序的使用优先级组,本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。|
| indexOfLink | string | 否 | 快捷方式id,本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。|
| nameOfClass | string | 否 | 类名,本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。|
- **参数** ## BundleActiveInfoResponse
提供应用使用时长的具体信息。
提供应用使用时长的具体信息。 **系统能力**:SystemCapability.ResourceSchedule.UsageStatistics.App
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| [key: string]: BundleStateInfo | BundleStateInfo | 是 | 不同应用的使用时长统计信息。| | [key: string]: BundleStateInfo | BundleStateInfo | 是 | 不同应用的使用时长统计信息。|
## bundleState.IntervalType ## bundleState.IntervalType
- **系统能力** 提供应用使用时长的查询类型。
SystemCapability.ResourceSchedule.UsageStatistics.App
- **参数**
提供查询的类型 **系统能力**: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.
先完成此消息的编辑!
想要评论请 注册