• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# @ohos.app.ability.Ability (Ability基类)
2
3[UIAbility](js-apis-app-ability-uiAbility.md)和[ExtensionAbility](js-apis-app-ability-extensionAbility.md)的基类,提供系统配置更新回调和系统内存调整回调。
4
5
6> **说明:**
7>
8> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
9> 本模块接口仅可在Stage模型下使用。
10
11## 导入模块
12
13```ts
14import Ability from '@ohos.app.ability.Ability';
15```
16
17## Ability.onConfigurationUpdate
18
19onConfigurationUpdate(newConfig: Configuration): void;
20
21当系统配置更新时调用。
22
23**系统能力**:SystemCapability.Ability.AbilityRuntime.AbilityCore
24
25**参数:**
26
27  | 参数名 | 类型 | 必填 | 说明 |
28  | -------- | -------- | -------- | -------- |
29  | newConfig | [Configuration](js-apis-app-ability-configuration.md) | 是 | 表示需要更新的配置信息。 |
30
31**示例:**
32
33  ```ts
34  class myAbility extends Ability {
35      onConfigurationUpdate(config) {
36          console.log('onConfigurationUpdate, config:' + JSON.stringify(config));
37      }
38  }
39  ```
40
41## Ability.onMemoryLevel
42
43onMemoryLevel(level: AbilityConstant.MemoryLevel): void;
44
45当系统已决定调整内存时调用。例如,当该功能在后台运行时,没有足够的内存来运行尽可能多的后台进程时可以使用。
46
47**系统能力**:SystemCapability.Ability.AbilityRuntime.AbilityCore
48
49**参数:**
50
51  | 参数名 | 类型 | 必填 | 说明 |
52  | -------- | -------- | -------- | -------- |
53  | level | [AbilityConstant.MemoryLevel](js-apis-app-ability-abilityConstant.md#abilityconstantmemorylevel) | 是 | 回调返回内存微调级别,显示当前内存使用状态。|
54
55**示例:**
56
57  ```ts
58  class myAbility extends Ability {
59    onMemoryLevel(level) {
60        console.log('onMemoryLevel, level:' + JSON.stringify(level));
61    }
62  }
63  ```
64