哔哩漫游界面交互：从对话框到设置系统的设计哲学

核心交互组件概览

哔哩漫游作为一款功能丰富的Xposed模块，其界面交互系统围绕对话框(Dialog) 和设置面板两大核心构建。项目中定义了12种专用对话框类，覆盖从颜色选择到字幕定制的全场景需求，所有UI组件遵循Android Material Design规范，同时保持高度自定义能力。

对话框系统架构

classDiagram
    class BaseWidgetDialog {
        +Context context
        +AlertDialog.Builder builder
        +initViews()
        +show()
    }
    
    ARGBColorChooseDialog --|> BaseWidgetDialog
    ColorChooseDialog --|> BaseWidgetDialog
    CustomSubtitleDialog --|> BaseWidgetDialog
    SpeedTestDialog --|> BaseWidgetDialog
    
    class SettingDialog {
        +PrefsFragment fragment
        +SharedPreferences prefs
        +initPreferences()
        +bindDialogs()
    }
    
    SettingDialog "1" --> "*" BaseWidgetDialog : 控制

核心对话框实现位于 app/src/main/java/me/iacn/biliroaming/，其中：

• ARGBColorChooseDialog：支持透明度调节的高级颜色选择器
• CustomSubtitleDialog：字幕样式全维度定制界面
• SpeedTestDialog：CDN节点测速与选择工具
• SearchFilterDialog：搜索结果精细化过滤面板

设置界面实现解析

多层级偏好设置架构

设置系统采用PreferenceScreen + Fragment 架构，通过XML定义基础布局，Kotlin实现业务逻辑。主设置界面在 app/src/main/res/xml/prefs_setting.xml 中定义了8个功能分类、53项可配置项，包括：

<PreferenceCategory android:title="@string/main_category">
    <SwitchPreference
        android:key="main_func"
        android:summary="@string/main_func_summary"
        android:title="@string/main_func_title" />
        
    <ListPreference
        android:defaultValue="@string/ali_host"
        android:entries="@array/upos_entries"
        android:entryValues="@array/upos_values"
        android:key="upos_host"
        android:title="@string/custom_upos_title" />
</PreferenceCategory>

动态交互实现

SettingDialog.kt 实现了复杂的偏好交互逻辑，包括：

1. 隐藏功能激活：通过版本号点击7次触发隐藏设置（L474-484）
2. 设置搜索：基于关键词的偏好项快速过滤（L203-213）
3. 兼容性检查：根据B站客户端版本动态启用/禁用功能（L250-345）
4. 设置导出/导入：XML格式的配置备份与恢复（L424-448）

关键代码示例：

private fun onVersionClick(): Boolean {
    if (prefs.getBoolean("hidden", false) || counter == 7) return true
    if (++counter == 7) {
        prefs.edit()?.putBoolean("hidden", true)?.apply()
        Log.toast("已开启隐藏功能，重启应用生效", true)
    } else if (counter >= 4) {
        Log.toast("再按${7 - counter}次开启隐藏功能", true)
    }
    return true
}

特色UI组件解析

自定义字幕对话框

CustomSubtitleDialog 提供业内领先的字幕样式定制能力，其布局文件 app/src/main/res/layout/custom_subtitle_dialog.xml 包含：

• 实时预览区域（3种背景模式）
• 字体选择与导入工具
• 12项视觉参数调节（字号、描边、阴影等）
• 颜色选择器（文字/背景/描边）

核心实现采用实时渲染机制，用户调整参数后立即更新预览效果（L347-446），并通过 SubtitleHelper.kt 将配置应用到播放器。

动态过滤系统

隐藏功能中的 HomeFilterDialog 实现首页内容精准过滤，支持：

• 播放量阈值过滤
• 时长范围限制
• 关键词黑白名单
• 分类内容屏蔽

通过 JsonHook.kt 拦截API响应，根据用户设置动态修改首页推荐数据。

界面交互设计亮点

1. 渐进式功能发现

设置界面采用隐藏功能设计（连续点击版本号7次激活），将高级功能与普通设置分离，既保持界面简洁又为进阶用户提供扩展能力。实现代码位于 SettingDialog.kt#L474-L484。

2. 上下文感知适配

根据B站客户端版本和设备系统自动启用/禁用功能，如：

if (!supportMusicNotificationHook) {
    disablePreference("music_notification", "Android O以下系统不支持")
}

3. 可视化操作反馈

所有设置变更提供即时Toast提示，关键操作（如隐藏功能激活）显示引导信息，提升用户操作确定性。

扩展与定制指南

添加新对话框组件

1. 创建继承 BaseWidgetDialog 的Kotlin类
2. 在res/layout中定义布局XML
3. 在SettingDialog中注册偏好点击事件
4. 通过 SharedPreferences 保存用户配置

修改设置界面

1. 在prefs_setting.xml添加Preference项
2. 在PrefsFragment中实现业务逻辑
3. 通过 onPreferenceChange 处理值变更
4. 使用 disablePreference 控制功能可用性

总结

哔哩漫游的界面交互系统通过模块化对话框 + 动态偏好设置的架构，实现了功能复杂度与易用性的平衡。其设计理念可概括为：

• 分层设计：基础功能与高级功能分离
• 即时反馈：操作结果可视化呈现
• 场景适配：根据环境动态调整可用功能
• 扩展友好：组件化架构便于功能增减

项目UI相关代码遵循Android开发最佳实践，所有交互元素均提供完整的无障碍支持，确保不同用户群体的使用体验。