Skip to content

Sophon3266/TLMC_Player

Repository files navigation

TLMC Player

一个用于浏览和播放 WebDAV 服务器媒体文件的 Android 应用,支持音频、视频、图片和文本内容。

功能特性

  • 文件浏览: 连接 WebDAV 服务器,浏览目录结构
  • 文件搜索: 从当前目录递归搜索,最多返回 200 条结果
  • 音频播放: 支持播放列表、后台播放和通知栏控制,重开应用自动恢复上次播放列表,并记忆音频上次播放进度
  • 音频并行播放策略: 其他应用开始播放音频时,本应用不会自动停止当前音频播放
  • CUE 分轨播放: 自动检测同名 CUE 文件,按曲目分割播放
  • 歌词支持: 支持 LRC 歌词解析与同步高亮
  • 视频播放: 支持播放/暂停、进度拖动、倍速、画中画(PiP)、断点续播
  • 横竖屏体验: 视频页支持沉浸式全屏控制
  • 图片查看: 支持缩放和平移
  • 图片库浏览: 支持图片/视频混合浏览,循环滑动切换
  • 文本查看: 支持多种编码 (UTF-8、GBK、Shift-JIS 等)

格式支持

  • 音频: flac, mp3, wav, ogg, m4a, aac
  • 视频: mp4, mkv, webm, mov, avi, m4v, mpg, mpeg, vob, ts, m2ts, mts
  • 图片: png, jpg, jpeg, tif, tiff, bmp, webp
  • 文本: txt, log, md, nfo, ini, cfg, lrc
  • CUE: cue

说明:

  • 对于 vob、m2ts、mts 等格式,实际可播放性受设备硬件解码能力影响。
  • DVD 相关能力为导出后的视频文件级播放,不包含 VIDEO_TS/IFO 菜单导航。

使用说明

  • 点击目录: 进入下一层目录
  • 点击音频文件: 可选择单曲播放或整目录加入播放列表
  • 点击 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/               # 音频播放器 + 后台服务
│   ├── video/                # 视频播放器
│   ├── image/                # 图片查看器
│   ├── gallery/              # 图片库浏览(图片/视频混合)
│   └── text/                 # 文本查看器
└── util/                     # 工具类(解析器、编码检测、TIFF 解码)

许可证

MIT License

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages