1# @ohos.WallpaperExtensionAbility (WallpaperExtensionAbility)（系统接口）
2
3WallpaperExtensionAbility为壁纸拓展模块，提供应用生命周期回调和监听壁纸变化的能力。
4
5> **说明：**
6>
7> 本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
8>
9> 本模块接口仅可在Stage模型下使用。
10>
11> 本模块接口均为系统接口。
12
13## 导入模块
14
15```ts
16import { WallpaperExtensionAbility } from '@kit.BasicServicesKit';
17```
18
19## WallpaperExtensionAbility.onCreate
20
21onCreate(want: object): void
22
23初始化壁纸拓展应用。在拉起Extension壁纸拓展应用时触发回调，执行初始化应用操作。不支持多线程并发调用。
24
25**系统能力：** SystemCapability.MiscServices.Wallpaper
26
27**参数：**
28
29| 参数名 | 类型          | 必填 | 说明                             |
30| ------ | ----------- | ---- | ------------------------------- |
31| want   | [object](../apis-ability-kit/js-apis-app-ability-want.md) | 是   | 当前Extension相关的Want类型信息，包括ability名称、bundle名称等。 |
32
33**示例：**
34
35```ts
36import { WallpaperExtensionAbility } from '@kit.BasicServicesKit';
37import { Want } from '@kit.AbilityKit';
38
39class WallpaperExt extends WallpaperExtensionAbility {
40    onCreate(want: Want): void {
41        console.log('onCreate, want:' + want.abilityName);
42    }
43}
44```
45
46## WallpaperExtensionAbility.onWallpaperChange
47
48onWallpaperChange(wallpaperType: number): void
49
50监听壁纸变化。在壁纸变化时触发回调。不支持多线程并发调用。
51
52**系统能力：** SystemCapability.MiscServices.Wallpaper
53
54**参数：**
55
56| 参数名 | 类型        | 必填 | 说明                   |
57| ------ | --------- | --- |----------------------|
58| wallpaperType  | number | 是  | 壁纸类型。主屏幕壁纸为0，锁屏壁纸为1。 |
59
60**示例：**
61
62```ts
63import { WallpaperExtensionAbility } from '@kit.BasicServicesKit';
64import { wallpaper } from '@kit.BasicServicesKit';
65
66class WallpaperExt extends WallpaperExtensionAbility {
67    onWallpaperChange(wallpaperType: wallpaper.WallpaperType): void {
68        console.log('onWallpaperChange, wallpaperType:' + wallpaperType);
69    }
70}
71```
72
73## WallpaperExtensionAbility.onDestroy
74
75onDestroy(): void
76
77清理壁纸拓展应用资源。在销毁壁纸拓展应用时触发回调，执行资源清理。不支持多线程并发调用。
78
79**系统能力：** SystemCapability.MiscServices.Wallpaper
80
81**示例：**
82
83```ts
84import { WallpaperExtensionAbility } from '@kit.BasicServicesKit';
85
86class WallpaperExt extends WallpaperExtensionAbility {
87    onDestroy(): void {
88        console.log('onDestroy');
89    }
90}
91```
92