LX Music TV

这是一个专为 Android TV / 电视盒子 设计的开源音乐播放器项目，由开发者 bmizhou 用 AI 辅助开发，定位是"洛雪音乐（LX Music）的电视版"，最新版本 2.9.202608171959（2026 年 8 月 17 日），基于 Apache 2.0 协议发布。

项目是什么

简单说，它就是把洛雪音乐（lx-music）的核心能力搬到了电视上，并针对遥控器操作做了完整适配。项目在功能、交互、视觉上参考了多个开源项目：

- lx-music-desktop：JS 播放源 / 多平台搜索 / 音源 SDK 的核心逻辑 - lx-music-mobile：播放缓存机制 - music-tv（菠萝音乐）：毛玻璃播放页布局 - Echo Music：深色主题风格 - blbl：侧栏交互、焦点驱动分页

技术上使用 Kotlin + Jetpack Compose + Material 3，播放器为 ExoPlayer，JS 引擎用 QuickJS 执行洛雪音源脚本，HTTP 管理服务用 NanoHTTPD。

核心功能

🎵 音源管理

- 支持导入 lx-music 格式的 JS 播放源 - TV 端启动 HTTP 服务器，手机/电脑浏览器打开地址即可上传、删除播放源，并配置平台生效范围 - 多源优先级：启用顺序即优先级，播放失败自动切换到下一个可用源 - 可设置是否开启"JS 源播放失败自动切换平台尝试"

🔍 搜索与浏览

- 多平台搜索（歌曲 / 歌单），支持首字母搜索联想、热门搜索 - TV 小键盘：6 列字母数字键盘，遥控器逐键输入 - 扫码推送搜索文字：手机扫码打开 "http://电视IP:5777/search"，输入文字一键推送到 TV 搜索框（解决遥控器输入慢的痛点） - 歌单广场、排行榜、歌单详情

▶️ 播放体验

- 多音源解析 + 播放失败自动换源 - 播放队列：列表播放、上下曲切换、顺序/随机/单曲循环 - 音质选择：标准 128k / 高品质 320k / 无损 FLAC / Hi-Res（取决于音源支持） - 歌词同步：多平台歌词接口 + LRC 解析 + 滚动高亮 - 后台播放：前台服务 + 媒体通知常驻 - TV 进度条：遥控器左右键 ±10s / 媒体快进快退 ±30s

📺 遥控交互

- 统一焦点指示：全界面亮红边框 + 发光，遥控器焦点一目了然 - 首页返回键弹窗三选（取消 / 退出 / 后台播放） - 播放页"下键"弹出控制栏，"上键"收起

如何获取与构建

环境要求：

- Android Studio（新版）+ Android SDK 35 - JDK 17+ - Gradle 9.5.0（项目内置 wrapper）

构建步骤：

git clone https://github.com/bmizhou/lx-music-tv.git cd lx-music-tv # 用 Android Studio 打开并同步 Gradle # 连接 Android TV 设备（开启 ADB） ./gradlew :app:installDebug

Releases 页面有 8 个已发布的版本标签，最新为 "2.9.202608171959"。

已知问题

项目 README 中作者明确列出的问题：

⚠️ 小秋音乐平台部分歌单无法打开（实测是 QQ 音乐接口问题） ⚠️ 小蜜音乐平台未经过测试，可能存在界面请求失败或无法播放 ⚠️ 搜索联想统一使用小芸音乐接口，有时需输入全拼才能正确联想（如"海贼王"输入"HZW"无效，需输入"HAIZE"） ⚠️ 歌词翻译功能目前只有小芸音乐平台生效 2.9 版本已在设置页加入 Web 端查看日志功能，遇到问题时可附上日志提 issue。

⚠️ 使用与版权提醒

这个项目本身不内置任何音源，所有音频数据都来自你导入的 JS 播放源返回的连接。项目的协议明确声明：

- 数据来自各官方音乐平台公开服务器拉取，项目不对数据合法性、准确性负责 - 使用者必须在 24 小时内清除使用过程中产生的版权数据 - 项目仅用于技术学习交流，禁止商用、禁止在官方平台宣传 - 音乐平台不易，请尊重版权，支持正版

也就是说，这是一个"播放器壳"，能不能播、播什么音质，完全取决于你配置的 JS 音源。这也是洛雪系项目的共同特点——它本身是开源免费的工具，曲库依赖于社区维护的音源脚本。

洛雪音乐本身是 lyswhut 主导开发的免费开源跨平台音乐播放器，覆盖 Windows / macOS / Linux / Android，定位是"聚合全网音源"的学习研究型工具。bmizhou 的这个 TV 版相当于把这套理念带到了大屏端，并解决了遥控器操作的适配问题。 这是 lx-music-tv 在 GitHub 上发布的 2.9.202608171959 版本（版本号对应 2026 年 8 月 17 日 19:59 构建）。本次更新主要围绕"JS 音源播放失败自动切换"机制和缓存稳定性做了三项修复与优化 ：

🛠 本次更新内容

1. 修复开关刷新问题

上一版本新增的"JS 源播放失败时尝试切换音乐平台"开关，切换时界面不会立即刷新——这个 bug 在本版修复 。

2. 优化切换顺序逻辑

之前播放失败时的切换顺序是 先切换音源 → 再切换音乐平台；本版调整为 先切换平台 → 再切换音源。这个顺序更符合多平台多音源场景下的重试逻辑，能更快命中可播放的资源 。

3. 优化播放地址缓存机制

修复了一个长期痛点：之前缓存的播放地址过几天后会失效，必须重新加载一次正确缓存才能再次播放。本版尝试从机制上彻底解决这个问题，但作者在发布说明中也如实标注了 "待后续确认" ——也就是这个修复还需要真实使用场景的验证 。

📥 如何获取

发布页面由于加载错误，从现有信息无法直接确认 APK 附件的具体文件名和大小。建议这样获取：

1. 直接打开发布页：https://github.com/bmizhou/lx-music-tv/releases/tag/2.9.202608171959 2. 在 Assets 区域下载对应的 APK 文件（通常为 "app-release.apk" 或类似命名） 3. 将 APK 拷贝到 Android TV / 电视盒子中安装