• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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