• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# AppForegroundStateObserver (系统接口)
2
3定义应用启动和退出的状态监听,可以作为[on](js-apis-app-ability-appManager-sys.md#appmanageron11)的入参监听所有应用的启动和退出的变化。
4
5> **说明:**
6>
7> 本模块首批接口从API version 11开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
8> 本模块接口为系统接口。
9
10## 导入模块
11
12```ts
13import appManager from '@ohos.app.ability.appManager';
14```
15
16## 属性
17
18**系统接口**: 此接口为系统接口。
19
20**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
21
22| 名称                             | 类型                    | 可读 | 可写 | 说明   |
23| -------------------------------- | ---------------------- | ---- | ---- | ------------------ |
24| onAppStateChanged   | AsyncCallback\<void>   | 是   | 否   | 应用启动和退出状态发生变化时执行的回调函数。传入参数类型是[AppStateData](js-apis-inner-application-appStateData-sys.md)。 |
25
26**示例:**
27```ts
28import appManager from '@ohos.app.ability.appManager';
29
30let observer: appManager.AppForegroundStateObserver = {
31    onAppStateChanged(appStateData) {
32        console.log(`onAppStateChanged appStateData: ${JSON.stringify(appStateData)}`);
33    },
34};
35appManager.on('appForegroundState', observer);
36```