zijunchiang
0c26f6da68
- DatabaseBootstrapper: 删除 Gitee 分片/manifest/blob 下载逻辑, 曲库只走官方 MuseDbSync - build.gradle: 移除 GITEE_DATABASE_* 构建参数 - MainActivity: 重置数据库文案改为官方同步 - ktv_api.js: 歌曲源仅 w.w345.my, 缓存标记 7, 广告/错号资源拦截+重试 - 远程日志: 点歌记录 编号/标题/请求源/状态
83 lines
4.6 KiB
Markdown
83 lines
4.6 KiB
Markdown
<p align="center">
|
||
<img src="app/src/main/res/drawable-nodpi/ktv_logo.png" width="140" alt="麦动 KTV Logo">
|
||
</p>
|
||
|
||
<h1 align="center">麦动 KTV</h1>
|
||
|
||
<p align="center">面向 Android TV 和横屏点歌设备的本地 KTV 应用</p>
|
||
|
||
<p align="center">遥控器操作 · 歌曲检索 · 点播队列 · 下载管理 · 稳定播放</p>
|
||
|
||
## ⚠️ 严正声明 (Important Notice)
|
||
|
||
本软件是**完全免费且公开源码**的个人学习与技术交流项目。
|
||
|
||
- **【禁止任何形式的营利性使用】**：本软件（包括源码和编译后的 APK）严禁任何商家或个人进行打包售卖、硬件预装、收费技术支持或商业运营。
|
||
- **【侵权必究】**：如果您是付费购买的本软件，说明您已被骗，请立即向平台举报商家并退款。
|
||
- 完整授权条款请参见项目根目录下的 [LICENSE](./LICENSE) 文件。
|
||
|
||
## 核心功能
|
||
|
||
- TV 遥控器全局导航，支持方向键、确认键、返回键和长按操作。
|
||
- 统一焦点反馈，按钮、列表、卡片、开关和弹窗均提供清晰的选中状态。
|
||
- 首页提供排行榜、歌名、歌星、常唱、收藏、分类和本地歌曲入口。
|
||
- 支持全网与本地歌曲检索、语种筛选、分页浏览和首字母键盘输入。
|
||
- 歌星页面支持头像标签分类和歌手歌曲浏览。
|
||
- 支持歌曲点播、批量点歌、置顶、收藏、取消收藏和文件管理。
|
||
- 已点、已唱和下载列表实时同步歌曲状态。
|
||
- 已下载歌曲直接加入队列；未下载歌曲完成下载后自动加入，不打断当前播放。
|
||
- 已点列表存在歌曲时自动开始播放，并在切歌后同步队列与播放状态。
|
||
|
||
## 播放功能
|
||
|
||
- 使用 IJK 播放器处理本地和下载歌曲。
|
||
- 支持小窗播放与全屏播放，切换页面和执行点歌操作时保持视频连续播放。
|
||
- 支持播放、暂停、切歌、重唱、进度显示和拖动。
|
||
- 支持原唱与伴唱切换，并保持当前播放或暂停状态。
|
||
- 播放状态在小窗、全屏控制栏和提示浮层之间实时同步。
|
||
- 支持歌曲片头信息、播放提示和暂停常驻提示。
|
||
- 支持视频比例、自动全屏和音画同步设置。
|
||
- 支持歌曲最大音量及原唱、伴唱相关声音策略。
|
||
|
||
## 下载与数据
|
||
|
||
- 支持歌曲后台下载、进度展示、断点恢复和失败重试。
|
||
- 下载或解密异常时自动清理损坏数据并重新发起任务。
|
||
- 支持已下载歌曲识别、数量统计和本地文件播放。
|
||
- 支持分片数据库下载、校验、合并和原子更新。
|
||
- 存储权限完成后再启动目录创建、数据库扫描和下载任务。
|
||
- 支持本地硬盘与 U 盘歌曲扫描、存储空间设置和自动删歌。
|
||
- 预留空间提供遥控器可直接选择的容量档位；达到阈值后保护当前及已点歌曲，并按最近使用时间自动清理。
|
||
- 应用数据统一保存在麦动 KTV 目录，避免与其他应用的数据冲突。
|
||
|
||
## 设置功能
|
||
|
||
- 数据设置：曲库更新、本地扫描、预留空间、自动删歌和数据库维护。
|
||
- 播放设置：自动全屏、视频比例、音画同步和片头字幕。
|
||
- 声音设置：音量策略、歌曲最大音量及原唱伴唱策略。
|
||
- 界面设置：语言、悬浮按钮、轮播图和歌曲片头字幕。
|
||
- 设置弹窗支持临时选择、确认保存和关闭取消，遥控器焦点状态清晰可见。
|
||
- 启动时自动检查 Gitee Release；发现更高版本后可在应用内下载并启动系统安装器。
|
||
|
||
## 界面与交互
|
||
|
||
- 界面同时适配电视、横屏手机和平板；窄屏自动压缩栏高、留白、字号和播放器侧栏。
|
||
- 全屏播放右上角常驻小型手机点歌二维码。
|
||
- 顶部播放控制、小窗控制和全屏控制保持一致的状态与语义。
|
||
- 列表刷新、分页、标签切换和点歌后保持真实焦点位置，避免焦点跳动。
|
||
- 焦点选中仅改变颜色，不改变控件原有尺寸、圆角或布局。
|
||
- 使用麦动圆形 Logo，并在首页、播放页和应用信息中保持统一显示。
|
||
|
||
## 热更新与应用发布
|
||
|
||
- 歌曲接口逻辑位于 `app/src/main/assets/mobile/ktv_api.js`，安装后的应用会从本仓库自动拉取兼容版本。
|
||
- JS 热更新文件必须保留 `KTV_BRIDGE_API: 2` 标记，未通过兼容校验的远端脚本不会覆盖内置版本。
|
||
- 应用更新以 Gitee Release 的标签作为版本号，例如 `1.3.0`；Release 中必须包含一个 `.apk` 附件。
|
||
- 只有标签版本高于当前 `BuildConfig.VERSION_NAME` 时，应用才会提示下载更新。
|
||
|
||
## 赞助支持
|
||
|
||
- 感谢各位的使用与支持，留下您的一点小心意，请我媳妇儿喝杯奶茶吧~~
|
||
|
||
|