# MusicPlayer

**Repository Path**: Jackzhou1/music-player

## Basic Information

- **Project Name**: MusicPlayer
- **Description**: 🎵 基于原生 Java 开发的简约 Android 音乐播放器。支持前台服务播放、通知栏控制、Material Design 界面。零第三方依赖，纯净原生开发。


- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-04
- **Last Updated**: 2026-04-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🎵 MusicPlayer

> **A minimalist Android music player built with native Java**

[![Platform](https://img.shields.io/badge/Platform-Android-green.svg)](https://developer.android.com/)
[![Language](https://img.shields.io/badge/Language-Java-orange.svg)](https://www.oracle.com/java/)
[![minSdk](https://img.shields.io/badge/minSdk-30-blue.svg)](https://developer.android.com/guide/topics/manifest/uses-sdk-element)
[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

---

## 🚀 Features

- 🎶 **Native Music Playback** - Built with Android MediaPlayer API
- 🔔 **Notification Controls** - Play/Pause/Next/Previous from notification bar
- 📱 **Foreground Service** - Continuous playback even when app is backgrounded
- 🎨 **Material Design** - Clean and intuitive UI
- ⚡ **Zero Dependencies** - Pure Android SDK, no third-party libraries
- 🔒 **Privacy First** - No permissions required, no data collection

---

## 📸 Screenshots

```
┌─────────────────────────┐
│    🎵 MusicPlayer       │
│                         │
│    ┌───────────────┐    │
│    │   ♫ ♪ ♫ ♪ ♫   │    │
│    │               │    │
│    │  断了的弦      │    │
│    │   周杰伦       │    │
│    │               │    │
│    └───────────────┘    │
│                         │
│    ════════════════     │
│                         │
│   [⏮️]  [▶️]  [⏭️]      │
│                         │
└─────────────────────────┘
```

---

## 🛠️ Tech Stack

| Component | Technology |
|-----------|------------|
| Language | Java 8 |
| UI Framework | Android View System |
| Media | MediaPlayer |
| Background | Foreground Service |
| Notifications | NotificationCompat |
| Architecture | Service + Activity Binding |

---

## 📦 Build & Run

### Prerequisites

- Android Studio Hedgehog | 2023.1.1 or later
- JDK 8 or higher
- Android SDK 30+

### Quick Start

```bash
# Clone the repository
git clone https://github.com/JackZho/MusicPlayer.git
cd MusicPlayer

# Open in Android Studio and run
# Or build via command line
./gradlew assembleDebug

# APK location: app/build/outputs/apk/debug/app-debug.apk
```

---

## 📁 Project Structure

```
MusicPlayer/
├── app/
│   └── src/main/
│       ├── java/com/demo/musicplayer/
│       │   ├── MainActivity.java      # Main UI & user interactions
│       │   ├── MusicService.java      # Background music playback
│       │   └── Song.java              # Song data model
│       ├── res/
│       │   ├── layout/
│       │   │   └── activity_main.xml  # Main UI layout
│       │   ├── raw/
│       │   │   ├── dldx.mp3           # Built-in song: 断了的弦
│       │   │   └── dd.mp3             # Built-in song: 倒带
│       │   ├── drawable/              # Icons & graphics
│       │   ├── values/                # Strings, colors, themes
│       │   └── xml/                   # Backup rules
│       └── AndroidManifest.xml
├── build.gradle
└── README.md
```

---

## 🎯 Core APIs Used

```java
// MediaPlayer for audio playback
MediaPlayer mediaPlayer = new MediaPlayer();

// Foreground Service for background playback
startForeground(NOTIFICATION_ID, notification);

// Service binding for Activity-Service communication
bindService(intent, serviceConnection, Context.BIND_AUTO_CREATE);

// Notification with media controls
NotificationCompat.Builder builder = new NotificationCompat.Builder(context, CHANNEL_ID);
```

---

## 🔐 Permissions

This app requires **minimal permissions**:

| Permission | Purpose |
|------------|---------|
| `WAKE_LOCK` | Keep CPU awake during playback |
| `FOREGROUND_SERVICE` | Run music service in background |
| `POST_NOTIFICATIONS` | Show notification controls (Android 13+) |

> 📌 **Note:** No storage permission needed - all music files are bundled as app resources.

---

## 📱 Device Compatibility

| Android Version | Status |
|-----------------|--------|
| Android 11 (API 30) | ✅ Supported |
| Android 12 (API 31) | ✅ Supported |
| Android 13 (API 33) | ✅ Supported |
| Android 14 (API 34) | ✅ Supported |

---

## 🚧 Roadmap

- [ ] External storage music scanning
- [ ] Playlist management
- [ ] Equalizer settings
- [ ] Album art display
- [ ] Dark mode toggle
- [ ] Swipe gestures

---

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

```
MIT License
Copyright (c) 2026 JackZhou
```

---

## 🤝 Contributing

Contributions are welcome! Feel free to:

1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request

---

## 📬 Contact

- **GitHub**: [@JackZho](https://github.com/JackZho)
- **Gitee**: [@Jackzhou1](https://gitee.com/Jackzhou1)

---

<div align="center">

**Made with ❤️ and ☕ by JackZhou**

⭐ Star this repo if you find it helpful!

</div>