Android WallpaperManager 分析

前言

WallpaperManager 类是 Android 框架中用于管理壁纸的类，提供了设置壁纸、获取壁纸、获取壁纸信息等功能，下面是对 WallpaperManager 类的源码分析

 

 

一、内部实现

WallpaperManager 类是一个系统服务（System Service），

其实现位于 frameworks/base/core/java/android/app/WallpaperManager.java 文件中。该类继承自 ContextWrapper 类，实现了 IWallpaperManager 接口，成员变量包括壁纸服务的代理（IWallpaperManager 对象）和上下文对象。

二、获取 WallpaperManager 实例

可以通过以下方式获取 WallpaperManager 实例：

WallpaperManager wallpaperManager = WallpaperManager.getInstance(context);

其中，context 参数是上下文对象，可以是 Activity、Service 或 Application 等。

三、设置壁纸

可以使用以下方法设置壁纸：

// 设置资源文件中的壁纸
wallpaperManager.setResource(resourceId);

// 设置指定文件路径的壁纸
wallpaperManager.setBitmap(bitmap);

// 设置指定文件路径的壁纸
wallpaperManager.setStream(inputStream);

上述方法中，setResource() 方法用于设置指定资源 ID 的壁纸，setBitmap() 方法用于设置指定 Bitmap 对象的壁纸，setStream() 方法用于设置指定输入流中的壁纸。

在 Android 8.0 及以上版本中，设置壁纸需要应用具有 android.permission.SET_WALLPAPER 权限。

 

// 设置动态壁纸
public boolean setWallpaperComponent(ComponentName name)

// 清除锁屏壁纸
public void clear(WallpaperManager.FLAG_LOCK)

// 清除所有壁纸
public void clearWallpaper()

// 获取静态壁纸图片
public Bitmap getBitmap()

// 设置静态壁纸
public void setBitmap(Bitmap bitmap)

四、获取壁纸

可以使用以下方法获取壁纸：

// 获取当前壁纸（非缩略图）
Drawable drawable = wallpaperManager.getDrawable();

// 获取当前壁纸的缩略图
Bitmap bitmap = wallpaperManager.getBitmap();

上述方法中，getDrawable() 方法获取当前壁纸的 Drawable 对象，getBitmap() 方法获取当前壁纸的缩略图。

五、获取壁纸信息

可以使用以下方法获取壁纸信息：

// 获取当前壁纸的显示类型
int wallpaperType = wallpaperManager.getWallpaperType();

// 获取当前壁纸的偏移量
int xOffset = wallpaperManager.getDesiredMinimumWidth();
int yOffset = wallpaperManager.getDesiredMinimumHeight();

// 获取当前壁纸的尺寸
int width = wallpaperManager.getDesiredMinimumWidth();
int height = wallpaperManager.getDesiredMinimumHeight();

上述方法中，getWallpaperType() 方法返回当前壁纸的显示类型，包括 WALLPAPER_TYPE_SYSTEM 和 WALLPAPER_TYPE_LOCKSCREEN 等。getDesiredMinimumWidth() 和 getDesiredMinimumHeight() 方法返回当前壁纸的偏移量和尺寸。

六、壁纸相关类信息

// 壁纸服务信息封装
WallpaperInfo

// 提供接口对壁纸服务的访问
WallpaperManager

// IWallpaperEngine接口服务端对象
// class IWallpaperEngineWrapper extends IWallpaperEngine.Stub
IWallpaperEngineWrapper

// IWallpaperService接口服务端对象
// IWallpaperServiceWrapper extends IWallpaperService.Stub
IWallpaperServiceWrapper

// 用户壁纸相关信息存储
WallpaperData

// 监听WallPaperService之间的连接状态和实现IWallpaperConnection接口服务端实现
// class WallpaperConnection extends IWallpaperConnection.Stub
// implements ServiceConnection
WallpaperConnection

// 壁纸服务
// public class WallpaperManagerService extends IWallpaperManager.Stub
WallpaperManagerService

// 壁纸核心和壁纸绘制相关
Engine

总结

以上是对 WallpaperManager 类的j简要分析，该类是 Android 框架中用于管理壁纸的重要类，提供了设置壁纸、获取壁纸、获取壁纸信息等功能，对于壁纸相关的应用开发非常有用。更多源码分析请移步 Android WallpaperManager 壁纸分析_HHTC_NICE的博客-CSDN博客 他的博客，写的很详细