js-apis-application-abilityConstant.md 4.9 KB
Newer Older
1 2
# AbilityConstant

Y
yuyaozhi 已提交
3 4 5
AbilityConstant是启动参数的接口。

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

Y
yuyaozhi 已提交
7 8
> **说明:**
> 
D
donglin 已提交
9
> 本模块首批接口从API version 9开始支持,从API version 9后续版本废弃,替换模块为[@ohos.app.ability.AbilityConstant](js-apis-app-ability-abilityConstant.md)。后续版本的新增接口,采用上角标单独标记接口的起始版本。  
10
> 本模块接口仅可在Stage模型下使用。
11 12 13

## 导入模块

M
m00512953 已提交
14
```ts
15 16 17 18 19
import AbilityConstant from '@ohos.application.AbilityConstant';
```

## 属性

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

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

## AbilityConstant.LaunchReason

初次开始原因的类型。

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

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


R
RayShih 已提交
42
## AbilityConstant.LastExitReason
43 44 45

上次退出原因的类型。

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

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


## AbilityConstant.OnContinueResult 

继续结果的类型。

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

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

## AbilityConstant.WindowMode

启动Ability时的窗口模式。

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

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

## AbilityConstant.MemoryLevel

内存级别的类型。

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

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

## AbilityConstant.OnSaveResult

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

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

D
donglin 已提交
99
| 名称                          | 值   | 说明                                                         |
Z
zhancaijin 已提交
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
| 名称                          | 值   | 说明                                                         |
Z
zhancaijin 已提交
115 116 117
| ----------------------------- | ---- | ------------------------------------------------------------ |
| CONTINUATION           | 0    | 迁移保存状态。 |
| APP_RECOVERY           | 1    | 应用恢复保存状态。 |