ساخت موزیک پلیر ساده با پایتون و Pygame

آموزش ساخت پخش‌کننده موسیقی با پایتون و کتابخانه Pygame به همراه کد کامل و نحوه اجرا

پروژه ۴ دقیقه مطالعه
فهرست مطالب
این مطلب از سایت tool.hamidvalad.ir گرفته شده است

معرفی

موزیک پلیر (Music Player) یکی از پروژه‌های ساده و کاربردی برای یادگیری برنامه‌نویسی با پایتون است. با استفاده از کتابخانه Pygame می‌توان علاوه بر ساخت بازی، فایل‌های صوتی را نیز پخش و مدیریت کرد.

در این پروژه قصد داریم یک پخش‌کننده موسیقی ساده با پایتون بسازیم که امکاناتی مانند پخش آهنگ، توقف موقت، ادامه پخش، توقف کامل و خروج از برنامه را در اختیار کاربر قرار می‌دهد.

این برنامه از یک منوی متنی استفاده می‌کند و برای اجرا نیازی به پنجره گرافیکی ندارد.

نصب و پیش‌نیازها

برای اجرای این پروژه به پایتون نسخه ۳ و کتابخانه Pygame نیاز دارید.

ابتدا کتابخانه Pygame را با دستور زیر نصب کنید:

کد

python -m pip install pygame

همچنین باید یک فایل موسیقی با نام music.mp3 در کنار فایل اصلی برنامه قرار دهید.

ساختار پوشه پروژه به شکل زیر خواهد بود:

MusicPlayer/
│
├── music_player.py
└── music.mp3

نکته: ممکن است پخش بعضی فایل‌های MP3 به دلیل ناسازگاری فرمت یا کدک صوتی با مشکل مواجه شود. در این شرایط می‌توانید از فایل‌های صوتی با فرمت OGG یا WAV استفاده کنید.

ساختار کلی کد

کد موزیک پلیر از بخش‌های اصلی زیر تشکیل شده است:

  • وارد کردن کتابخانه: استفاده از Pygame برای مدیریت فایل‌های صوتی.

  • راه‌اندازی سیستم صوتی: مقداردهی اولیه بخش Mixer کتابخانه Pygame.

  • بارگذاری موسیقی: انتخاب و بارگذاری فایل صوتی موردنظر.

  • منوی کاربری: نمایش گزینه‌های مختلف برای کنترل موسیقی.

  • مدیریت دستورات: بررسی انتخاب کاربر و اجرای دستور مناسب.

  • خروج از برنامه: توقف موسیقی و آزادسازی منابع صوتی.

قابلیت‌های موزیک پلیر

پخش موسیقی (Play)

برای شروع پخش آهنگ از دستور زیر استفاده می‌کنیم:

pygame.mixer.music.play()

با اجرای این دستور، فایل موسیقی بارگذاری‌شده از ابتدا پخش می‌شود.

توقف موقت موسیقی (Pause)

برای متوقف کردن موقت آهنگ، بدون اینکه موقعیت فعلی پخش از بین برود، از دستور زیر استفاده می‌کنیم:

pygame.mixer.music.pause()

ادامه پخش موسیقی (Resume)

برای ادامه پخش آهنگ از همان نقطه‌ای که متوقف شده است، دستور زیر را به کار می‌بریم:

pygame.mixer.music.unpause()

توقف کامل موسیقی (Stop)

برای توقف کامل پخش آهنگ از دستور زیر استفاده می‌کنیم:

pygame.mixer.music.stop()

با اجرای این دستور، پخش موسیقی متوقف می‌شود و برای شروع مجدد باید دوباره دستور Play اجرا شود.

خروج از برنامه (Exit)

برای خروج از برنامه ابتدا موسیقی را متوقف می‌کنیم و سپس سیستم صوتی Pygame را می‌بندیم:

pygame.mixer.music.stop()
pygame.mixer.quit()

کد کامل موزیک پلیر

در ادامه کد کامل و یکپارچه پروژه موزیک پلیر با استفاده از پایتون و کتابخانه Pygame قرار داده شده است:

کد

import pygame

# Initialize pygame mixer
pygame.mixer.init()

# Load music file
pygame.mixer.music.load("music.mp3")

# Display menu
print("1. Play")
print("2. Pause")
print("3. Resume")
print("4. Stop")
print("5. Exit")

# Main program loop
while True:
    choice = input("Choose an option: ")

    if choice == "1":
        pygame.mixer.music.play()
        print("Music is playing")

    elif choice == "2":
        pygame.mixer.music.pause()
        print("Music paused")

    elif choice == "3":
        pygame.mixer.music.unpause()
        print("Music resumed")

    elif choice == "4":
        pygame.mixer.music.stop()
        print("Music stopped")

    elif choice == "5":
        pygame.mixer.music.stop()
        pygame.mixer.quit()
        print("Goodbye!")
        break

    else:
        print("Invalid option")

نتیجه اجرای کد

پس از اجرای برنامه، منوی موزیک پلیر در محیط ترمینال نمایش داده می‌شود و کاربر می‌تواند با وارد کردن شماره هر گزینه، عملکرد موردنظر خود را انتخاب کند.

برای مثال، اگر گزینه‌های ۱، ۲، ۳ و ۵ را به‌ترتیب وارد کنیم، خروجی برنامه به شکل زیر خواهد بود:

خروجی

1. Play
2. Pause
3. Resume
4. Stop
5. Exit

Choose an option: 1
Music is playing

Choose an option: 2
Music paused

Choose an option: 3
Music resumed

Choose an option: 5
Goodbye!
نکته مهم

خروجی بالا فقط پیام‌های متنی برنامه را نشان می‌دهد. صدای واقعی موسیقی از فایل music.mp3 پخش می‌شود و در ترمینال نمایش داده نمی‌شود.

نحوه اجرا

برای اجرای پروژه مراحل زیر را دنبال کنید:

  1. کد بالا را در فایلی با نام music_player.py ذخیره کنید.

  2. کتابخانه Pygame را با دستور python -m pip install pygame نصب کنید.

  3. یک فایل موسیقی با نام music.mp3 در کنار فایل پایتون قرار دهید.

  4. ترمینال را در پوشه پروژه باز کنید.

  5. دستور زیر را اجرا کنید:

python music_player.py

بعد از اجرای برنامه، منوی انتخاب گزینه‌ها نمایش داده می‌شود. با وارد کردن شماره هر گزینه می‌توانید پخش موسیقی را کنترل کنید.

نتیجه‌گیری

در این پروژه با استفاده از کتابخانه Pygame یک موزیک پلیر ساده با پایتون ساختیم. با چند دستور اصلی pygame.mixer.music توانستیم قابلیت‌های پخش، مکث، ادامه پخش و توقف موسیقی را پیاده‌سازی کنیم.

این پروژه تمرین مناسبی برای آشنایی با مدیریت فایل‌های صوتی، دریافت ورودی از کاربر و استفاده از حلقه‌های تکرار و شرط‌ها در پایتون است.

در مراحل بعدی می‌توانید امکانات بیشتری مانند کنترل میزان صدا (Volume)، ساخت رابط گرافیکی، رفتن به آهنگ بعدی و قبلی و ایجاد فهرست پخش (Playlist) را به موزیک پلیر اضافه کنید.

منابع و مستندات