1# AbilityForegroundStateObserver (系统接口) 2 3定义应用前后台状态监听。 4 5> **说明：** 6> 7> 本模块首批接口从API version 11开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 8> 本模块接口为系统接口。 9 10## 导入模块 11 12```ts 13import { abilityManager } from '@kit.AbilityKit'; 14``` 15 16## AbilityForegroundStateObserver 17 18### onAbilityStateChanged 19 20onAbilityStateChanged(abilityStateData: AbilityStateData): void 21 22当Ability前后台状态发生变化时，系统会触发该回调。 23 24**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 25 26**系统接口**：此接口为系统接口。 27 28**参数**： 29 30| 参数名 | 类型 | 必填 | 说明 | 31| ------ | ----- | ----- | ----- | 32| abilityStateData | [AbilityStateData](js-apis-inner-application-abilityStateData.md) | 是 | Ability状态信息。 | 33 34**示例：** 35```ts 36import { abilityManager } from '@kit.AbilityKit'; 37import { BusinessError } from '@kit.BasicServicesKit'; 38 39let observer: abilityManager.AbilityForegroundStateObserver = { 40 onAbilityStateChanged(abilityStateData) { 41 console.info(`onAbilityStateChanged: ${JSON.stringify(abilityStateData)}`); 42 }, 43}; 44try { 45 abilityManager.on('abilityForegroundState', observer); 46} catch (paramError) { 47 let code = (paramError as BusinessError).code; 48 let message = (paramError as BusinessError).message; 49 console.error(`error code: ${code}, error msg: ${message}`); 50} 51``` 52