Skip to content

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

TLMC Player

一个用于浏览和播放 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

构建步骤

  1. 克隆项目
  2. 使用 Android Studio 打开项目
  3. 等待 Gradle 同步完成(IDE 会自动生成 .gradle/、.idea/、local.properties)
  4. 点击 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

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages