青听音乐

青听音乐（QingMusic）仓库概览

一款免费无广告的本地音乐播放器，基于 Flutter 开发，主打纯净本地播放 + 可扩展音源机制。

🎯 产品定位

因不可抗力，青听已不再提供内置音源服务，目前定位为「空壳本地播放器」——核心功能聚焦本地音频管理，同时通过可导入音源机制保留在线能力。 音源导入方式（类似洛雪音乐）：

复制音源网址 → 打开 APP → 我的 → 导入音源配置 → 粘贴确认

🏗 技术架构

Flutter + Dart，采用分层架构保证可维护性：

UI 层（界面） ↓ 依赖 状态管理层（数据协调） ↓ 依赖 数据层（本地存储 / 播放引擎 / 音源管理）

🎵 核心功能

基础播放：播放 / 暂停 / 上一首 / 下一首 / 进度拖拽 / 播放模式（顺序、随机、单曲循环）

本地管理：

- 扫描设备音频文件（MediaStore） - 创建 / 编辑 / 删除自定义歌单 - 收藏夹、播放历史持久化（SQLite） - 文件夹浏览模式

音频增强：均衡器（EQ）、音量增益、无缝播放、淡入淡出

歌词支持：内置歌词解析，支持滚动显示与搜索

主题系统：浅色 / 深色 / 跟随系统，多套主题色可选

音源扩展：兼容洛雪风格音源配置导入，恢复在线搜索与播放能力

📦 构建产物（ABI 分包）

项目按 CPU 架构拆分 APK，减小体积、提升兼容性：

架构 适用设备 arm64-v8a ✅ 现代 64 位 ARM（当前手机/平板主流） armeabi-v7a 大多数 32 位 ARM 设备 x86_64 Intel / AMD 64 位模拟器 x86 Intel / AMD 32 位模拟器

💡 手机用户直接选 arm64-v8a 即可，体积最小、性能最优。 🛠 技术栈

Flutter / Dart + just_audio / audio_service 音频引擎 + SQLite 本地存储 + 分层架构（UI / 状态 / 数据三层分离）

📌 快速上手（开发）

flutter pub get flutter run flutter build apk --split-per-abi # 按架构分包构建

💡 与同类项目对比

项目 定位 在线音源 平台 青听音乐 本地播放器 + 可导入音源 ❌ 无内置（需导入） Android MintMusic 多音源聚合 ✅ 内置 5 源 Android 珊瑚音乐 跨平台全功能 ✅ 内置 5 源 + 插件 iOS/Android/鸿蒙

青听的核心差异化：

1. 纯净无广告，专注本地播放体验，隐私友好 2. 音源可插拔——保留洛雪生态兼容性，用户自主控制音源 3. 轻量架构——放弃内置音源后，APK 体积更小、运行更稳

⚠️ 项目声明仅供学习交流，在线音乐版权归原版权方所有，请支持正版。

一句话总结：青听音乐走的是「减法路线」——剥离内置音源、回归本地播放本质，通过开放音源导入保持扩展性，适合追求纯净体验、愿意自己配置音源的用户，也更适合作为学习 Flutter 分层架构的中型实战案例。 音源 https://13413.kstore.vip/QingMusic/music.json