未验证 提交 b6ee54f6 编写于 作者: O openharmony_ci 提交者: Gitee

!20324 【壁纸】增加WallpaerExtensionAbility.md

Merge pull request !20324 from LVB8189/master
# @ohos.WallpaperExtensionAbility (WallpaperExtensionAbility)
通过本模块接口,开发者可自行开发壁纸应用,并管理壁纸应用生命周期。
> **说明:**
>
> 本模块首批接口从API version 10开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
>
> 本模块接口仅可在FA模型下使用。
>
> 本模块接口均为系统接口。
## 导入模块
```js
import WallpaperExtensionAbility from '@ohos.WallpaperExtensionAbility';
```
## WallpaperExtensionAbility.onCreate
onCreate(want: object): void
初始化壁纸拓展应用。在拉起Extension壁纸拓展应用时触发回调,执行初始化应用操作。
**系统能力:** SystemCapability.MiscServices.Wallpaper
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ----------- | ---- | ------------------------------- |
| want | [object](js-apis-app-ability-want.md) | 是 | 当前Extension相关的Want类型信息,包括ability名称、bundle名称等。 |
**示例:**
```js
import WallpaperExtensionAbility from '@ohos.WallpaperExtensionAbility';
class WallpaperExt extends WallpaperExtensionAbility {
onCreate(want) {
console.log('onCreate, want:' + want.abilityName);
}
}
```
## WallpaperExtensionAbility.onWallpaperChange
onWallpaperChange(wallpaperType: number): void
监听壁纸变化。在壁纸变化时触发回调。
**系统能力:** SystemCapability.MiscServices.Wallpaper
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | --------- | --- |----------------------|
| wallpaperType | number | 是 | 壁纸类型。主屏幕壁纸为0,锁屏壁纸为1。 |
**示例:**
```js
import WallpaperExtensionAbility from '@ohos.WallpaperExtensionAbility';
class WallpaperExt extends WallpaperExtensionAbility {
onWallpaperChange(wallpaperType) {
console.log('onWallpaperChange, wallpaperType:' + wallpaperType);
}
}
```
## WallpaperExtensionAbility.onDestroy
onDestroy(): void
清理壁纸拓展应用资源。在销毁壁纸拓展应用时触发回调,执行资源清理。
**系统能力:** SystemCapability.MiscServices.Wallpaper
**示例:**
```js
import WallpaperExtensionAbility from '@ohos.WallpaperExtensionAbility';
class WallpaperExt extends WallpaperExtensionAbility {
onDestroy() {
console.log('onDestroy');
}
}
```
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册