xref: /docs/zh-cn/application-dev/reference/apis-ability-kit/js-apis-inner-application-appStateData-sys.md

 # AppStateData (系统接口)

定义应用状态信息，可以通过[getForegroundApplications](js-apis-app-ability-appManager-sys.md#appmanagergetforegroundapplications)获取当前应用的相关信息。

> **说明：**
> 
> 本模块首批接口从API version 8 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
> 本模块接口为系统接口。

## 导入模块

```ts
import { appManager } from '@kit.AbilityKit';
```

## 属性

**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core

**系统API**：本模块被标记为@systemapi，对三方应用隐藏

| 名称                      | 类型   | 必填  | 说明       |
| ------------------------- | ------ | ---- | --------- |
| bundleName<sup>8+</sup>   | string | 否   | Bundle名称。 |
| uid<sup>8+</sup>          | number | 否   | 应用程序的uid。   |
| state<sup>8+</sup>        | number | 否   | 应用状态。<br>0：初始化状态，应用正在初始化<br>1：就绪状态，应用已初始化完毕<br>2：前台状态，应用位于前台<br>3：获焦状态。（预留状态，当前暂不支持）<br>4：后台状态，应用位于后台<br>5：退出状态，应用已退出 |
| isSplitScreenMode<sup>11+</sup> | boolean | 否 | 判断应用是否进入分屏模式。<br>true:应用处于分屏模式。<br>false:应用不处于分屏模式。 |
| isFloatingWindowMode<sup>11+</sup> | boolean | 否 | 判断应用是否进入悬浮窗模式。<br>true:应用处于浮窗模式。<br>false:应用不处于浮窗模式。 |

**示例：**

```ts
import { appManager } from '@kit.AbilityKit';

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}`);
    }
  });
}
```