AppStateData (系统接口)
定义应用状态信息,可以通过getForegroundApplications获取当前应用的相关信息。
说明:
本模块首批接口从API version 8 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 本模块接口为系统接口。
导入模块
import appManager from '@ohos.app.ability.appManager';
属性
系统能力:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
系统API:本模块被标记为@systemapi,对三方应用隐藏
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
bundleName8+ | string | 否 | Bundle名称。 |
uid8+ | number | 否 | 应用程序的uid。 |
state8+ | number | 否 | 应用状态。 0:初始化状态,应用正在初始化 1:就绪状态,应用已初始化完毕 2:前台状态,应用位于前台 3:获焦状态。(预留状态,当前暂不支持) 4:后台状态,应用位于后台 5:退出状态,应用已退出 |
isSplitScreenMode11+ | boolean | 否 | 判断应用是否进入分屏模式。 true:应用处于分屏模式。 false:应用不处于分屏模式。 |
isFloatingWindowMode11+ | boolean | 否 | 判断应用是否进入悬浮窗模式。 true:应用处于浮窗模式。 false:应用不处于浮窗模式。 |
示例:
import appManager from '@ohos.app.ability.appManager';
function getForegroundAppInfos() {
appManager.getForegroundApplications((error, data) => {
if (error) {
console.log(`getForegroundApplications failed, error.code: ${JSON.stringify(error.code)}, error.message: ${JSON.stringify(error.message)}`);
return;
}
for (let i = 0; i < data.length; i++) {
let appStateData = data[i];
console.log(`appStateData.bundleName: ${appStateData.bundleName}`);
console.log(`appStateData.uid: ${appStateData.uid}`);
console.log(`appStateData.state: ${appStateData.state}`);
console.log(`appStateData.isSplitScreenMode: ${appStateData.isSplitScreenMode}`);
console.log(`appStateData.isFloatingWindowMode: ${appStateData.isFloatingWindowMode}`);
}
});
}