Android窗口背景模糊模糊当前窗口背景模糊当前窗口后面整个屏幕模糊实现机制简介 SurfaceControl S

官方指导：source.android.google.cn/docs/core/d…

样例代码：github.com/OkieLe/Wind…

注意：仅支持Android 12及以上平台

1. 使用方法

1.1 模糊当前窗口背景

设置窗口半透明：主题中 windowIsTranslucent 设置为 true
设置模糊半径：主题中 backgroundBlurRadius 设置为非0，Window 也有相应方法 setBackgroundBlurRadius
- 取值范围(0, 150)
- 典型数值 20 即可达到一般模糊效果，80可达到高斯模糊效果
- 数值越大，性能越差
设置窗口背景透明：主题或者代码中设置 windowBackground 为带透明度的颜色或者Drawable
- 通过带圆角和透明度的 ShapeDrawable 可以支持带圆角的窗口

1.2 模糊当前窗口后面整个屏幕

使能模糊：主题中 windowBlurBehindEnabled 设置为 true 或窗口添加 FLAG_BLUR_BEHIND
设置模糊半径：主题中 windowBlurBehindRadius 设置为非0，Window.LayoutParams 也有相应方法 setBlurBehindRadius
- 取值范围(0, 150)
- 典型数值 20 即可达到一般模糊效果，80可达到高斯模糊效果
- 数值越大，性能越差
还可以设置背景屏幕变暗（可选）：
- 使能背景变暗：主题中 backgroundDimEnabled 设置为 true 或窗口添加 FLAG_DIM_BEHIND
- 设置变暗程度：主题中 dimAmount 设置为 0 - 1 的浮点数，越大越不透明，Window 也有相应方法 setDimAmount
显示出被窗口覆盖区域的内容（可选）：主题中 windowIsTranslucent 设置为 true，使窗口半透明
- 设置透明窗口背景：主题或者代码中设置 windowBackground 为带透明度的颜色或者Drawable

以上两种方式可以同时使用

1.3 监听窗口模糊开关变化

窗口模糊在运行时可能会被禁用，比如用户操作或者省电模式，可以通过 WindowManager 中的接口监听变化和查看状态

// Add listener
void addCrossWindowBlurEnabledListener(Consumer<Boolean> listener)
// Remove listener
void removeCrossWindowBlurEnabledListener(Consumer<Boolean> listener)
// Get the blur enable state
boolean isCrossWindowBlurEnabled()

2. 模糊实现机制简介

基于Android 14 源码

2.1 模糊当前窗口背景

实现主要分为两部分：设置参数和图像合成，图像合成单列出来说明设置参数主要涉及到的类：

PhoneWindow
DecorView
BackgroundBlurDrawable
ViewRootImpl
SurfaceControl
SurfaceComposeClient
SurfaceFlinger

2.2 模糊当前窗口后面整个屏幕

实现主要分为两部分：设置参数和图像合成，图像合成单列出来说明设置参数主要涉及到的类：

WindowManagerService
WindowState
Dimmer
SurfaceControl
SurfaceComposeClient
SurfaceFlinger

2.3 图像合成

前面 2.1/2.2 分别将blur相关信息传到SurfaceFlinger，在下一帧图像合成时就会包含模糊图形合成主要涉及的类：

SurfaceFlinger
CompositionEngine
Display/Output
RenderEngine
SkiaRenderEngine
BlurFilter

在 drawLayersInternal 中会从后往前将每一个需要合成的 Layer 绘制到Buffer中，模糊相关的请搜索 BlurFilter