一个用于浏览和播放 WebDAV 服务器媒体文件的 Android 应用,支持音频、图片和文本内容。
- 文件浏览: 连接 WebDAV 服务器,浏览目录结构
- 本地音频: 通过系统文件选择器播放本地音频,可多选并加入播放列表
- 文件搜索: 从当前目录递归搜索,最多返回 200 条结果
- 音频播放: 支持播放列表、后台播放和通知栏控制,重开应用自动恢复上次播放列表,并记忆音频上次播放进度
- 均衡器: 支持开关、频段增益调节与常见音乐风格预设(流行、摇滚、爵士、古典、电子、人声等),配置自动保存
- 播放容错: 播放出错或缓冲超时自动重试恢复;CUE 切轨共享磁盘缓存,减少重复下载
- 通知与锁屏: 媒体通知展示曲目/专辑信息、封面与进度条,支持播放顺序切换,锁屏可见
- 音频封面: 本地音频读取内嵌封面,WebDAV 音频使用同目录 cover/folder 图片,显示在通知、迷你播放器和播放页
- 音频并行播放策略: 其他应用开始播放音频时,本应用不会自动停止当前音频播放
- CUE 分轨播放: 自动检测同名 CUE 文件,按曲目分割播放
- 歌词支持: 支持 LRC 歌词解析与同步高亮
- 图片查看: 支持缩放和平移
- 图片库浏览: 支持图片浏览,循环滑动切换
- 文本查看: 支持多种编码 (UTF-8、GBK、Shift-JIS 等)
- 音频: flac, mp3, wav, ogg, m4a, aac
- 图片: png, jpg, jpeg, tif, tiff, bmp, webp
- 文本: txt, log, md, nfo, ini, cfg, lrc
- CUE: cue
- 点击目录: 进入下一层目录
- 点击音频文件: 可选择单曲播放或整目录加入播放列表
- 工具栏菜单「本地音频」: 通过系统文件选择器播放本地音频
- 播放列表: 使用每项的上移/下移按钮调整顺序
- 点击 CUE 文件: 进入音频播放器并按曲目播放
- 点击图片文件: 进入图片查看器
- 点击文本文件: 进入文本查看器
- Android Studio Hedgehog (2023.1.1) 或更高版本
- JDK 17
- Android SDK 34
- Gradle 8.5
- 克隆项目
- 使用 Android Studio 打开项目
- 等待 Gradle 同步完成(IDE 会自动生成
.gradle/、.idea/、local.properties) - 点击 Run 或使用
./gradlew assembleDebug
注意: 项目不包含构建产物(
.gradle/、app/build/、.idea/、local.properties),首次打开项目需等待 Gradle 同步自动生成这些文件。
TLMC_Player/
├── .git/ # 版本控制
├── .gitignore # 排除规则
├── app/ # Android 应用模块
│ ├── build.gradle.kts # 模块配置和依赖
│ ├── proguard-rules.pro # ProGuard 规则
│ └── src/main/
│ ├── AndroidManifest.xml
│ ├── java/com/tlmc/player/
│ └── res/
├── gradle/ # Gradle Wrapper
├── build.gradle.kts # 根项目配置
├── settings.gradle.kts # 模块设置
├── gradle.properties # 全局配置
├── gradlew / gradlew.bat # Gradle Wrapper 脚本
└── README.md
app/src/main/java/com/tlmc/player/
├── TLMCApplication.kt # Application 类(Hilt 入口)
├── di/ # 依赖注入模块
├── data/
│ ├── model/ # 数据模型
│ ├── repository/ # 数据仓库(ConfigManager、WebDavRepository)
│ └── webdav/ # WebDAV 客户端
├── ui/
│ ├── browser/ # 文件浏览器(启动页)
│ ├── player/ # 音频播放器 + 后台服务
│ ├── image/ # 图片查看器
│ ├── gallery/ # 图片库浏览
│ └── text/ # 文本查看器
└── util/ # 工具类(解析器、编码检测、TIFF 解码)
MIT License