• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# AbilityStateData
2
3定义Ability状态信息,可以通过[registerApplicationStateObserver](js-apis-application-appManager.md#appmanagerregisterapplicationstateobserver8)注册生命周期变化监听后,通过[ApplicationStateObserver](js-apis-inner-application-applicationStateObserver.md)的onAbilityStateChanged生命周期回调获取。
4
5> **说明:**
6>
7> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
8
9## 导入模块
10
11```ts
12import appManager from '@ohos.application.appManager';
13```
14
15## 属性
16
17**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
18
19**系统API**: 此接口为系统接口,三方应用不支持调用。
20
21| 名称                     | 类型     | 可读 | 可写 | 说明                       |
22| ----------------------- | ---------| ---- | ---- | ------------------------- |
23| pid                     | number   | 是   | 否   | 进程ID。                    |
24| bundleName              | string   | 是   | 否  | 应用Bundle名称。          |
25| abilityName            | string   | 是   | 否   | Ability名称。               |
26| uid                    | number   | 是   | 否   | 用户ID。                  |
27| state                   | number   | 是   | 否   | [Ability状态](#ability状态)。                |
28| moduleName<sup>9+</sup> | string   | 是   | 否   | Ability所属的HAP的名称。    |
29| abilityType | number | 是   | 否   | [Ability类型](#ability类型):页面或服务等。 |
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| 8    | ABILITY_STATE_CONNECTED    | 后台服务已被客户端连接 |
42| 9    | ABILITY_STATE_DISCONNECTED | 后台服务客户端断开连接 |
43
44#### Ability类型
45
46| 值   | 状态    | 说明                  |
47| ---- | ------- | --------------------- |
48| 0    | UNKNOWN | 未知类型              |
49| 1    | PAGE    | UI界面类型的Ability   |
50| 2    | SERVICE | 后台服务类型的Ability |
51