Python开发简易音乐播放器的示例详解_Python

开发环境准备-音乐获取

从酷狗音乐中单个获取，需要先登录

import requests
import json
headers = {
    'accept': '*/*',
    'accept-language': 'zh-cn,zh;q=0.9',
    'cache-control': 'no-cache',
    'origin': 'https://www.kugou.com',
    'pragma': 'no-cache',
    'priority': 'u=1, i',
    'referer': 'https://www.kugou.com/',
    'sec-ch-ua': '"chromium";v="136", "google chrome";v="136", "not.a/brand";v="99"',
    'sec-ch-ua-mobile': '?0',
    'sec-ch-ua-platform': '"windows"',
    'sec-fetch-dest': 'empty',
    'sec-fetch-mode': 'cors',
    'sec-fetch-site': 'same-site',
    'user-agent': 'mozilla/5.0 (windows nt 10.0; win64; x64) applewebkit/537.36 (khtml, like gecko) chrome/136.0.0.0 safari/537.36',
}

params = {
    'srcappid': '2919',
    'clientver': '20000',
    'clienttime': '1748689562754',
    'mid': '9c90f73615e8fc1dee91f84b68332ed8',
    'uuid': '9c90f73615e8fc1dee91f84b68332ed8',
    'dfid': '1jbra41joypa2zrk752ps3ya',
    'appid': '1014',
    'platid': '4',
    'encode_album_audio_id': 'bwnubuc3',
    'token': '0837e5097e56fabd6e9164d753b05b7c073a6a393bf34fb687bd69cf80d623e8',
    'userid': '660825514',
    'signature': '63e40caebe53219e46622202bc5112a1',
}
# 获取内容
response = requests.get('https://wwwapi.kugou.com/play/songinfo', params=params, headers=headers).text
data = json.loads(response) # 转换成json格式
res = requests.get(data['data']['play_url'], headers=headers) # 再次发起请求，获取音乐
# 标题
title = data['data']['audio_name']
with open(f'{title}.mp3', 'wb') as f:
    f.write(res.content)
    print("下载完成")
    f.close()

那么单个音乐就下载好了菲菲公主（陆绮菲） - 第57次取消发送.mp3

核心功能概述

音乐文件选择：允许用户从文件系统中选择音乐文件

播放控制：播放、暂停、停止、调整音量

播放列表管理：添加、删除、显示音乐文件

界面显示：简洁的图形用户界面

代码实现与知识点解析

1. 导入必要的库

import pygame
import tkinter as tk
from tkinter import filedialog, messagebox
import os
import time
from threading import thread

知识点：

pygame：python游戏开发库，提供音频处理功能
tkinter：python标准gui库，用于创建图形界面
os：操作系统接口，用于文件路径处理
threading：线程管理，用于后台播放音乐

2. 初始化pygame和音频系统

# 初始化pygame
pygame.init()
# 初始化音频系统
pygame.mixer.init()

知识点：

pygame.init()：初始化所有pygame模块
pygame.mixer.init()：初始化音频系统，为音乐播放做准备

3. 创建音乐播放器类

class musicplayer:
    def __init__(self, root):
        self.root = root
        self.root.title("python简易音乐播放器")
        self.root.geometry("500x400")
        self.root.resizable(false, false)
        self.root.configure(bg="#f0f0f0")

        # 音乐播放状态
        self.is_playing = false
        self.current_track = none
        self.playlist = []

        # 创建界面
        self.create_ui()
        
        # 更新播放状态的线程
        self.update_thread = thread(target=self.update_play_state)
        self.update_thread.daemon = true
        self.update_thread.start()

知识点：

类的定义与初始化：面向对象编程
gui窗口配置：设置标题、大小、背景色
线程使用：创建后台线程监控播放状态

4. 创建用户界面

def create_ui(self):
    # 标题标签
    self.title_label = tk.label(self.root, text="python简易音乐播放器", font=("arial", 16), bg="#f0f0f0")
    self.title_label.pack(pady=10)
    
    # 当前播放标签
    self.current_label = tk.label(self.root, text="当前未播放任何音乐", font=("arial", 10), bg="#f0f0f0", width=45)
    self.current_label.pack(pady=5)
    
    # 播放列表框
    self.listbox_frame = tk.frame(self.root)
    self.listbox_frame.pack(pady=5)
    
    self.playlist_box = tk.listbox(self.listbox_frame, width=60, height=10)
    self.playlist_box.pack(side=tk.left, fill=tk.both)
    
    self.scrollbar = tk.scrollbar(self.listbox_frame)
    self.scrollbar.pack(side=tk.right, fill=tk.y)
    
    self.playlist_box.config(yscrollcommand=self.scrollbar.set)
    self.scrollbar.config(command=self.playlist_box.yview)
    
    # 播放控制按钮框
    self.control_frame = tk.frame(self.root, bg="#f0f0f0")
    self.control_frame.pack(pady=10)
    
    # 播放按钮
    self.play_button = tk.button(self.control_frame, text="播放", width=8, command=self.play_music)
    self.play_button.grid(row=0, column=0, padx=5)
    
    # 暂停按钮
    self.pause_button = tk.button(self.control_frame, text="暂停", width=8, command=self.pause_music)
    self.pause_button.grid(row=0, column=1, padx=5)
    
    # 停止按钮
    self.stop_button = tk.button(self.control_frame, text="停止", width=8, command=self.stop_music)
    self.stop_button.grid(row=0, column=2, padx=5)
    
    # 添加音乐按钮
    self.add_button = tk.button(self.control_frame, text="添加音乐", width=8, command=self.add_music)
    self.add_button.grid(row=0, column=3, padx=5)
    
    # 删除音乐按钮
    self.remove_button = tk.button(self.control_frame, text="删除音乐", width=8, command=self.remove_music)
    self.remove_button.grid(row=0, column=4, padx=5)
    
    # 音量控制框
    self.volume_frame = tk.frame(self.root, bg="#f0f0f0")
    self.volume_frame.pack(pady=5)
    
    self.volume_label = tk.label(self.volume_frame, text="音量:", bg="#f0f0f0")
    self.volume_label.grid(row=0, column=0, padx=5)
    
    self.volume_scale = tk.scale(self.volume_frame, from_=0, to=100, orient=tk.horizontal, command=self.set_volume)
    self.volume_scale.set(70)  # 默认音量70%
    self.volume_scale.grid(row=0, column=1, padx=5)
    
    # 设置初始音量
    pygame.mixer.music.set_volume(0.7)
    
    # 双击播放
    self.playlist_box.bind("<double-1>", self.play_selected)

知识点：

tkinter布局管理：pack、grid布局方式
控件使用：label、button、listbox、scrollbar、scale等
事件绑定：将双击事件绑定到播放功能

5. 音乐播放控制功能

def add_music(self):
    """添加音乐到播放列表"""
    file_paths = filedialog.askopenfilenames(
        title="选择音乐文件",
        filetypes=(("音频文件", "*.mp3 *.wav *.ogg"), ("所有文件", "*.*"))
    )
    
    for path in file_paths:
        if path:
            # 获取文件名
            filename = os.path.basename(path)
            self.playlist.append(path)
            self.playlist_box.insert(tk.end, filename)

def remove_music(self):
    """从播放列表中删除选中的音乐"""
    try:
        selected_index = self.playlist_box.curselection()[0]
        self.playlist_box.delete(selected_index)
        self.playlist.pop(selected_index)
        
        # 如果删除的是正在播放的曲目，则停止播放
        if self.current_track == selected_index:
            self.stop_music()
            self.current_track = none
    except indexerror:
        messagebox.showinfo("提示", "请先选择要删除的音乐")

def play_selected(self, event=none):
    """播放选中的音乐"""
    try:
        selected_index = self.playlist_box.curselection()[0]
        self.play_music(selected_index)
    except indexerror:
        messagebox.showinfo("提示", "请先选择要播放的音乐")

def play_music(self, index=none):
    """播放音乐"""
    if not self.playlist:
        messagebox.showinfo("提示", "播放列表为空，请先添加音乐")
        return
        
    # 如果指定了索引，则播放指定音乐
    if index is not none:
        self.current_track = index
    # 否则，如果当前没有播放，则播放选中的或第一首
    elif self.current_track is none:
        try:
            self.current_track = self.playlist_box.curselection()[0]
        except indexerror:
            self.current_track = 0
    
    # 加载并播放音乐
    try:
        pygame.mixer.music.load(self.playlist[self.current_track])
        pygame.mixer.music.play()
        self.is_playing = true
        
        # 更新当前播放标签
        current_file = os.path.basename(self.playlist[self.current_track])
        self.current_label.config(text=f"当前播放: {current_file}")
        
        # 高亮显示当前播放的曲目
        self.playlist_box.selection_clear(0, tk.end)
        self.playlist_box.selection_set(self.current_track)
        self.playlist_box.activate(self.current_track)
        self.playlist_box.see(self.current_track)
    except pygame.error:
        messagebox.showerror("错误", "无法播放所选音乐文件")
        self.current_track = none

def pause_music(self):
    """暂停/恢复音乐播放"""
    if self.is_playing:
        pygame.mixer.music.pause()
        self.is_playing = false
        self.pause_button.config(text="恢复")
    else:
        pygame.mixer.music.unpause()
        self.is_playing = true
        self.pause_button.config(text="暂停")

def stop_music(self):
    """停止音乐播放"""
    pygame.mixer.music.stop()
    self.is_playing = false
    self.current_label.config(text="当前未播放任何音乐")
    self.pause_button.config(text="暂停")

def set_volume(self, val):
    """设置音量"""
    volume = float(val) / 100
    pygame.mixer.music.set_volume(volume)

def update_play_state(self):
    """更新播放状态（在后台线程中运行）"""
    while true:
        if self.is_playing and not pygame.mixer.music.get_busy():
            # 当前歌曲播放完毕，播放下一首
            self.root.after(100, self.play_next)
        time.sleep(0.1)

def play_next(self):
    """播放下一首音乐"""
    if not self.playlist:
        return
        
    if self.current_track is not none and self.current_track < len(self.playlist) - 1:
        self.current_track += 1
        self.play_music(self.current_track)
    else:
        # 播放列表结束，停止播放
        self.stop_music()
        self.current_track = none

知识点：

文件对话框：使用filedialog选择音乐文件
音乐控制：使用pygame.mixer.music控制音乐播放
异常处理：使用try/except处理可能的错误
线程同步：使用after方法在主线程中执行函数
事件驱动编程：基于用户操作触发相应功能

6. 主程序入口

def main():
    # 创建主窗口
    root = tk.tk()
    # 创建音乐播放器实例
    app = musicplayer(root)
    # 运行主循环
    root.mainloop()
    
    # 退出时清理资源
    pygame.mixer.quit()
    pygame.quit()

if __name__ == "__main__":
    main()