js-apis-app-ability-abilityConstant.md 4.8 KB
Newer Older
Z
zengyawen 已提交
1
# @ohos.app.ability.AbilityConstant (AbilityConstant)
D
donglin 已提交
2 3 4 5 6 7 8 9 10 11 12 13

AbilityConstant是启动参数的接口。

AbilityConstant提供启动参数的接口的能力,包括设置初次开始原因的类型、上次退出原因的类型、继续结果的类型。

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

## 导入模块

M
m00512953 已提交
14
```ts
D
donglin 已提交
15 16 17 18 19 20 21
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
```

## 属性

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

D
donglin 已提交
22
| 名称 | 类型 | 可读 | 可写 | 说明 | 
D
donglin 已提交
23 24 25 26 27 28 29 30 31 32
| -------- | -------- | -------- | -------- | -------- |
| launchReason | LaunchReason| 是 | 是 | 指示启动原因。 | 
| lastExitReason | LastExitReason | 是 | 是 | 表示最后退出原因。 | 

## AbilityConstant.LaunchReason

初次开始原因的类型。

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

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


## AbilityConstant.LastExitReason

上次退出原因的类型。

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

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


## AbilityConstant.OnContinueResult 

继续结果的类型。

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

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

## AbilityConstant.WindowMode

启动Ability时的窗口模式。

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

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

## AbilityConstant.MemoryLevel

内存级别的类型。

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

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

## AbilityConstant.OnSaveResult

保存应用数据的结果类型。

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

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

## AbilityConstant.StateType

保存应用数据场景原因类型。

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

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