鴻蒙開發(fā)接口應用程序包管理：【@ohos.bundleState (設備使用信息統(tǒng)計)】
設備使用信息統(tǒng)計
本模塊提供設備使用信息統(tǒng)計能力。
設備使用信息統(tǒng)計，系統(tǒng)應用可調(diào)用接口實現(xiàn)如下功能：
- 查詢設備上各應用在不同時間段的使用時長、各應用的事件（前臺、后臺、長時任務開始、長時任務結(jié)束）信息及各應用的通知次數(shù)信息。
- 查詢系統(tǒng)事件（休眠、喚醒、解鎖、鎖屏）統(tǒng)計信息。
- 查詢應用分組信息（其他應用和自身應用）。
- 查詢應用空閑狀態(tài)（其他應用和自身應用）。
- 設置應用分組信息（其他應用）。
- 注冊和解除注冊應用分組變化監(jiān)聽。
三方應用可調(diào)用接口實現(xiàn)如下功能：
- 查詢應用空閑狀態(tài)（僅限自身應用）。
- 查詢應用分組信息（僅限自身應用）。
- 查詢應用事件（僅限自身應用）。
說明： 本模塊首批接口從API version 7開始支持。后續(xù)版本的新增接口，采用上角標單獨標記接口的起始版本。 開發(fā)前請熟悉鴻蒙開發(fā)指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]點擊或者復制轉(zhuǎn)到。
導入模塊
import bundleState from '@ohos.bundleState'
bundleState.isIdleState
isIdleState(bundleName: string, callback: AsyncCallback): void
判斷指定bundleName的應用當前是否是空閑狀態(tài)，使用Callback形式返回。
系統(tǒng)能力 ：SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
參數(shù) ：
| 參數(shù)名 | 類型 | 必填 | 說明 |
|---|---|---|---|
| bundleName | string | 是 | 應用的bundleName。 |
| callback | AsyncCallback | 是 | 指定的callback回調(diào)方法。如果指定的bundleName有效，則返回指定bundleName的應用當前是否是空閑狀態(tài)；否則返回null。 |
示例 ：
bundleState.isIdleState("com.ohos.camera", (err, res) = > {
if (err) {
console.log('BUNDLE_ACTIVE isIdleState callback failed, because: ' + err.code);
} else {
console.log('BUNDLE_ACTIVE isIdleState callback succeeded, result: ' + JSON.stringify(res));
}
});
bundleState.isIdleState
isIdleState(bundleName: string): Promise
判斷指定bundleName的應用當前是否是空閑狀態(tài)，使用Promise形式返回。
系統(tǒng)能力 ：SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
參數(shù) ：
| 參數(shù)名 | 類型 | 必填 | 說明 |
|---|---|---|---|
| bundleName | string | 是 | 應用的bundleName。 |
返回值 ：
| 類型 | 說明 |
|---|---|
| Promise | 指定的Promise回調(diào)方法。如果指定的bundleName有效，則返回指定bundleName的應用當前是否是空閑狀態(tài)；否則返回null。 |
示例 ：
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);
});
bundleState.queryAppUsagePriorityGroup
queryAppUsagePriorityGroup(callback: AsyncCallback): void
查詢（返回）當前調(diào)用者應用的使用優(yōu)先級群組，使用Callback形式返回。
系統(tǒng)能力 ：SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
參數(shù) ：
| 參數(shù)名 | 類型 | 必填 | 說明 |
|---|---|---|---|
| callback | AsyncCallback | 是 | 指定的callback回調(diào)方法。返回當前調(diào)用者應用的使用優(yōu)先級群組。 |
示例 ：
bundleState.queryAppUsagePriorityGroup((err, res) = > {
if (err) {
console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup callback failed. because: ' + err.code);
} else {
console.log('BUNDLE_ACTIVE queryAppUsagePriorityGroup callback succeeded. result: ' + JSON.stringify(res));
}
});
bundleState.queryAppUsagePriorityGroup
queryAppUsagePriorityGroup(): Promise
查詢（返回）當前調(diào)用者應用的使用優(yōu)先級群組，使用Promise形式返回。
系統(tǒng)能力 ：SystemCapability.ResourceSchedule.UsageStatistics.AppGroup
返回值 ：
| 類型 | 說明 |
|---|---|
| Promise | 指定的Promise回調(diào)方法。查詢（返回）當前調(diào)用者應用的使用優(yōu)先級群組。 |
示例 ：
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);
});
bundleState.queryBundleStateInfos
queryBundleStateInfos(begin: number, end: number, callback: AsyncCallback): void
通過指定起始和結(jié)束時間查詢應用使用時長統(tǒng)計信息，使用Callback形式返回。
需要權限 ：ohos.permission.BUNDLE_ACTIVE_INFO
系統(tǒng)能力 ：SystemCapability.ResourceSchedule.UsageStatistics.App
系統(tǒng)API ：此接口為系統(tǒng)接口，三方應用不支持調(diào)用。
參數(shù) ：
| 參數(shù)名 | 類型 | 必填 | 說明 |
|---|---|---|---|
| begin | number | 是 | 起始時間。 |
| end | number | 是 | 結(jié)束時間。 |
| callback | AsyncCallback<[BundleActiveInfoResponse]> | 是 | 指定的callback回調(diào)方法。返回指定起始和結(jié)束時間內(nèi)應用使用時長統(tǒng)計信息。 |
示例 ：
bundleState.queryBundleStateInfos(0, 20000000000000, (err, res) = > {
if (err) {
console.log('BUNDLE_ACTIVE queryBundleStateInfos callback failed, because: ' + err.code);
} else {
console.log('BUNDLE_ACTIVE queryBundleStateInfos callback success.');
let i = 1;
for(let key in res){
console.log('BUNDLE_ACTIVE queryBundleStateInfos callback number : ' + i);
console.log('BUNDLE_ACTIVE queryBundleStateInfos callback result ' + JSON.stringify(res[key]));
i++;
}
}
});
bundleState.queryBundleStateInfos
queryBundleStateInfos(begin: number, end: number): Promise
通過指定起始和結(jié)束時間查詢應用使用時長統(tǒng)計信息，使用Promise形式返回。
需要權限 ：ohos.permission.BUNDLE_ACTIVE_INFO
系統(tǒng)能力 ：SystemCapability.ResourceSchedule.UsageStatistics.App
系統(tǒng)API ：此接口為系統(tǒng)接口，三方應用不支持調(diào)用。
參數(shù) ：
| 參數(shù)名 | 類型 | 必填 | 說明 |
|---|---|---|---|
| begin | number | 是 | 起始時間。 |
| end | number | 是 | 結(jié)束時間。 |
返回值 ：
| 類型 | 說明 |
|---|---|
| Promise<[BundleActiveInfoResponse]> | 指定的Promise回調(diào)方法。返回指定起始和結(jié)束時間內(nèi)應用使用時長統(tǒng)計信息。 |
示例 ：
bundleState.queryBundleStateInfos(0, 20000000000000).then( res = > {
console.log('BUNDLE_ACTIVE queryBundleStateInfos promise success.');
let i = 1;
for(let key in res){
console.log('BUNDLE_ACTIVE queryBundleStateInfos promise number : ' + i);
console.log('BUNDLE_ACTIVE queryBundleStateInfos promise result ' + JSON.stringify(res[key]));
i++;
}
}).catch( err = > {
console.log('BUNDLE_ACTIVE queryBundleStateInfos promise failed, because: ' + err.code);
});
bundleState.queryBundleStateInfoByInterval
queryBundleStateInfoByInterval(byInterval: IntervalType, begin: number, end: number, callback: AsyncCallback>): void
通過指定時間段間隔（天、周、月、年）查詢應用使用時長統(tǒng)計信息，使用Callback形式返回。
需要權限 ：ohos.permission.BUNDLE_ACTIVE_INFO
系統(tǒng)能力 ：SystemCapability.ResourceSchedule.UsageStatistics.App
系統(tǒng)API ：此接口為系統(tǒng)接口，三方應用不支持調(diào)用。
參數(shù) ：
| 參數(shù)名 | 類型 | 必填 | 說明 |
|---|---|---|---|
| byInterval | [IntervalType] | 是 | 查詢類型。 |
| begin | number | 是 | 起始時間。 |
| end | number | 是 | 結(jié)束時間。 |
| callback | AsyncCallback> | 是 | 指定的callback回調(diào)方法。返回指定時間段間隔（天、周、月、年）查詢應用使用時長統(tǒng)計信息。 |
示例 ：
bundleState.queryBundleStateInfoByInterval(0, 0, 20000000000000, (err, res) = > {
if (err) {
console.log('BUNDLE_ACTIVE queryBundleStateInfoByInterval callback failed, because: ' + err.code);
} else {
console.log('BUNDLE_ACTIVE queryBundleStateInfoByInterval callback success.');
for (let i = 0; i < res.length; i++) {
console.log('BUNDLE_ACTIVE queryBundleStateInfoByInterval callback number : ' + (i + 1));
console.log('BUNDLE_ACTIVE queryBundleStateInfoByInterval callback result ' + JSON.stringify(res[i]));
}
}
});
bundleState.queryBundleStateInfoByInterval
queryBundleStateInfoByInterval(byInterval: IntervalType, begin: number, end: number): Promise>
通過指定時間段間隔（天、周、月、年）查詢應用使用時長統(tǒng)計信息，使用Promise形式返回。
需要權限 ：ohos.permission.BUNDLE_ACTIVE_INFO
系統(tǒng)能力 ：SystemCapability.ResourceSchedule.UsageStatistics.App
系統(tǒng)API ：此接口為系統(tǒng)接口，三方應用不支持調(diào)用。
參數(shù) ：
| 參數(shù)名 | 類型 | 必填 | 說明 |
|---|---|---|---|
| byInterval | [IntervalType] | 是 | 查詢類型。 |
| begin | number | 是 | 起始時間。 |
| end | number | 是 | 結(jié)束時間。 |
返回值 ：
| 類型 | 說明 |
|---|---|
| Promise> | 指定的Promise回調(diào)方法。返回指定時間段間隔（天、周、月、年）查詢應用使用時長統(tǒng)計信息。 |
示例 ：
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));
console.log('BUNDLE_ACTIVE queryBundleStateInfoByInterval promise result ' + JSON.stringify(res[i]));
}
}).catch( err = > {
console.log('BUNDLE_ACTIVE queryBundleStateInfoByInterval promise failed, because: ' + err.code);
});
bundleState.queryBundleActiveStates
queryBundleActiveStates(begin: number, end: number, callback: AsyncCallback>): void
通過指定起始和結(jié)束時間查詢所有應用的事件集合，使用Callback形式返回。
需要權限 ：ohos.permission.BUNDLE_ACTIVE_INFO
系統(tǒng)能力 ：SystemCapability.ResourceSchedule.UsageStatistics.App
系統(tǒng)API ：此接口為系統(tǒng)接口，三方應用不支持調(diào)用。
參數(shù) ：
| 參數(shù)名 | 類型 | 必填 | 說明 |
|---|---|---|---|
| begin | number | 是 | 起始時間。 |
| end | number | 是 | 結(jié)束時間。 |
| callback | AsyncCallback> | 是 | 指定的callback回調(diào)方法。返回指定起始和結(jié)束時間查詢所有應用的事件集合。 |
示例 ：
bundleState.queryBundleActiveStates(0, 20000000000000, (err, res) = > {
if (err) {
console.log('BUNDLE_ACTIVE queryBundleActiveStates callback failed, because: ' + err.code);
} else {
console.log('BUNDLE_ACTIVE queryBundleActiveStates callback success.');
for (let i = 0; i < res.length; i++) {
console.log('BUNDLE_ACTIVE queryBundleActiveStates callback number : ' + (i + 1));
console.log('BUNDLE_ACTIVE queryBundleActiveStates callback result ' + JSON.stringify(res[i]));
}
}
});
bundleState.queryBundleActiveStates
queryBundleActiveStates(begin: number, end: number): Promise>
通過指定起始和結(jié)束時間查詢所有應用的事件集合，使用Promise形式返回。
需要權限 ：ohos.permission.BUNDLE_ACTIVE_INFO
系統(tǒng)能力 ：SystemCapability.ResourceSchedule.UsageStatistics.App
系統(tǒng)API ：此接口為系統(tǒng)接口，三方應用不支持調(diào)用。
參數(shù) ：
| 參數(shù)名 | 類型 | 必填 | 說明 |
|---|---|---|---|
| begin | number | 是 | 起始時間。 |
| end | number | 是 | 結(jié)束時間。 |
返回值 ：
| 類型 | 說明 |
|---|---|
| Promise> | 指定的Promise回調(diào)方法。返回指定起始和結(jié)束時間查詢所有應用的事件集合。 |
示例 ：
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));
console.log('BUNDLE_ACTIVE queryBundleActiveStates promise result ' + JSON.stringify(res[i]));
}
}).catch( err = > {
console.log('BUNDLE_ACTIVE queryBundleActiveStates promise failed, because: ' + err.code);
});
bundleState.queryCurrentBundleActiveStates
queryCurrentBundleActiveStates(begin: number, end: number, callback: AsyncCallback>): void
通過指定起始和結(jié)束時間查詢當前應用的事件集合，使用Callback形式返回。
系統(tǒng)能力 ：SystemCapability.ResourceSchedule.UsageStatistics.App
參數(shù) ：
| 參數(shù)名 | 類型 | 必填 | 說明 |
|---|---|---|---|
| begin | number | 是 | 起始時間。 |
| end | number | 是 | 結(jié)束時間。 |
| callback | AsyncCallback> | 是 | 指定的callback回調(diào)方法。返回指定起始和結(jié)束時間查詢當前應用的事件集合。 |
示例 ：
bundleState.queryCurrentBundleActiveStates(0, 20000000000000, (err, res) = > {
if (err) {
console.log('BUNDLE_ACTIVE queryCurrentBundleActiveStates callback failed, because: ' + err.code);
} else {
console.log('BUNDLE_ACTIVE queryCurrentBundleActiveStates callback success.');
for (let i = 0; i < res.length; i++) {
console.log('BUNDLE_ACTIVE queryCurrentBundleActiveStates callback number : ' + (i + 1));
console.log('BUNDLE_ACTIVE queryCurrentBundleActiveStates callback result ' + JSON.stringify(res[i]));
}
}
});
bundleState.queryCurrentBundleActiveStates
queryCurrentBundleActiveStates(begin: number, end: number): Promise>
通過指定起始和結(jié)束時間查詢當前應用的事件集合，使用Promise形式返回。
系統(tǒng)能力 ：SystemCapability.ResourceSchedule.UsageStatistics.App
參數(shù) ：
| 參數(shù)名 | 類型 | 必填 | 說明 |
|---|---|---|---|
| begin | number | 是 | 起始時間。 |
| end | number | 是 | 結(jié)束時間。 |
返回值 ：
| 類型 | 說明 |
|---|---|
| Promise> | 指定的Promise回調(diào)方法。返回指定起始和結(jié)束時間查詢當前應用的事件集合。 |
示例 ：
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));
console.log('BUNDLE_ACTIVE queryCurrentBundleActiveStates promise result ' + JSON.stringify(res[i]));
}
}).catch( err = > {
console.log('BUNDLE_ACTIVE queryCurrentBundleActiveStates promise failed, because: ' + err.code);
});
bundleState.getRecentlyUsedModules9+
getRecentlyUsedModules(maxNum?: number): Promise>
據(jù)maxNum，查詢FA使用記錄，使用Promise形式返回不超過maxNum條FA使用記錄，F(xiàn)A使用記錄由近及遠排序，maxNum最大為1000。
需要權限 ：ohos.permission.BUNDLE_ACTIVE_INFO
系統(tǒng)能力 ：SystemCapability.ResourceSchedule.UsageStatistics.App
系統(tǒng)API ：此接口為系統(tǒng)接口，三方應用不支持調(diào)用。
參數(shù) ：
| 參數(shù)名 | 類型 | 必填 | 說明 |
|---|---|---|---|
| maxNum | number | 否 | 返回條目的最大數(shù)量，最多支持1000條。若不填寫，則默認為1000。 |
返回值 ：
| 類型 | 說明 |
|---|---|
| Promise> | 指定的Promise回調(diào)方法。返回不超過maxNum條FA使用記錄。 |
示例 ：
bundleState.getRecentlyUsedModules(1000).then( res = > {
console.log('BUNDLE_ACTIVE getRecentlyUsedModules promise succeeded');
for (let i = 0; i < res.length; i++) {
console.log('BUNDLE_ACTIVE getRecentlyUsedModules promise number : ' + (i + 1));
console.log('BUNDLE_ACTIVE getRecentlyUsedModules promise result ' + JSON.stringify(res[i]));
}
}).catch( err= > {
console.log('BUNDLE_ACTIVE getRecentlyUsedModules promise failed, because: ' + err.code);
});
// 無maxNum參數(shù)調(diào)用方式
bundleState.getRecentlyUsedModules().then( res = > {
console.log('BUNDLE_ACTIVE getRecentlyUsedModules promise succeeded');
for (let i = 0; i < res.length; i++) {
console.log('BUNDLE_ACTIVE getRecentlyUsedModules promise number : ' + (i + 1));
console.log('BUNDLE_ACTIVE getRecentlyUsedModules promise result ' + JSON.stringify(res[i]));
}
}).catch( err= > {
console.log('BUNDLE_ACTIVE getRecentlyUsedModules promise failed, because: ' + err.code);
});
bundleState.getRecentlyUsedModules9+
getRecentlyUsedModules(maxNum?: number, callback: AsyncCallback>): void
查詢FA使用記錄。使用CallBack形式返回數(shù)量最大不超過maxNum設置的值，F(xiàn)A使用記錄由近及遠排序，maxNum最大為1000。
需要權限 ：ohos.permission.BUNDLE_ACTIVE_INFO
系統(tǒng)能力 ：SystemCapability.ResourceSchedule.UsageStatistics.App
系統(tǒng)API ：此接口為系統(tǒng)接口，三方應用不支持調(diào)用。
參數(shù) ：
| 參數(shù)名 | 類型 | 必填 | 說明 |
|---|---|---|---|
| maxNum | number | 否 | 返回條目的最大數(shù)量，最多支持1000條。若不填寫，則默認為1000。 |
| callback | AsyncCallback> | 是 | 指定的CallBack回調(diào)方法。返回不超過maxNum條FA使用記錄。 |
示例 ：
bundleState.getRecentlyUsedModules(1000,(err, res) = > {
if(err) {
console.log('BUNDLE_ACTIVE getRecentlyUsedModules callback failed, because: ' + err.code);
} else {
console.log('BUNDLE_ACTIVE getRecentlyUsedModules callback succeeded.');
for (let i = 0; i < res.length; i++) {
console.log('BUNDLE_ACTIVE getRecentlyUsedModules callback number : ' + (i + 1));
console.log('BUNDLE_ACTIVE getRecentlyUsedModules callback result ' + JSON.stringify(res[i]));
}
}
});
// 無maNum參數(shù)調(diào)用方式
bundleState.getRecentlyUsedModules((err, res) = > {
if(err) {
console.log('BUNDLE_ACTIVE getRecentlyUsedModules callback failed, because: ' + err.code);
} else {
console.log('BUNDLE_ACTIVE getRecentlyUsedModules callback succeeded.');
for (let i = 0; i < res.length; i++) {
console.log('BUNDLE_ACTIVE getRecentlyUsedModules callback number : ' + (i + 1));
console.log('BUNDLE_ACTIVE getRecentlyUsedModules callback result ' + JSON.stringify(res[i]));
}
}
});
BundleActiveModuleInfo9+
FA的使用信息的屬性集合。
系統(tǒng)能力 ：以下各項對應的系統(tǒng)能力均為SystemCapability.ResourceSchedule.UsageStatistics.App
| 參數(shù)名 | 類型 | 必填 | 說明 |
|---|---|---|---|
| deviceId | string | 否 | FA所屬deviceId。 |
| bundleName | string | 是 | FA所屬應用包名。 |
| moduleName | string | 是 | FA所屬module名。 |
| abilityName | string | 否 | FA的MainAbility名。 |
| appLabelId | number | 否 | FA的應用labelId。 |
| labelId | number | 否 | FA所屬module的labelId。 |
| descriptionId | number | 否 | FA所屬的應用descriptionId。 |
| abilityLableId | number | 否 | FA的MainAbility labelId。 |
| abilityDescriptionId | number | 否 | FA的MainAbility descriptionId。 |
| abilityIconId | number | 否 | FA的MainAbility iconId。 |
| launchedCount | number | 是 | FA的啟動次數(shù)。 |
| lastModuleUsedTime | number | 是 | FA的上一次使用時間。 |
| formRecords | Array<[BundleActiveFormInfo]> | 是 | FA中卡片的使用記錄。 |
BundleActiveFormInfo9+
FA卡片的使用信息的屬性集合。
系統(tǒng)能力 ：以下各項對應的系統(tǒng)能力均為SystemCapability.ResourceSchedule.UsageStatistics.App
| 參數(shù)名 | 類型 | 必填 | 說明 |
|---|---|---|---|
| formName | string | 是 | 卡片名稱。 |
| formDimension | number | 是 | 卡片尺寸。 |
| formId | number | 是 | 卡片Id。 |
| formLastUsedTime | number | 是 | 卡片的上一次點擊時間。 |
| count | number | 是 | 卡片的點擊次數(shù)。 |
BundleStateInfo
提供應用使用時長的具體信息。
屬性
系統(tǒng)能力 ：以下各項對應的系統(tǒng)能力均為SystemCapability.ResourceSchedule.UsageStatistics.App
| 參數(shù)名 | 類型 | 必填 | 說明 |
|---|---|---|---|
| bundleName | string | 是 | 應用包名。 |
| abilityPrevAccessTime | 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對象中第一條應用使用統(tǒng)計的記錄時間。 本接口在OpenHarmony 3.1 Release版本僅為接口定義，暫不支持使用。接口將在OpenHarmony 3.1 MR版本中提供使用支持。 |
| infosEndTime | number | 否 | BundleActiveInfo對象中最后一條應用使用統(tǒng)計的記錄時間。 本接口在OpenHarmony 3.1 Release版本僅為接口定義，暫不支持使用。接口將在OpenHarmony 3.1 MR版本中提供使用支持。 |
merge
merge(toMerge: BundleStateInfo): void
合并相同包名的應用使用信息。
系統(tǒng)能力 ：SystemCapability.ResourceSchedule.UsageStatistics.App
參數(shù) ：
| 參數(shù)名 | 類型 | 必填 | 說明 |
|---|---|---|---|
| toMerge | [BundleStateInfo] | 是 | 相同包名的應用使用統(tǒng)計信息。 |
BundleActiveState
提供應用事件的具體信息。
系統(tǒng)能力 ：以下各項對應的系統(tǒng)能力均為SystemCapability.ResourceSchedule.UsageStatistics.App
| 參數(shù)名 | 類型 | 必填 | 說明 |
|---|---|---|---|
| bundleName | string | 是 | 應用包名。 |
| stateType | number | 是 | 應用事件類型。 |
| stateOccurredTime | number | 是 | 應用事件發(fā)生的時間戳。 |
| appUsagePriorityGroup | number | 否 | 應用程序的使用優(yōu)先級組。 本接口在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
提供應用使用時長的具體信息。
系統(tǒng)能力 ：SystemCapability.ResourceSchedule.UsageStatistics.App
| 參數(shù)名 | 類型 | 必填 | 說明 |
|---|---|---|---|
| [key: string]: BundleStateInfo | [key: string]: [BundleStateInfo] | 是 | 不同應用的使用時長統(tǒng)計信息。HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿 |
IntervalType
提供應用使用時長的查詢類型。
系統(tǒng)能力 ：以下各項對應的系統(tǒng)能力均為SystemCapability.ResourceSchedule.UsageStatistics.App
| 名稱 | 默認值 | 說明 |
|---|---|---|
| BY_OPTIMIZED | 0 | 表示系統(tǒng)自行判斷最合適的查詢類型（天、周、月、年）去查詢指定時間段間隔的應用使用時長信息。 |
| BY_DAILY | 1 | 表示系統(tǒng)按照天去查詢指定時間段間隔的應用使用時長信息。 |
| BY_WEEKLY | 2 | 表示系統(tǒng)按照周去查詢指定時間段間隔的應用使用時長信息。 |
| BY_MONTHLY | 3 | 表示系統(tǒng)按照月去查詢指定時間段間隔的應用使用時長信息。 |
| BY_ANNUALLY | 4 | 表示系統(tǒng)按照年去查詢指定時間段間隔的應用使用時長信息。 |
-
移動開發(fā)
+關注
關注
0文章
52瀏覽量
9634 -
鴻蒙系統(tǒng)
+關注
關注
183文章
2630瀏覽量
66043 -
HarmonyOS
+關注
關注
79文章
1954瀏覽量
29897 -
OpenHarmony
+關注
關注
25文章
3607瀏覽量
15956 -
鴻蒙OS
+關注
關注
0文章
188瀏覽量
4346
發(fā)布評論請先 登錄
相關推薦
鴻蒙開發(fā)接口應用程序包管理：【@ohos.zlib (Zip模塊)】
鴻蒙開發(fā)接口應用程序包管理：【ApplicationInfo】
鴻蒙開發(fā)接口應用程序包管理：【BundleInfo】
鴻蒙原生應用元服務開發(fā)-位置服務獲取設備信息開發(fā)
OpenHarmony應用程序包整體說明
鴻蒙開發(fā)實戰(zhàn)：【包管理子系統(tǒng)】
鴻蒙開發(fā)接口應用程序包管理：【Bundle模塊(JS端SDK接口)】
鴻蒙開發(fā)接口應用程序包管理：【AbilityInfo】
鴻蒙開發(fā)接口應用程序包管理：【CustomizeData】
鴻蒙開發(fā)接口應用程序包管理：【ExtensionAbilityInfo】
鴻蒙開發(fā)接口應用程序包管理：【HapModuleInfo】
鴻蒙開發(fā)接口應用程序包管理：【Metadata】
鴻蒙開發(fā)接口應用程序包管理：【ModuleInfo】
鴻蒙開發(fā)接口數(shù)據(jù)管理：【@ohos.data.distributedData (分布式數(shù)據(jù)管理)】
工商網(wǎng)監(jiān)
評論