用Python和PyQt5打造你的专属音乐播放器！轻松创建带封面的音乐列表

LIY若依

已于 2024-08-01 20:26:12 修改

阅读量3.2k

点赞数 28

文章标签： qt python 开发语言音乐播放器 PyQt5 UI设计 PyQt5

于 2024-08-01 20:19:41 首次发布

本文链接：https://blog.csdn.net/m0_74972192/article/details/140856305

版权

在本文中，我们将介绍如何使用Python的PyQt5库创建一个简单的音乐播放器。这个音乐播放器可以显示歌曲的封面，并且点击封面就可以播放对应的歌曲。

依赖库

首先，我们需要安装PyQt5库。可以使用以下命令进行安装：

pip install PyQt5

功能如下：

显示歌曲列表：程序会在指定的目录（在这个例子中是"D:/song"）中搜索所有的.mp3文件和.jpg文件。每一首歌曲都会与一个封面图片配对，并显示在列表中。
点击播放音乐：当你点击列表中的一首歌（或者说，点击一张封面图片）时，程序会开始播放对应的音乐。

说明

这个音乐播放器可以显示歌曲的封面，并且点击封面就可以播放对应的歌曲。我们通过逐步解析代码片段的方式，详细讲解了每个步骤和代码的功能。

代码解析

1. 导入所需的模块和库

import os
import sys

from PyQt5.QtCore import QUrl, QSize, Qt
from PyQt5.QtGui import QIcon
from PyQt5.QtMultimedia import QMediaPlayer, QMediaContent
from PyQt5.QtWidgets import QApplication, QWidget, QLabel, QListWidget, QListWidgetItem, QVBoxLayout

这些导入语句包含了我们需要的所有PyQt5模块和其他标准库。

2. 定义全局变量

# Directory where your songs and covers are located
SONG_DIR = "D:/song"

这里定义了一个全局变量SONG_DIR，用于存放你的歌曲和封面的目录。

3. 创建主窗口类

class HomePage(QWidget):
    def __init__(self):
        super().__init__()
        self.initUI()

我们定义了一个名为HomePage的类，这个类继承自QWidget。在这个类中，我们定义了一些方法来初始化UI，获取歌曲和封面，以及播放歌曲。

4. 初始化UI

def initUI(self):
    self.setWindowTitle('LIY若依_音乐播放器')
    self.setGeometry(100, 100, 600, 500)

    self.layout = QVBoxLayout()
    self.setLayout(self.layout)

    # Title label
    self.title_label = QLabel('LIY若依_音乐播放器', self)
    self.title_label.setStyleSheet('font-size: 24px; font-weight: bold; margin-bottom: 20px;')
    self.layout.addWidget(self.title_label, alignment=Qt.AlignCenter)

    # Song list
    self.song_list = QListWidget(self)
    self.song_list.setStyleSheet('QListWidget { background-color: #f0f0f0; border: none; }')
    self.song_list.setViewMode(QListWidget.IconMode)
    self.song_list.setIconSize(QSize(250, 250))
    self.song_list.setSpacing(10)
    self.song_list.setResizeMode(QListWidget.Adjust)
    self.layout.addWidget(self.song_list)

    # Load songs and covers
    songs_with_covers = self.get_songs_with_covers()
    for song_info in songs_with_covers:
        item = QListWidgetItem()
        item.setText(song_info['song'].replace('.mp3', ''))
        cover_path = os.path.join(SONG_DIR, song_info['cover'])
        item.setIcon(QIcon(cover_path))
        item.setData(Qt.UserRole, song_info)  # Store song info as data
        self.song_list.addItem(item)

    # Audio player
    self.mediaPlayer = QMediaPlayer(self)

    # Connect item clicked signal
    self.song_list.itemClicked.connect(self.play_song)

    self.show()

在initUI方法中，我们创建了一个标题标签，一个歌曲列表，以及一个音频播放器。我们还连接了歌曲列表的itemClicked信号到play_song方法，这样当用户点击一个歌曲时，就会播放对应的歌曲。

5. 获取歌曲和封面

def get_songs_with_covers(self):
    songs = [f for f in os.listdir(SONG_DIR) if f.endswith('.mp3')]
    covers = [f for f in os.listdir(SONG_DIR) if f.endswith('.jpg')]

    # Sort songs and covers for consistent ordering
    songs.sort()
    covers.sort()

    songs_with_covers = []
    for song in songs:
        # Assuming cover image has the same name as the song
        song_name = os.path.splitext(song)[0]
        cover_name = song_name + '.jpg'
        if cover_name in covers:
            songs_with_covers.append({'song': song, 'cover': cover_name})

    return songs_with_covers

在get_songs_with_covers方法中，我们获取了所有的歌曲和封面，并将它们配对起来。

6. 播放歌曲

def play_song(self, item):
    song_info = item.data(Qt.UserRole)
    song_filename = song_info['song']
    song_path = os.path.join(SONG_DIR, song_filename)
    self.mediaPlayer.setMedia(QMediaContent(QUrl.fromLocalFile(song_path)))
    self.mediaPlayer.play()

在play_song方法中，我们获取了被点击的歌曲的信息，然后使用QMediaPlayer播放这首歌曲。

7. 主函数

if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = HomePage()
    sys.exit(app.exec_())

最后，我们在主函数中创建了一个QApplication实例和一个HomePage实例，然后进入了应用程序的主循环。

完整代码如下：

import os
import sys

from PyQt5.QtCore import QUrl, QSize, Qt
from PyQt5.QtGui import QIcon
from PyQt5.QtMultimedia import QMediaPlayer, QMediaContent
from PyQt5.QtWidgets import QApplication, QWidget, QLabel, QListWidget, QListWidgetItem, QVBoxLayout

# Directory where your songs and covers are located
SONG_DIR = "D:/song"


class HomePage(QWidget):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        self.setWindowTitle('LIY若依_音乐播放器')
        self.setGeometry(100, 100, 600, 500)

        self.layout = QVBoxLayout()
        self.setLayout(self.layout)

        # Title label
        self.title_label = QLabel('LIY若依_音乐播放器', self)
        self.title_label.setStyleSheet('font-size: 24px; font-weight: bold; margin-bottom: 20px;')
        self.layout.addWidget(self.title_label, alignment=Qt.AlignCenter)

        # Song list
        self.song_list = QListWidget(self)
        self.song_list.setStyleSheet('QListWidget { background-color: #f0f0f0; border: none; }')
        self.song_list.setViewMode(QListWidget.IconMode)
        self.song_list.setIconSize(QSize(250, 250))
        self.song_list.setSpacing(10)
        self.song_list.setResizeMode(QListWidget.Adjust)
        self.layout.addWidget(self.song_list)

        # Load songs and covers
        songs_with_covers = self.get_songs_with_covers()
        for song_info in songs_with_covers:
            item = QListWidgetItem()
            item.setText(song_info['song'].replace('.mp3', ''))
            cover_path = os.path.join(SONG_DIR, song_info['cover'])
            item.setIcon(QIcon(cover_path))
            item.setData(Qt.UserRole, song_info)  # Store song info as data
            self.song_list.addItem(item)

        # Audio player
        self.mediaPlayer = QMediaPlayer(self)

        # Connect item clicked signal
        self.song_list.itemClicked.connect(self.play_song)

        self.show()

    def get_songs_with_covers(self):
        songs = [f for f in os.listdir(SONG_DIR) if f.endswith('.mp3')]
        covers = [f for f in os.listdir(SONG_DIR) if f.endswith('.jpg')]

        # Sort songs and covers for consistent ordering
        songs.sort()
        covers.sort()

        songs_with_covers = []
        for song in songs:
            # Assuming cover image has the same name as the song
            song_name = os.path.splitext(song)[0]
            cover_name = song_name + '.jpg'
            if cover_name in covers:
                songs_with_covers.append({'song': song, 'cover': cover_name})

        return songs_with_covers

    def play_song(self, item):
        song_info = item.data(Qt.UserRole)
        song_filename = song_info['song']
        song_path = os.path.join(SONG_DIR, song_filename)
        self.mediaPlayer.setMedia(QMediaContent(QUrl.fromLocalFile(song_path)))
        self.mediaPlayer.play()


if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = HomePage()
    sys.exit(app.exec_())

代码片段详解

1. 导入所需的模块和库

导入了os和sys模块，以及PyQt5库中的一些模块，包括QUrl、QSize、Qt、QIcon、QMediaPlayer、QMediaContent、QApplication、QWidget、QLabel、QListWidget、QListWidgetItem和QVBoxLayout。这些模块和库提供了创建和管理图形用户界面、处理多媒体内容等功能。