MonsterMusic：安卓离线音乐播放器

项目简介

MonsterMusic 是一款面向 Android 平台的本地音乐播放器，采用 Jetpack Compose 与 Material Design 3 构建界面，音频处理由原生 C 编写的 DSP 引擎通过 JNI 完成。应用完全离线运行，不申请网络权限，没有广告、统计与追踪。

主要功能

• 原生 C DSP 音频引擎：低延迟音频处理，支持 Biquad IIR 零延迟参数均衡与 2048 点 FFT FIR 线性相位滤波两种架构，内置立体声联动的主软限幅器与立体声扩展器。
• 录音室级音效：立体声延迟（延迟时间、反馈衰减、乒乓交叉）、混响、合唱、镶边、复音效果，每种效果都有独立的 Dry/Wet 混合滑杆。
• 音频处理链路检查器：在封面下方实时展示信号路径，包括音轨格式、采样率、位深、码率、解码器、重采样状态、DSP 滤波模式与输出设备，点击可跳转对应设置。
• 频谱可视化：Matrix 数字雨与 32 段音频频谱随实时频率变化，支持全屏横屏模式与屏幕常亮，普通竖屏下可视化被限制在封面范围内。
• 变速与变调：播放速度 0.25x–3.0x，粗调步进 0.1x、细调 0.01x，并可独立调节音高。
• 同步歌词：自动平滑滚动居中、拖动歌词定位播放进度、点击单词弹出词典查询；支持内嵌歌词（ID3/Vorbis/MP4）与 .lrc、.vtt、.srt、.txt 外部文件。
• 视频播放：独立的 Video 标签页播放本地视频，离开页面或最小化时自动切换为纯音频以节省电量，视频声音同样经过 DSP 处理。
• 主题：兼容 Material Design 3 与 Android 12+ 动态取色（Monet），提供多种可自定义主题与强调色。

安装与使用

可从 F-Droid、Google Play、IzzyOnDroid 或 GitHub Releases 下载安装包，按设备架构选择 arm64-v8a（多数现代 64 位设备）、armeabi-v7a（较老的 32 位设备）、x86_64 / x86（模拟器、ChromeOS）或 universal。

从源码编译：

git clone https://github.com/ZTFtrue/MonsterMusic.git
cd MonsterMusic
./gradlew assembleDebug

编译需要 Android Studio Ladybug 或更新版本、JDK 17、Android SDK Platform 37、Android NDK 30.0.16248370（r30）和 CMake 3.22.1，产物位于 app/build/outputs/apk/。

启用视频播放：在设置中打开 Video Support 开关，按提示授予视频媒体权限，返回主界面后本地视频会出现在媒体库中，并在播放页出现 Video 标签。

注意事项

• 应用默认只申请音频读取权限（READ_MEDIA_AUDIO / READ_EXTERNAL_STORAGE）；只有开启视频播放时才会请求 READ_MEDIA_VIDEO，该权限仅用于扫描和播放本地视频。
• 视频支持需要在编译时启用后才能看到对应开关。
• 技术栈：Jetpack Compose + Material Design 3、AndroidX Media3 (ExoPlayer)、Room、Kotlin Coroutines/StateFlow、Coil 3。
• 项目基于 Apache-2.0 许可证开源。

本作品整理自 GitHub 开源项目 ZTFtrue/MonsterMusic，原作者 @ZTFtrue，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。