# danmu-player **Repository Path**: zlwsns/danmu-player ## Basic Information - **Project Name**: danmu-player - **Description**: No description available - **Primary Language**: Unknown - **License**: GPL-3.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-06-11 - **Last Updated**: 2026-07-04 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # syplayer - 安卓本地弹幕音视频播放器 ![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/mzhsy1/syplayer/total) [English](README_en.md) | 中文 > GitHub https://github.com/mzhsy1/syplayer Gitee 镜像站点 https://gitee.com/mzhsy/syplayer > syplayer(拾影)是一款支持 Android TV 和手机的本地音视频播放器,支持弹幕、多协议网络文件浏览与播放、TMDB 媒体库刮削。 --- ## 功能特性 ### 核心功能 - 🎬 **视频播放** — 双引擎(ExoPlayer / VLC),支持常见视频格式的本地与网络协议播放 - 🎵 **音频播放** — 专辑封面、LRC 滚动歌词、频谱可视化、播放列表 - 🖼️ **图片查看** — 本地与网络协议图片查看 - 🏡 **媒体库** — 电影/剧集/音乐库,TMDB + NFO 自动刮削 - ⭐ **我的收藏** — 收藏电影、剧集、文件夹 - 🕛 **继续播放** — 音视频播放历史,断点续播 - 🔍 **搜索功能** — 搜索电影/剧集,支持实时联想 - 💬 **弹幕功能** — B 站风格弹幕(AKDanmaku),在线搜索/下载/播放内自定义 - 🔏 **小秘密** — 私密文件夹浏览,6 协议在线文件系统,视频预览播放 - 🎨 **多主题** — 6 套主题(默认 / 碧海潮生 / 暗香疏影 / 空山新雨 / 永夜星河 / 樱吹雪) - 🌐 **网络协议**:SMB / FTP / WebDAV / NFS / HTTP - 📱 **手机 + TV 双端** — 同一个 APK 支持 TV 遥控器和手机触屏两种交互 ### 🎬 播放器特性 | 特性 | 说明 | |------|------| | 双引擎 | ExoPlayer(默认)+ VLC,蓝光/TS 自动切 VLC | | 触屏手势 | 单击显隐控件 / 长按倍速 / 左滑亮度 / 右滑音量 | | 视频轨道 | 多视频轨(含 ISO 蓝光标题)选择 | | 音轨切换 | 多音轨无缝切换,首选语言自动选择 | | 字幕系统 | 内嵌 + 外挂(SRT/ASS/SSA/VTT/PGS),自定义样式 | | 实时网速 | 播放时显示实时网速(B/s / KB/s / MB/s),可隐藏 | | 断点续播 | 自动保存进度,下次提示继续或重头 | | 截图功能 | 播放中一键截取封面/海报/剧照 | ### 🔊 音频进阶 | 特性 | 说明 | |------|------| | 音频直通 | VLC 直通 DTS/DTS-HD/TrueHD | | 解码模式 | 纯硬解 / 硬解优先 / 软解优先 | | 频谱可视化 | 基于 AudioSessionId 实时频谱 | | LRC 滚动歌词 | 自动查找同目录歌词 | ### 🏡 媒体库 | 特性 | 说明 | |------|------| | 刮削 | TMDB + NFO 双源,失败自动入库基础条目 | | 演员信息 | 详情页圆形头像横向展示,最多 20 位 | | 合集 | 系列电影自动聚合展示 | | 多版本 | 同名不同源文件在详情页列出 | | 画质标签 | 从文件名提取 4K/H.265/Dolby Vision 等标签 | | 直接播放 | 可跳过详情页直接播放 | ### 🔏 小秘密 | 特性 | 说明 | |------|------| | 内联浏览 | 6 种协议(SMB/FTP/WebDAV/NFS/HTTP/Local)文件夹在线浏览 | | 视频预览 | 卡片右下角播放按钮,底部浮窗实时预览 | | 剧照轮播 | 详情页横版海报区每 5 秒切换视频帧 | | 设置面板 | 展示模式(文件夹/卡片)/排序(名称/大小)/预览(开关/声音/倍速) | ### ⚙️ 设置项 | 分类 | 设置项 | |------|--------| | 常规 | 隐藏详情页 / 隐藏网速 | | 主题 | 6 套主题(默认/碧海潮生/暗香疏影/空山新雨/永夜星河/樱吹雪) | | 播放与视频 | 首选音轨语言 / 默认播放器内核 / 首选字幕语言 | | 音频 | 音频直通 / 解码模式 | | 字幕 | 字体大小/颜色/背景/边距 / PGS 居中 | | 数据源 | 六种协议开关 / TMDB API Key / 弹幕 API 地址 | | 工具 | 存储权限 / 导航栏显隐 / 备份与恢复 / 清理数据 | | 关于 | 版本信息 / 彩蛋 | --- ### 格式支持 - **视频**:MP4, MKV, MOV, AVI, FLV, WebM, ISO, M2TS, TS, VOB - **编码**:H.264, H.265, AV1, VP9, MPEG-2 - **4K/8K**、HDR10/HLG、杜比视界 - **音频**:FLAC, WAV, MP3, AAC, OGG, DTS, DTS-HD, TrueHD, AC3, E-AC3 - **图片**:JPEG, PNG, WebP, BMP, HEIC - **字幕**:SRT, ASS, SSA, VTT, PGS --- ## 构建 ### 要求 - JDK 25 - Android SDK 37+ - `local.properties` 需配置 `TMDB_API_KEY=` - `app/libs/` 需存在三个 AAR: - `akdanmaku.aar` - `lib-decoder-ffmpeg-release.aar` - `ffmpeg-kit-full-6.0-2.LTS.aar` ### 命令 ```bash ./gradlew compileMobileDebugKotlin # 快速编译检查(手机端) ./gradlew assembleMobileDebug # 打包手机 APK ./gradlew assembleTvDebug # 打包 TV APK ./gradlew assembleDebug # 双端同时打包 ``` --- ## 技术架构 | 层级 | 技术 | |------|------| | UI | Jetpack Compose(TV: tv-material3 / Mobile: material3) | | 导航 | Navigation Compose 双层导航 | | 视频 | Media3 ExoPlayer + LibVLC | | 弹幕 | 快手 AKDanmaku | | 图片 | Coil 3 | | 数据库 | Room + KSP | | 网络 | Retrofit (TMDB), SMB (smbj), WebDAV (sardine), FTP (commons-net), NFS (nfs-client+JNI) | | 语言 | Kotlin 2.4.0 / Gradle 9.5.1 / AGP 9.2.1 | ### 产品风味 单一 `:app` 模块,`device` 维度两个 flavor: | Flavor | 源集 | 说明 | |--------|------|------| | `tv` | `app/src/tv/` | Android TV,遥控器操作 | | `mobile` | `app/src/mobile/` | 手机,触屏操作 | 共享代码在 `app/src/main/`(Application、数据层、ViewModels、工具类、预览播放器等)。 --- ## 项目状态 当前版本:**1.15.8** (versionCode 97) --- ## 免责声明 本软件仅供学习交流使用,请勿用于商业用途。 --- **注意**:杜比视界、杜比全景声、DTS-HD 等功能需要设备硬件支持。