RouRouMusic (肉肉音乐)

RouRouMusic (肉肉音乐) 是一款专门为 Android TV 开发的 XiaoMusic 原生客户端。它旨在为电视大屏幕提供极致的音乐播放体验，完美适配遥控器操作，拥有精美的毛玻璃视觉效果和歌词显示功能。

https://github.com/GanHuaLin/rouroumusic-tv

✨ 功能特点

• 📺 电视原生界面：针对大屏幕高度优化的 UI，大字体、清晰的焦点提示。
• 🎮 全遥控器支持：完全适配 D-Pad 操作，流畅的导航切换体验。
• 🎵 沉浸式播放器：
• 基于专辑封面的动态毛玻璃背景。
• 实时同步歌词显示。
• 播放列表抽屉，支持快速切歌。
• 📡 智能音乐刮削：播放时若服务端缺失封面或歌词，自动调用第三方接口进行补全，并支持手动永久保存到服务端。
• 🔗 便捷连接：支持输入服务器地址，配合 xiaomusic 后端使用。
• 🚀 原生性能：基于 Android 原生 Java 开发，启动快、运行稳、占用低。
• ✅ 已测试设备：小米TV澎湃OS2、小米TV澎湃OS3。

🆕 最新版本功能 (v1.0.9)

• 触屏适配：播放界面新增点击背景切换控制栏的交互，方便无遥控器的触屏设备使用。
• 界面优化：配置页面左右面板改为可滚动布局，小屏/低分辨率设备上也能完整操作。
• 兼容性修复：调整集合 API 调用方式，修复低版本系统运行异常。
• 配置调整：最低系统版本进一步下调至 Android 5.1 (API Level 22)，覆盖更多老旧设备。

详细的更新日志请查看 CHANGELOG.md

📸 界面预览

快速登录	歌曲列表	播放界面
播放列表	功能菜单

🛠️ 安装与使用

下载运行

1. 前往本仓库的 Releases 页面下载最新的 APK 文件。
2. 将 APK 安装到您的 Android TV 或电视盒子上。

初次配置

应用提供了两种配置方式：

1. 手机快速配置（推荐）：
2. 启动应用后，电视屏幕会显示一个二维码或 IP 地址。
3. 使用手机浏览器访问该地址，即可在手机上输入服务器信息并一键推送到电视，免去遥控器输入的烦恼。
4. 手动输入：
5. 使用遥控器直接在电视端输入您的 XiaoMusic 服务端地址（例如 http://192.168.1.100:58090）。

🏗️ 编译指南

如果您想自行编译此项目：

1. 克隆本仓库： bash git clone https://github.com/GanHuaLin/rouroumusic-tv.git
2. 使用 Android Studio 打开项目。
3. 等待 Gradle 同步完成。
4. 使用 Android Studio 的 Build -> Build Bundle(s) / APK(s) -> Build APK(s) 生成 APK。

项目要求： - Android SDK 22 (Android 5.1) 或更高。 - Android Studio Chipmunk 或更高版本。

🤝 贡献与感谢

欢迎提交 Issue 或 Pull Request 来改进本项目。

• 特别感谢 XiaoMusic 提供的核心后端支持。

☕ 赞赏支持

如果您觉得这个项目对您有所帮助，欢迎请作者喝杯奶茶。您的支持是我持续维护和开发新功能的动力！

📄 开源协议

本项目采用 MIT License 协议。