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 '@ohos.WallpaperExtensionAbility'; 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](js-apis-app-ability-want.md) | 是 | 当前Extension相关的Want类型信息，包括ability名称、bundle名称等。 | 32 33**示例：** 34 35```ts 36import WallpaperExtensionAbility from '@ohos.WallpaperExtensionAbility'; 37import Want from '@ohos.app.ability.Want'; 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 '@ohos.WallpaperExtensionAbility'; 64import wallpaper from '@ohos.wallpaper'; 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 '@ohos.WallpaperExtensionAbility'; 85 86class WallpaperExt extends WallpaperExtensionAbility { 87 onDestroy(): void { 88 console.log('onDestroy'); 89 } 90} 91``` 92