1# AbilityStateData
2
3定义Ability状态信息，可以通过[on](js-apis-app-ability-appManager.md#appmanageronapplicationstate)注册生命周期变化监听后，通过[ApplicationStateObserver](js-apis-inner-application-applicationStateObserver.md)的onAbilityStateChanged生命周期回调获取。
4
5> **说明：**
6>
7> 本模块首批接口从API version 14开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
8
9## 导入模块
10
11```ts
12import { appManager } from '@kit.AbilityKit';
13```
14
15## 属性
16
17**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
18
19| 名称                     | 类型     | 可读 | 可写 | 说明                       |
20| ----------------------- | ---------| ---- | ---- | ------------------------- |
21| pid                     | number   | 是   | 否   | 进程ID。                    |
22| bundleName              | string   | 是   | 否  | 应用Bundle名称。          |
23| abilityName            | string   | 是   | 否   | Ability名称。               |
24| uid                    | number   | 是   | 否   | 用户ID。                  |
25| state                   | number   | 是   | 否   | Ability状态。<br>- Stage模型：UIAbility的状态参见[Ability状态](#ability状态)；ExtensionAbility的状态参见[Extension状态](#extension状态)。<br>- FA模型：参见[Ability状态](#ability状态)。                |
26| moduleName | string   | 是   | 否   | Ability所属的HAP的名称。    |
27| abilityType | number | 是   | 否   | [Ability类型](#ability类型)：页面或服务等。 |
28| isAtomicService | boolean   | 是  | 否  | 判断Ability所属的应用是否是原子化服务。<br>true:Ability所属的应用是原子化服务。<br>false:Ability所属的应用不是原子化服务。     |
29| appCloneIndex          | number   | 是   | 否   | 分身应用索引。                  |
30
31### Ability状态
32
33| 值   | 状态                       | 说明                   |
34| ---- | -------------------------- | ---------------------- |
35| 0    | ABILITY_STATE_CREATE       | Ability正在创建中。      |
36| 1    | ABILITY_STATE_READY        | Ability已创建完成。      |
37| 2    | ABILITY_STATE_FOREGROUND   | Ability处于前台。        |
38| 3    | ABILITY_STATE_FOCUS        | Ability已经获焦。        |
39| 4    | ABILITY_STATE_BACKGROUND   | Ability处于后台。        |
40| 5    | ABILITY_STATE_TERMINATED   | Ability已经销毁。        |
41| 7    | ABILITY_STATE_CONNECTED    | 后台服务已被客户端连接。 |
42| 8    | ABILITY_STATE_DISCONNECTED | 后台服务客户端断开连接。 |
43
44### Extension状态
45| 值   | 状态    | 说明                  |
46| ---- | -------------------------- | ---------------------- |
47| 0    | EXTENSION_STATE_CREATE     | ExtensionAbility正在创建中。  |
48| 1    | EXTENSION_STATE_READY      | ExtensionAbility已创建完成。  |
49| 2    | EXTENSION_STATE_CONNECTED  | ExtensionAbility已被客户端连接。  |
50| 3    | EXTENSION_STATE_DISCONNECTED | ExtensionAbility客户端断开连接。 |
51| 4    | EXTENSION_STATE_TERMINATED  | ExtensionAbility已经销毁。  |
52
53### Ability类型
54
55| 值   | 状态    | 说明                  |
56| ---- | ------- | --------------------- |
57| 0    | UNKNOWN | 未知类型。              |
58| 1    | PAGE    | UI界面类型的Ability。   |
59| 2    | SERVICE | 后台服务类型的Ability。 |
60| 3    | DATA | 数据类型的Ability。              |
61| 4    | FORM    | 卡片类型的Ability。   |
62| 5    | EXTENSION | Extension类型的Ability。 |
63