考拉音控 (Kaola Music Controller) 🎵🚗

English | 中文版

---

中文版

考拉音控 (Kaola Music Controller) 是一款专为驾驶分屏场景打造的极简 Android 车机风格音乐控制器。它通过系统底层的 MediaSession 协议接管当前正在播放的音频（支持网易云音乐、QQ音乐、Spotify等），将手机屏幕变为一个极具设计感的超大尺寸遥控器。

✨ 核心特性

• 现代车机布局 (Modern Dashboard UI): 采用左侧高清正方形封面、右侧音乐信息与超大控制面板的黄金分割布局，美观且实用。
• 超大控制按键 (Large Touch Targets): 摒弃音乐 App 原生的微小按钮，提供超大尺寸的上一曲、播放/暂停、下一曲实体按键，确保在颠簸路况下也能精准盲按。
• 沉浸式视觉 (Immersive Visuals): 自动提取当前歌曲的高清封面，叠加极具质感的高斯模糊作为全屏背景，配合发光的拟物化 Logo 图标，充满驾驶沉浸感。
• 触觉反馈与高精度进度条: 每次成功触发切歌或暂停时，伴随轻微的震动反馈；支持随时拖拽的高精度进度条让您轻松掌控播放。
• 完美的车机分屏支持: 为 Android 11+ 的多窗口模式深度优化，拖动分屏比例时绝不闪退或变形，屏幕始终保持常亮。

🚀 如何构建与安装

选项 A: 使用 GitHub Actions 自动构建 (推荐) 无需安装复杂的本地环境，您可以直接将代码推送到 GitHub，通过仓库的 Actions 自动打包：

1. Fork 或克隆本仓库到您的 GitHub。
2. 转到仓库的 Actions 页面，确保工作流已启用。
3. 每次推送到 main 分支时，云端会自动构建。
4. 构建成功后，在最新的 Action 运行结果页面底部，下载 Artifacts 中的 .apk 文件。

选项 B: 使用 Android Studio 编译

1. 使用 Android Studio 打开本项目的根目录。
2. 等待 Gradle 同步完成。
3. 连接您的 Android 设备，点击 Run 按钮。

⚙️ 使用说明

1. 初次授权: 第一次打开 App 时，根据屏幕提示前往系统设置，授予该应用 “通知读取权限 (Notification Access)”，这是接管音频控制的必需权限。
2. 连接播放器: 打开您常用的音乐播放软件（如网易云音乐），开始播放一首歌曲。
3. 返回本应用: 此时背景会自动变为歌曲封面的模糊版。
4. 分屏使用: 将本应用与导航软件上下/左右分屏，即可在驾驶时安全、便捷地控制音乐。

📅 v3.x 更新计划 (Roadmap)

• 真·沉浸式刘海屏适配: 突破系统防遮挡保护机制，配置 windowLayoutInDisplayCutoutMode，彻底消除因手机挖孔/刘海屏导致的顶部状态栏黑条，实现 100% 满屏无边框模糊背景。
• 智能歌词滚动渲染:
  • 独立歌词源: 通过网络开源 API 根据“歌曲名+歌手”自动匹配并下载 .lrc 歌词（打破原生 MediaSession 无法获取第三方音乐 App 完整歌词的限制）。
  • 定制化渲染动效: 开发自定义高性能 LyricView（Canvas 重绘绘制），随着音乐进度条的时间戳动态滚动，实现酷狗/网易云级别的单行高亮与极度丝滑的滚动体验。

---

English Version

Kaola Music Controller (考拉音控) is a minimalist Android music controller designed specifically for split-screen driving scenarios. It takes over the currently playing audio (supporting Spotify, Apple Music, etc.) via the system's MediaSession protocol, turning your phone screen into a massive, modern remote control.

✨ Key Features

• Modern Dashboard UI: Features a golden-ratio layout with high-res square album art on the left, and track info with a massive control panel on the right.
• Large Touch Targets: Abandons the tiny playback buttons of native music apps. Provides oversized Previous, Play/Pause, and Next buttons to ensure accurate taps even on bumpy roads.
• Immersive Visuals: Automatically extracts the current song's high-res album art, applying a premium Gaussian blur as the full-screen background.
• Haptic Feedback & Seekable Progress: Accompanies every successful track skip or pause with a subtle vibration. The highly accurate seekbar allows easy playback control.
• Perfect Split-Screen Support: Deeply optimized for Android 11+ multi-window mode. Resizing the split-screen ratio will never cause crashes or distortion. The screen stays awake during the ride.

🚀 How to Build & Install

Option A: Automated Build via GitHub Actions (Recommended) No need to install a massive local environment. You can push the code to GitHub and let Actions build the APK for you:

1. Fork or clone this repository to your GitHub.
2. Go to the Actions tab of your repository and ensure workflows are enabled.
3. Every push to the main branch triggers a cloud build.
4. Once successful, download the .apk file from the Artifacts section at the bottom of the Action run page.

Option B: Compile with Android Studio

1. Open the root directory of this project in Android Studio.
2. Wait for Gradle synchronization to finish.
3. Connect your Android device and click the Run button.

⚙️ Usage Instructions

1. Initial Authorization: Upon the first launch, follow the on-screen prompt to navigate to system settings and grant "Notification Access". This is strictly required to intercept media controls.
2. Connect Player: Open your preferred music player (e.g., Spotify) and start playing a track.
3. Return to Kaola Music: The background will automatically transform into a blurred version of the album art.
4. Split-Screen Mode: Enter split-screen mode with your navigation app. You can now safely and conveniently control your music while driving.

📅 v3.x Roadmap

• True Immersive Display: Configure windowLayoutInDisplayCutoutMode to bypass system notch protection, completely eliminating the top black status bar caused by camera cutouts to achieve a 100% edge-to-edge seamless background.
• Smart Scrolling Lyrics:
  • Independent Lyric Sources: Fetch .lrc lyric data via open-source network APIs based on track and artist names (overcoming the limitation of the native MediaSession protocol which cannot extract full lyrics from third-party music apps).
  • Custom Rendering Effects: Develop a high-performance custom LyricView (Canvas rendering) synchronized with the playback progress timestamp to achieve silky smooth lyric scrolling and active-line highlighting comparable to commercial music players.