使用PyQt5/PySide2编写一个极简的音乐播放器

疫情肆虐，憋在家实在无聊，索性写点东西，于是就有了这个极极极极极简的音乐播放器。

这个极极极简的音乐播放器类似于“阅后即焚”的软件，播放器可以随机播放歌曲，获取下一首歌曲，不能重新播放上一首歌曲，不能获取歌曲的名称和演唱者。听过的歌曲，就像过眼云烟，放完即散。

下面来看看如何用Python实现这个音乐播放器软件吧！

一、创建UI界面

首先，我们来创建这个播放器的UI界面。这个播放器一共有6个控件：

• 左上角的程序关闭按钮；
• 左侧的播放状态标签；
• 顶部的slogan;
• 播放/暂停按钮；
• 下一首按钮；
• 播放进度条；

基于以上控件，我们用一个网格布局来排列：

class Music(QtWidgets.QMainWindow):
    def __init__(self):
        super().__init__()
        self.setFixedSize(400,200)
        self.setWindowTitle("州的先生")
        self.init_ui()
        self.custom_style()
        self.playing = False # 播放状态初始化为否
        self.player = QMediaPlayer(self)

    # 设置样式
    def custom_style(self):
        self.setStyleSheet('''
            #main_widget{
                border-radius:5px;
            }
            #play_btn,#pervious_btn,#next_btn{
                border:none;
            }
            #play_btn:hover,#pervious_btn:hover,#next_btn:hover{
                background:gray;
                border-radius:5px;
                cursor:pointer;
            }
        ''')
        self.close_btn.setStyleSheet('''
            QPushButton{
                background:#F76677;
                border-radius:5px;
                }
            QPushButton:hover{
                background:red;
                }''')
        self.status_label.setStyleSheet('''
            QLabel{
                background:#F7D674;
                border-radius:5px;
                }
        ''')

    # 初始化UI界面
    def init_ui(self):
        # 窗口布局
        self.main_widget = QtWidgets.QWidget()
        self.main_widget.setObjectName("main_widget")
        self.main_layout = QtWidgets.QGridLayout()
        self.main_widget.setLayout(self.main_layout)

        # 标题
        self.title_lable = QtWidgets.QLabel("听者，如过眼云烟……")

        # 关闭按钮
        self.close_btn = QtWidgets.QPushButton("")  # 关闭按钮
        self.close_btn.setFixedSize(15,15)

        # 音乐状态按钮
        self.status_label = QtWidgets.QLabel("")
        self.status_label.setFixedSize(15,15)

        # 播放按钮
        play_icon = qta.icon("fa.play-circle",)
        self.play_btn = QtWidgets.QPushButton(play_icon,"")
        self.play_btn.setIconSize(QtCore.QSize(80, 80))
        self.play_btn.setFixedSize(82,82)
        self.play_btn.setObjectName("play_btn")

        # 下一首按钮
        next_icon = qta.icon("fa.play-circle-o")
        self.next_btn = QtWidgets.QPushButton(next_icon,"")
        self.next_btn.setIconSize(QtCore.QSize(80,80))
        self.next_btn.setFixedSize(82,82)
        self.next_btn.setObjectName("next_btn")

        # 进度条
        self.process_bar = QtWidgets.QProgressBar()
        self.process_value = 0
        self.process_bar.setValue(self.process_value)
        self.process_bar.setFixedHeight(5)
        self.process_bar.setTextVisible(False)

        self.main_layout.addWidget(self.close_btn,0,0,1,1)
        self.main_layout.addWidget(self.title_lable,0,1,1,1)
        self.main_layout.addWidget(self.status_label,1,0,1,1)
        self.main_layout.addWidget(self.play_btn, 1, 1, 1, 1)
        self.main_layout.addWidget(self.next_btn, 1, 2, 1, 1)
        self.main_layout.addWidget(self.process_bar,2,0,1,3)

        self.setCentralWidget(self.main_widget)

在上面的代码中，我们通过Qt内置的按钮控件QPushButton、标签控件QLabel、进度条控件QProgressBar等把播放器的基础界面构建好了，然后通过setStyleSheet()方法设置各个控件的样式，最终得到下面的界面：

顶部的边框有点丑丑的，我们通过setWindowFlag()将其隐藏起来：

self.setWindowFlag(QtCore.Qt.FramelessWindowHint)  # 隐藏边框

这样，完整且好看的界面就完成了，如下图所示：

二、获取网络歌曲

既然是音乐播放器，当然要能够播放音乐。我们创建的这个音乐播放器不能添加本地的音乐，那就只能播放网络的音乐了。州的先生（https://zmister.com）在网上找了很久，终于找到了一个免费稳定的音乐接口。请求这个接口会随机返回一个音乐的播放地址。正好符合我们的播放器的设定，就它了：

def run(self):
    reps = requests.post("https://api.uomg.com/api/rand.music?format=json")
    # print(reps.json())
    file_url = reps.json()['data']['url']
    self.finished_signal.emit(file_url)

我们将其用Qt的线程模块QThread包装起来，作为一个异步的子线程调用：

有了UI界面和网络音乐，下面我们UI界面上的控件与音乐的播放通过信号槽（事件响应）连接起来。

三、创建和链接信号槽

因为我们隐藏的UI界面自带的边框，所以没有了关闭按钮。我们之前创建了左侧小红点作为播放器关闭的按钮，接着还需要一个响应函数来关闭播放器：

# 关闭程序
def close_btn_event(self):
    self.close()
self.close_btn.clicked.connect(self.close_btn_event)

这样，点击小红点，播放器就可以关闭退出了。下面来处理音乐的播放。

在这里，我们借助Qt提供的QtMultimedia子模块中的QMediaPlayer来实现MP3音乐的播放，QtMultimedia的详细使用可见Qt的官方文档：https://doc.qt.io/qtforpython/PySide2/QtMultimedia/index.html#module-PySide2.QtMultimedia：

这个方法，接受一个MP3音乐的网络地址参数，然后通过配置，对其进行播放。

我们之前创建了一个继承于QThread的网络歌曲获取类GetMusicThread，通过创建另一个方法对其进行调用，并将完成信号（finished_signal）连接到init_player()方法即可实现网络歌曲的获取和播放：

在这里，next_music()方法调用GetMusicThread随机获取一首歌曲，然后将歌曲的URL地址返回给init_player()方法，以实现播放。

next_music()方法是播放歌曲的主要方法，播放按钮、下一首按钮、一首歌曲播放完之后自动播放下一首歌曲都可以调用它。

播放音乐按钮需要控制和判断音乐的状态，可通过QMediaPlayer的mediaStatus()方法获取，并以此来进行判断：

为了能够在播放完一首歌曲后自动获取和播放下一首歌曲，我们需要创建一个计时器，每隔一秒获取当前播放器的状态，判断其是否已经播放完了音乐，如果播放完了，就调用next_music()方法：

self.timer = QtCore.QTimer()
self.timer.setInterval(1000)
self.timer.start()
self.timer.timeout.connect(self.check_music_status)

def check_music_status(self):
    player_status = self.player.mediaStatus()
    player_duration = self.player.duration()
    # print("音乐时间：",player_duration)
    # print("当前播放器状态",player_status)
    if player_status == 7:
        self.next_music()

再经过一些细节调整，我们就完成了这个“听后即焚”的网络音乐播放器：

完整的代码可以前往州的先生在Gitee上的仓库（https://gitee.com/zmister/yunyan_music）查看。

本文首发于州的先生博客https://zmister.com，链接为：《使用PyQt5/PySide2编写一个极简的音乐播放器》，更多原创编程实战应用文章，欢迎前往阅读。