模糊背景库 Blur-LIB-Android 使用指南

1. 项目介绍

Blur-LIB-Android 是由Daniel Zeller开发的一个安卓库，旨在提供一个快速且高效的解决方案来模糊视图的背景。该库充分利用硬件加速，通过SurfaceTexture和OpenGL实现背景的高斯模糊效果，适用于需要动态模糊背景的场景，如对话框、导航栏等。它支持通过XML布局直接使用，并提供了多种自定义选项以满足不同的设计需求。

2. 项目快速启动

添加依赖

首先，您需要在您的Android项目中添加Blur-LIB-Android的依赖。对于Gradle构建系统，可以通过以下方式引入：

dependencies {
    implementation 'no.danielzeller.blurbehindlib:blurbehindlib:1.0.0'
}

如果您使用Maven，则可以在pom.xml文件中添加：

<dependency>
    <groupId>no.danielzeller.blurbehindlib</groupId>
    <artifactId>blurbehindlib</artifactId>
    <version>1.0.0</version>
    <type>pom</type>
</dependency>

使用示例

在XML布局文件中创建BlurBehindLayout:

<no.danielzeller.blurbehindlib.BlurBehindLayout
    android:id="@+id/blurBehindLayout"
    android:layout_width="match_parent"
    android:layout_height="50dp"
    app:blurRadius="100.0"
    app:updateMode="onScroll"
    app:useTextureView="false">
    <!-- 在这里添加子视图 -->
</no.danielzeller.blurbehindlib.BlurBehindLayout>

然后，在Java或Kotlin代码中设置被模糊的视图：

val blurBehindLayout = findViewById<BlurBehindLayout>(R.id.blurBehindLayout)
blurBehindLayout.viewBehind = findViewById(R.id.viewToBlur)

3. 应用案例和最佳实践

• 对话框背景模糊: 将BlurBehindLayout作为对话框的一部分，设定适当的更新模式（如onScroll），可以使对话框的背景呈现模糊效果，提升用户体验。
• 顶部导航栏模糊: 在活动的顶部使用此库，使得下方的内容模糊，创造出沉浸式的界面效果。

最佳实践提示

• 性能考量：合理选择blurRadius和blurTextureScale以平衡视觉效果与性能。
• 更新模式选择：依据具体交互逻辑选择onScroll、continuously或manually，减少不必要的渲染操作。
• 透明度动画：若需要使用透明度变化，考虑启用useTextureView。

4. 典型生态项目

虽然此仓库本身不直接关联特定的生态项目，开发者常将Blur-LIB-Android集成到个性化UI设计中，特别是在应用的定制对话框、启动页或者任何希望突出主体而淡化背景的应用场景。由于其通用性和易用性，广泛应用于各种需要动态背景模糊处理的安卓应用中。

---

以上即为Blur-LIB-Android的基本使用指南，结合这些信息，您可以轻松地将其融入到您的安卓项目中，增添更多的视觉层次感和现代UI元素。