1# AbilityFirstFrameStateObserver(系统接口) 2<!--Kit: Ability Kit--> 3<!--Subsystem: Ability--> 4<!--Owner: @zhu-feimo--> 5<!--Designer: @ccllee1--> 6<!--Tester: @lixueqing513--> 7<!--Adviser: @huipeizi--> 8 9定义了Ability首帧绘制完成事件监听对象,可以作为[on](js-apis-app-ability-appManager-sys.md#appmanageronabilityfirstframestate12)的入参,用于监听Ability首帧绘制完成事件。 10 11> **说明:** 12> 13> 本模块首批接口从API version 12开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 14> 本模块接口为系统接口。 15 16## 导入模块 17 18```ts 19import { appManager } from '@kit.AbilityKit'; 20``` 21 22## AbilityFirstFrameStateObserver 23 24### onAbilityFirstFrameDrawn 25 26onAbilityFirstFrameDrawn(data: AbilityFirstFrameStateData): void 27 28Ability首帧绘制完成时触发的回调函数。 29 30**系统接口**:此接口为系统接口。 31 32**系统能力**:SystemCapability.Ability.AbilityRuntime.Core 33 34**参数**: 35 36| 参数名 | 类型 | 必填 | 说明 | 37| -------- | -------- | -------- | -------- | 38| data | [AbilityFirstFrameStateData](js-apis-inner-application-abilityFirstFrameStateData-sys.md) | 是 | 表示首帧绘制完成时返回的数据。 | 39 40**示例**: 41 42```ts 43import { appManager } from '@kit.AbilityKit'; 44import { BusinessError } from '@kit.BasicServicesKit'; 45 46let observer: appManager.AbilityFirstFrameStateObserver = { 47 onAbilityFirstFrameDrawn(data: appManager.AbilityFirstFrameStateData) { 48 console.info(`onAbilityFirstFrameDrawn success, abilityFirstFrameStateData: ${data}.`); 49 } 50}; 51 52try { 53 appManager.on('abilityFirstFrameState', observer); 54} catch (e) { 55 let code = (e as BusinessError).code; 56 let msg = (e as BusinessError).message; 57 console.error(`appmanager.on failed, err code: ${code}, err msg: ${msg}.`); 58} 59``` 60