Equalizer FX - Android Audio Processing App

Ứng dụng Android điều chỉnh âm thanh chuyên nghiệp với đầy đủ tính năng equalizer, bass boost, visualizer và các hiệu ứng 3D/8D.

Tính năng

🎛️ Audio Processing

• 20-Band Equalizer: Điều chỉnh chính xác 20 dải tần số từ 31Hz đến 16kHz
• Bass Boost: Tăng cường âm trầm mạnh mẽ (0-1000)
• Treble Boost: Tăng cường âm cao rõ ràng
• Reverb: Hiệu ứng vang với 5 preset (None, Small Room, Medium Room, Large Room, Plate)
• 3D Audio Effect: Hiệu ứng âm thanh 3D sống động (Virtualizer)
• 8D Audio Effect: Hiệu ứng âm thanh xoay vòng 8D độc đáo

📊 Audio Visualizer

• Waveform: Sóng nhạc thời gian thực
• Bass Bars: 10 cột hiển thị mức bass
• Treble Bars: 10 cột hiển thị mức treble
• Frequency Bands: 20 cột hiển thị từng dải tần số

🎵 Media Player

• Phát file MP3, MP4, và các định dạng audio khác
• Điều chỉnh âm thanh trực tiếp trên file đang phát
• 2 chế độ hoạt động:
  • File Playback: Điều chỉnh âm thanh file đang phát trong app
  • System Audio (yêu cầu quyền root/system): Điều chỉnh toàn bộ âm thanh hệ thống

⚠️ Lưu ý quan trọng về System Audio Mode

Do giới hạn bảo mật của Android, chế độ System Audio (điều chỉnh âm thanh toàn hệ thống) chỉ hoạt động trên:

• Thiết bị đã root với quyền truy cập system
• ROM custom có cấp quyền MODIFY_AUDIO_ROUTING
• Build được ký với platform key

Trên thiết bị Android thông thường (non-root), chỉ có chế độ File Playback hoạt động được. Đây là giới hạn của Android platform, không phải lỗi của ứng dụng.

Yêu cầu

• Android 7.0 (API 24) trở lên
• Quyền truy cập: RECORD_AUDIO, MODIFY_AUDIO_SETTINGS, READ_MEDIA_AUDIO

Build Instructions

Local Build

# Clone repository
git clone <your-repo-url>
cd EqualizerFX

# Build debug APK
./gradlew assembleDebug

# Build release APK
./gradlew assembleRelease

# APK output location:
# Debug: app/build/outputs/apk/debug/app-debug.apk
# Release: app/build/outputs/apk/release/app-release-unsigned.apk

GitHub Actions Build

Ứng dụng được cấu hình để tự động build APK thông qua GitHub Actions khi push code lên repository.

Cách sử dụng:

1. Push code lên GitHub repository của bạn:

git add .
git commit -m "Initial commit"
git push origin main

2. Truy cập tab Actions trên GitHub repository

3. Workflow "Android CI - Build APK" sẽ tự động chạy

4. Sau khi build xong, tải APK từ Artifacts:

   • app-debug.apk: Bản debug
   • app-release-unsigned.apk: Bản release (chưa ký)

Trigger Build:

• Tự động khi push lên branch main hoặc master
• Tự động khi tạo Pull Request
• Thủ công: Tab Actions > Android CI - Build APK > Run workflow

Cấu trúc dự án

app/
├── src/main/
│   ├── java/com/equalizerfx/app/
│   │   ├── MainActivity.kt              # Activity chính
│   │   ├── audio/
│   │   │   ├── AudioEngine.kt          # Xử lý equalizer & effects
│   │   │   └── AudioVisualizer.kt      # Xử lý visualizer
│   │   ├── player/
│   │   │   └── MediaPlayerManager.kt   # Quản lý media player
│   │   ├── service/
│   │   │   └── AudioService.kt         # Foreground service
│   │   └── ui/components/              # UI components
│   │       ├── EqualizerView.kt
│   │       ├── VisualizerView.kt
│   │       ├── EffectsControls.kt
│   │       └── PlayerControls.kt
│   └── AndroidManifest.xml
├── build.gradle.kts
└── proguard-rules.pro

Công nghệ sử dụng

• Kotlin: Ngôn ngữ lập trình chính
• Jetpack Compose: UI framework hiện đại
• Android Audio Framework:
  • android.media.audiofx.Equalizer
  • android.media.audiofx.BassBoost
  • android.media.audiofx.Virtualizer
  • android.media.audiofx.PresetReverb
  • android.media.audiofx.Visualizer
• Coroutines & Flow: Xử lý bất đồng bộ
• Material Design 3: Giao diện Material Design

Hướng dẫn sử dụng

1. Chọn chế độ Audio Source:

   • File Playback (khuyến nghị): Hoạt động trên mọi thiết bị
   • System Audio: Chỉ cho thiết bị root/custom ROM (xem SYSTEM_AUDIO_GUIDE.md)

2. File Playback Mode:

   • Nhấn nút folder để chọn file MP3/MP4
   • Nhấn Play để phát nhạc
   • Tất cả effects sẽ áp dụng lên file đang phát

3. System Audio Mode (chỉ thiết bị root):

   • Bật ứng dụng nhạc bất kỳ (YouTube Music, Spotify, etc.)
   • Phát nhạc từ app đó
   • Quay lại Equalizer FX và điều chỉnh - effects sẽ áp dụng cho toàn bộ âm thanh hệ thống

4. Điều chỉnh:

   • Equalizer: Kéo 20 thanh trượt để điều chỉnh từng dải tần số
   • Bass/Treble Boost: Tăng cường âm trầm/cao
   • Reverb: Thêm hiệu ứng vang
   • 3D/8D Effects: Bật hiệu ứng không gian âm thanh

5. Visualizer: Xem sóng nhạc real-time (waveform, bass, treble, frequency bands)

License

Copyright © 2024 Equalizer FX