BlurKit-Android 使用教程

1、项目介绍

BlurKit-Android 是一个高性能的 Android 模糊效果库，由 WonderKiln 开发并开源。它允许开发者在 Android 应用中轻松添加实时模糊效果。BlurKit-Android 基于 OpenGL ES 实现，确保了在性能上的优势，尤其在处理大面积模糊或动态模糊时，性能表现更加出色。此外，该库还利用硬件加速的优势，即使在老旧设备上也能流畅运行。

2、项目快速启动

添加依赖

首先，在项目的 build.gradle 文件中添加以下依赖：

dependencies {
    implementation 'com.wonderkiln:blurkit:1.0.0'
}

初始化 BlurKit

在 Application 类的 onCreate 方法中初始化 BlurKit：

public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        BlurKit.init(this);
    }
}

使用 BlurKit

在你的布局文件中添加 BlurLayout：

<com.wonderkiln.blurkit.BlurLayout
    android:id="@+id/blurLayout"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

在 Activity 中找到并配置 BlurLayout：

BlurLayout blurLayout = findViewById(R.id.blurLayout);
blurLayout.setBlurRadius(10); // 设置模糊半径
blurLayout.setDownscaleFactor(5); // 设置降采样因子

3、应用案例和最佳实践

导航栏背景

在底部导航栏或者悬浮按钮背后添加模糊效果，使焦点更突出：

<com.wonderkiln.blurkit.BlurLayout
    android:id="@+id/navBlurLayout"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:layout_alignParentBottom="true"/>

对话框/浮层

当弹出对话框或浮层时，应用模糊效果在底层内容上，增加层次感：

BlurLayout backgroundBlur = findViewById(R.id.backgroundBlur);
backgroundBlur.startBlur();

// 显示对话框
new AlertDialog.Builder(this)
    .setTitle("标题")
    .setMessage("这是一个模糊背景的对话框")
    .setPositiveButton("确定", null)
    .show();

backgroundBlur.pauseBlur();

滚动视差效果

结合滚动事件，实现在滑动过程中动态变化的模糊效果：

ScrollView scrollView = findViewById(R.id.scrollView);
BlurLayout scrollBlur = findViewById(R.id.scrollBlur);

scrollView.setOnScrollChangeListener(new View.OnScrollChangeListener() {
    @Override
    public void onScrollChange(View v, int scrollX, int scrollY, int oldScrollX, int oldScrollY) {
        scrollBlur.setBlurRadius(scrollY / 10);
    }
});

4、典型生态项目

BlurKit-Android 可以与其他 UI 库和框架结合使用，例如：

• CameraKit: 与 CameraKit 结合，可以在相机预览上添加实时模糊效果。
• RxJava: 使用 RxJava 处理异步事件，动态调整模糊效果。
• Glide: 使用 Glide 加载图片，并在图片上应用模糊效果。

通过这些组合，可以进一步提升应用的视觉吸引力和用户体验。