zijunchiang
d01269e917
需求一：流程反转 + 上报绑定官方源成功 - 默认 sourceHosts 反转为 ["http://zk.ktv1.top:6677", "https://mdmuse.kasugano.cn"]； SourceHosts.DEFAULT / SongUrlResolver.DEFAULT_HOSTS（收敛为引用前者）/ ktv_api.js CONFIG.HOSTS+HOST 三处一致。 - 取址结果改为 SourcedSongUrl(url, sourceHost)（**显式来源标志**，不靠 URL 猜）： 新增 SongSourceFlow（回落链 firstAvailable / 上报判定 shouldReportToSelfHost / 全失败信号）；JS 侧新增 android.onSongSource(requestId, host) 回传命中的源。 - 汇合点 SongApiClient.getSongDownloadUrl 只在"地址来自官方源"时才 POST /push_download； 自建源自己给的地址与 DB 回落都不上报。 - 推送默认目标改为"从歌曲源列表里找第一个自建源"（自建源不再排第一，旧写法会直接关掉推送）。 - 1.6.1 落盘的旧默认顺序（自建源优先）在 KtvStore.load() 里一次性迁移；自定义列表不动。 - 业务码 404（自建源没有这首歌）仍只当"该源没地址"，不置 sawForbidden、不进冷却、不污染受限统计。 需求二：6 条隐患 1) 设置页改源对 JS 立即生效：KtvJsBridge.applySourceSettingsNow 重新注入 KtvApiConfig.* 并把已构造实例的 window.api.sourceOrder 重置为新列表；SongApiClient.applySourceSettings 接线。 2) JS 路径识别业务码 403：新增 KtvJsBridge.riskForbidden(status, body)（纯函数，手写判定 避免 org.json 在单测里是空壳），HTTP 403 与 HTTP 200+{"code":403} 都算风控，与原生 sawForbidden 同口径。 3) isTrustedDownloadUrl 移除广告域名 ac16.vip 白名单，并改为黑名单优先（不再依赖调用顺序）。 4) MainActivity.download(song)（第五条地址消费点）补 AdVideoFilter.isTrustedSongUrl 闸门， 不可信按"源失效"处理（Eac19WindowGuard.noteAllSourcesFailed），不再静默下载。 5) SongApiClient.fetchFromDb 不再静默吞异常：曲库打不开/查询异常各记一条 MiliLog.localWarn（含编号与异常）。 6) 删除死代码 streamDownloadAndPlay（全仓 grep 无调用点，且内部取址不过最终闸门）。 需求三：死代码/漂移清理（均先全仓搜索确认无引用） - AdVideoFilter.replacementUrl 无任何写入点（恒为 null）→ 删除，resolve() 只保留"屏蔽"语义。 - ktv_api.js CONFIG.VER/VN 由"从不生效的死值"改为实际使用值 2.0 / 4.1.3.03281430。 - CONFIG.HOST 改为被 getToken 真正读取（不再"注入但从未被读"）。 - KTV_BRIDGE_API 14 → 15（JS 两处 + KtvJsBridge 两处校验）；AGENTS.md / README.md / README.en.md 的陈旧标记统一到 15。 - do.php 的 limit 与 i.php 的 retry/ordertype/end_date/heart_time 确认无消费方 → 不新增解析（保持现状）。 需求四：测试与打包 - 新增 SourceOrderConsistencyTest / SongSourceFlowTest / JsBridgeGateTest / DownloadEntryGateTest， 更新 SourceHostsTest / AdVideoFilterTest；app/build.gradle 打开 unitTests.returnDefaultValues。 - testReleaseUnitTest --rerun-tasks --offline：12 个测试类 / 87 例全过。 - assembleRelease --offline 通过（lintVital NewApi 0 条）；版本 1.6.1/44 → 1.6.2/45。 不发布：未推 Gitea/Gitee、未动 Release/tag。
98 lines
5.2 KiB
Markdown
98 lines
5.2 KiB
Markdown
<p align="center">
|
|
<img src="app/src/main/res/drawable-nodpi/ktv_logo.png" width="140" alt="Maidong KTV Logo">
|
|
</p>
|
|
|
|
<h1 align="center">Maidong KTV</h1>
|
|
|
|
<p align="center">A local karaoke application for Android TV and landscape song-selection devices</p>
|
|
|
|
<p align="center">Remote Control · Song Discovery · Request Queue · Download Management · Stable Playback</p>
|
|
|
|
## Core Features
|
|
|
|
- Full TV remote navigation with directional keys, confirmation, back, and long-press actions.
|
|
- Consistent focus feedback for buttons, lists, cards, switches, and dialogs.
|
|
- Home entries for charts, song titles, singers, frequently played songs, favorites, categories, and local songs.
|
|
- Online and local search with language filters, paging, and initial-letter keyboard input.
|
|
- Singer browsing with portrait tags and singer-specific song lists.
|
|
- Song ordering, batch ordering, queue prioritization, favorites, and file management.
|
|
- Real-time synchronization across queued, played, and downloaded song lists.
|
|
- New requests join the end of the queue without interrupting the current requested song.
|
|
- Automatic playback when requested songs are available, including smooth transitions from public playback.
|
|
|
|
## Playback
|
|
|
|
- IJK-based playback for local and downloaded songs.
|
|
- Continuous playback while navigating between pages or switching between windowed and full-screen modes.
|
|
- Play, pause, skip, replay, progress display, and seeking controls.
|
|
- Original-vocal and accompaniment switching without changing the current play or pause state.
|
|
- Synchronized playback state across windowed controls, full-screen controls, and status overlays.
|
|
- Song title overlays, temporary mode prompts, and persistent pause indicators.
|
|
- Video ratio, automatic full screen, audio-video synchronization, and public playback settings.
|
|
- Maximum song volume and configurable original-vocal and accompaniment behavior.
|
|
|
|
## Downloads And Data
|
|
|
|
- Background downloads with progress, resume support, and automatic retry.
|
|
- Automatic cleanup and retry after download or decryption failures.
|
|
- Recognition, counting, and playback of downloaded local songs.
|
|
- Segmented database download, verification, merge, and atomic update.
|
|
- Directory creation, database scanning, and download startup only after storage permission is granted.
|
|
- Local disk and USB song scanning, reserved storage settings, and automatic cleanup.
|
|
- Unified Maidong KTV data storage to avoid conflicts with other applications.
|
|
|
|
## Settings
|
|
|
|
- Data settings for library updates, local scanning, reserved space, automatic cleanup, and database maintenance.
|
|
- Playback settings for public playback, automatic full screen, video ratio, synchronization, and title overlays.
|
|
- Sound settings for volume behavior, maximum song volume, original vocals, and accompaniment.
|
|
- Interface settings for language, floating controls, carousel content, and song title overlays.
|
|
- Dialog selections remain temporary until confirmed and provide clear remote-control focus feedback.
|
|
|
|
## Interface And Interaction
|
|
|
|
- Landscape TV layout optimized for long-distance viewing.
|
|
- Consistent state and meaning across top, windowed, and full-screen playback controls.
|
|
- Stable focus during list refreshes, paging, tab changes, and song ordering.
|
|
- Focus changes color only and preserves each control's original dimensions, corners, and layout.
|
|
- A consistent circular Maidong logo across the home screen, player, and application information.
|
|
|
|
## Project Notice
|
|
|
|
> **This repository**: [https://gitea.kasugano.cn/zijunchiang/maidong-ktv](https://gitea.kasugano.cn/zijunchiang/maidong-ktv)
|
|
>
|
|
> **UI/feature framework credit**: [https://gitee.com/yangyachao-X/maidong-ktv](https://gitee.com/yangyachao-X/maidong-ktv)
|
|
>
|
|
> This repository reworks the upstream "Maidong KTV" UI and feature framework, and the core/data layer was
|
|
> rewritten with **DSH (DeepSeek Harness)**: library sync, song-source integration, device auth,
|
|
> risk-control handling, remote logging, and ad blocking are all new implementations.
|
|
|
|
Highlights of the reworked data layer:
|
|
|
|
- **Library**: synced exclusively from the official Muse service
|
|
(`mconn.cherryonline.cn` `mls-api/v1/sqlite/sync`); the code host carries source only, no database files.
|
|
- **Song source**: `w.w345.my` (`i.php` token → `do.php` playback URL) with fixed device identity and
|
|
reproduced signing; ad/mismatched resources (e.g. `wb66.cn/.../719.ts`) are blocked and retried.
|
|
- **JS hot-update**: `app/src/main/assets/mobile/ktv_api.js`, requires the `KTV_BRIDGE_API: 15` marker.
|
|
|
|
## Building
|
|
|
|
Requirements: JDK 17, Android SDK (`compileSdk 35`, `minSdk 21`, `targetSdk 25`),
|
|
Gradle wrapper 8.13 (bundled).
|
|
|
|
```bash
|
|
cd maidong-ktv
|
|
export JAVA_HOME=/path/to/jdk-17
|
|
export ANDROID_HOME=/path/to/android-sdk
|
|
export ANDROID_SDK_ROOT=$ANDROID_HOME
|
|
./gradlew assembleRelease
|
|
```
|
|
|
|
The release signing config in `app/build.gradle` expects `../../ktv_keystore.jks` (one level above the
|
|
repo root) with alias `ktv` / password `123456`; adjust paths or use `signingConfigs.debug` for a
|
|
quick unsigned build. Output: `app/build/outputs/apk/release/app-release.apk`
|
|
(dual ABI: `armeabi-v7a` + `arm64-v8a`). Install with `adb install -r <apk>`.
|
|
|
|
For non-commercial learning purposes only. Respect upstream copyright and song licensing.
|
|
|