• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# AppForegroundStateObserver (系统接口)
2<!--Kit: Ability Kit-->
3<!--Subsystem: Ability-->
4<!--Owner: @SKY2001-->
5<!--Designer: @yzkp-->
6<!--Tester: @lixueqing513-->
7<!--Adviser: @huipeizi-->
8
9定义应用启动和退出的状态监听,可以作为[on](js-apis-app-ability-appManager-sys.md#appmanageronappforegroundstate11)的入参监听所有应用的启动和退出的变化。
10
11> **说明:**
12>
13> 本模块首批接口从API version 11开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
14> 本模块接口为系统接口。
15
16## 导入模块
17
18```ts
19import { appManager } from '@kit.AbilityKit';
20```
21
22## AppForegroundStateObserver
23
24### onAppStateChanged
25
26onAppStateChanged(appStateData: AppStateData): void
27
28应用启动和退出状态发生变化时,系统会触发该回调。
29
30**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
31
32**系统接口**:此接口为系统接口。
33
34**参数**:
35
36| 参数名  | 类型 | 必填 | 说明   |
37| ------ | ---- | ---- | ----- |
38| appStateData   | [AppStateData](js-apis-inner-application-appStateData.md)   | 是  | 应用状态信息。 |
39
40**示例:**
41```ts
42import { appManager } from '@kit.AbilityKit';
43
44let observer: appManager.AppForegroundStateObserver = {
45  onAppStateChanged(appStateData) {
46    console.info(`onAppStateChanged appStateData: ${JSON.stringify(appStateData)}`);
47  },
48};
49appManager.on('appForegroundState', observer);
50```