js-apis-app-ability-abilityConstant.md 4.8 KB
Newer Older
Z
zengyawen 已提交
1
# @ohos.app.ability.AbilityConstant (AbilityConstant)
D
donglin 已提交
2

Z
zhongjianfei 已提交
3
AbilityConstant提供Ability相关的枚举,包括设置初次启动原因、上次退出原因、迁移结果、窗口类型等。
D
donglin 已提交
4 5 6 7 8 9 10 11

> **说明:**
> 
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。  
> 本模块接口仅可在Stage模型下使用。

## 导入模块

M
m00512953 已提交
12
```ts
D
donglin 已提交
13 14 15 16 17
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
```

## 属性

M
m00512953 已提交
18 19 20 21
## AbilityConstant.LaunchParam

启动参数。

D
donglin 已提交
22 23
**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core

Z
zhongjianfei 已提交
24
| 名称 | 类型 | 可读 | 可写 | 说明 |
D
donglin 已提交
25
| -------- | -------- | -------- | -------- | -------- |
M
m00512953 已提交
26 27
| launchReason | [LaunchReason](#abilityconstantlaunchreason)| 是 | 是 | 指示启动原因。 |
| lastExitReason | [LastExitReason](#abilityconstantlastexitreason) | 是 | 是 | 表示最后退出原因。 |
D
donglin 已提交
28 29 30

## AbilityConstant.LaunchReason

Z
zhongjianfei 已提交
31
初次启动原因。
D
donglin 已提交
32 33 34

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

D
donglin 已提交
35
| 名称                          | 值   | 说明                                                         |
D
donglin 已提交
36 37 38 39 40 41 42 43 44 45
| ----------------------------- | ---- | ------------------------------------------------------------ |
| UNKNOWN          | 0    | 未知的状态。 |
| START_ABILITY          | 1    | 启动能力。 |
| CALL | 2    | 呼叫。 |
| CONTINUATION           | 3    | 继续。 |
| APP_RECOVERY           | 4    | 状态恢复。 |


## AbilityConstant.LastExitReason

Z
zhongjianfei 已提交
46
上次退出原因。
D
donglin 已提交
47 48 49

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

D
donglin 已提交
50
| 名称                          | 值   | 说明                                                         |
D
donglin 已提交
51 52 53 54 55 56 57 58
| ----------------------------- | ---- | ------------------------------------------------------------ |
| UNKNOWN          | 0    | 未知的状态。 |
| ABILITY_NOT_RESPONDING          | 1    | 能力没有反应 |
| NORMAL | 2    | 正常的状态。 |


## AbilityConstant.OnContinueResult 

Z
zhongjianfei 已提交
59
迁移结果。
D
donglin 已提交
60 61 62

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

D
donglin 已提交
63
| 名称                          | 值   | 说明                                                         |
D
donglin 已提交
64 65 66 67 68 69 70 71 72 73 74
| ----------------------------- | ---- | ------------------------------------------------------------ |
| AGREE           | 0    | 同意。 |
| REJECT           | 1    | 拒绝。 |
| MISMATCH  | 2    | 不匹配。|

## AbilityConstant.WindowMode

启动Ability时的窗口模式。

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

75
| 名称                        | 值 | 说明                 |
D
donglin 已提交
76 77 78 79 80 81 82 83 84
| ---                         | --- | ---                  |
| WINDOW_MODE_UNDEFINED       | 0   | 未定义窗口模式。       |
| WINDOW_MODE_FULLSCREEN      | 1   | 全屏模式。            |
| WINDOW_MODE_SPLIT_PRIMARY   | 100 | 分屏多窗口主要模式。   |
| WINDOW_MODE_SPLIT_SECONDARY | 101 | 分屏多窗口次要模式。   |
| WINDOW_MODE_FLOATING        | 102 | 自由悬浮形式窗口模式。 |

## AbilityConstant.MemoryLevel

Z
zhongjianfei 已提交
85
内存级别。
D
donglin 已提交
86 87 88

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

89
| 名称                         | 值 | 说明                |
D
donglin 已提交
90 91 92 93 94 95 96
| ---                         | --- | ---                  |
| MEMORY_LEVEL_MODERATE       | 0   | 内存占用适中。       |
| MEMORY_LEVEL_LOW            | 1   | 内存占用低。            |
| MEMORY_LEVEL_CRITICAL       | 2   | 内存占用高。   |

## AbilityConstant.OnSaveResult

Z
zhongjianfei 已提交
97
保存应用数据的结果。
D
donglin 已提交
98 99 100

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

D
donglin 已提交
101
| 名称                          | 值   | 说明                                                         |
D
donglin 已提交
102 103 104 105 106 107 108 109 110 111
| ----------------------------- | ---- | ------------------------------------------------------------ |
| ALL_AGREE           | 0    | 同意保存状态。 |
| CONTINUATION_REJECT           | 1    | 拒绝迁移保存状态。 |
| CONTINUATION_MISMATCH  | 2    | 迁移不匹配。|
| RECOVERY_AGREE           | 3    | 同意恢复保存状态。 |
| RECOVERY_REJECT  | 4    | 拒绝恢复保存状态。|
| ALL_REJECT  | 5    | 拒绝保存状态。|

## AbilityConstant.StateType

Z
zhongjianfei 已提交
112
保存应用数据场景原因。
D
donglin 已提交
113 114 115

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

D
donglin 已提交
116
| 名称                          | 值   | 说明                                                         |
D
donglin 已提交
117 118 119
| ----------------------------- | ---- | ------------------------------------------------------------ |
| CONTINUATION           | 0    | 迁移保存状态。 |
| APP_RECOVERY           | 1    | 应用恢复保存状态。 |