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