# flutter 音乐APP

**Repository Path**: mrcoderdeclan/fltter_music

## Basic Information

- **Project Name**: flutter 音乐APP
- **Description**: flutter
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2025-05-16
- **Last Updated**: 2025-05-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<!--
 * @Author: xhg
 * @Date: 2025-01-14 11:02:57
 * @LastEditors: xhg
 * @LastEditTime: 2025-01-14 11:09:07
-->
# Flutter Music App

一个基于 Flutter 开发的音乐视频播放器应用，支持音乐在线播放、视频播放和下载等功能。

## 功能特性

### 音乐播放

- 🎵 在线音乐播放与搜索
- 📝 实时歌词同步显示
- 📋 播放列表管理
- 🔄 多种播放模式（单曲循环/列表循环/随机播放）
- 🎧 后台播放与通知栏控制
- 💬 音乐评论查看

### 视频功能

- 🎬 视频在线播放
- ⬇️ 视频下载管理
- 📱 本地视频播放
- 🖥️ 全屏播放支持
- 👆 手势控制进度
- 📎 自动识别剪贴板视频链接

### 其他功能

- 🔍 搜索功能
- 👤 UP主页面
- 💾 本地存储
- 📦 下载管理
- 📝 播放历史记录

## 技术栈

### 核心框架

- Flutter 3.4.4
- Dart 3.4.4

### 主要技术

- Provider：状态管理
- Hive：本地数据存储
- Just Audio：音频播放引擎
- Video Player：视频播放支持
- HTTP：网络请求
- Logger：日志管理

## 项目结构

lib/
├── main.dart # 应用入口
├── models/ # 数据模型
├── pages/ # 页面
│ ├── main/ # 主页面
│ ├── search/ # 搜索相关
│ └── video/ # 视频相关
├── providers/ # 状态管理
├── services/ # 服务层
│ ├── api_service.dart # API 服务
│ ├── audio_service.dart # 音频服务
│ ├── playlist_service.dart # 播放列表服务
│ └── notification_service.dart # 通知服务
├── utils/ # 工具类
└── widgets/ # 可复用组件

## 开发环境要求

- Flutter SDK: >=3.4.4 <4.0.0
- Android Studio / VS Code
- Android SDK: 33
- iOS 12.0+

## 运行方式

1. 确保已安装 Flutter
2. 运行 `flutter pub get` 安装依赖
3. 运行 `flutter run` 启动应用

## 注意事项

- 请确保已安装 Flutter 和 Dart 的最新版本
- 请确保已安装 Android Studio 或 VS Code
- 请确保已安装 Android SDK 33
- 请确保已安装 iOS 12.0+


## 功能预览


## 开源协议
MIT License

## 致谢
感谢以下开源项目：
- [just_audio](https://pub.dev/packages/just_audio)
- [provider](https://pub.dev/packages/provider)
- [hive](https://pub.dev/packages/hive)
- [video_player](https://pub.dev/packages/video_player)