discord.py音乐机器人如何在播放完成后删除对应mp3文件
单首歌曲播完后精准删除对应本地MP3的实现方案
完全不需要依赖日志解析实现该需求——不少开发者第一反应会想着抓日志解析文件路径,技术上确实能做到,但维护成本极高:只要discord.py、youtube-dl的日志输出格式发生变动,你的删除逻辑就会静默失效,还会因为异常没捕获直接导致进程崩溃。现有架构完全可以通过discord.py内置的播放回调能力直接拿到对应文件的路径,实现精准的单文件删除,远比对日志做正则匹配靠谱。
核心改造思路
- 把本地下载的MP3文件路径绑定到每一个播放实例上,避免全局变量串扰
- 在discord.py内置的播放完成回调
after中,拿到当前播放实例关联的文件路径,执行单文件删除 - 仅对真实落地到本地的下载文件执行删除逻辑,跳过流式播放的临时流地址场景,避免无效报错
具体改造步骤
1. 改造YTDLSource类,存储本地文件路径
现有代码的YTDLSource没有保存实际生成的本地MP3路径,我们需要在类的实例属性中增加这个字段,从根源上把播放内容和对应文件绑定:
class YTDLSource(discord.PCMVolumeTransformer): def __init__(self, source: discord.FFmpegPCMAudio, *, data: dict, volume=0.5, file_path: str = None): super().__init__(source, volume) self.data = data # 新增:存储本地文件路径,流式播放时该值为None self.local_file_path = file_path self.title = data.get('title') self.thumbnail = data.get('thumbnail') self.url = data.get('webpage_url') self.uploader = data.get('uploader') self.uploader_url = data.get('uploader_url') @classmethod async def from_url(cls, url, *, loop=None, stream=False): loop = loop or asyncio.get_event_loop() data = await loop.run_in_executor(None, lambda: ytdl.extract_info(url, download=not stream)) if 'entries' in data: data = data['entries'][0] # 非流式(下载到本地)的场景,计算实际的本地文件路径 local_file_path = None source_path = data['url'] if not stream: source_path = ytdl.prepare_filename(data) # 匹配你配置的outtmpl的.mp3后缀,避免拿到未转码的临时文件路径 local_file_path = source_path.rsplit('.', 1)[0] + '.mp3' return cls( discord.FFmpegPCMAudio(source_path, **ffmpeg_options), data=data, file_path=local_file_path )
2. 改造播放完成的after回调,实现单文件删除
discord.py的voice_client.play()方法自带的after回调,会在播放退出(不管是正常播完、报错中断)时触发,我们在这里加入删除逻辑即可:
@commands.command() async def play(self, ctx, *, url): """Plays from a url (almost anything youtube_dl supports)""" async with ctx.typing(): player = await YTDLSource.from_url(url, loop=self.bot.loop) # 定义播放结束后的处理回调 def after_playback(error): # 保留原有的错误打印逻辑 if error: print(f'Player error: {error}') # 拿到当前播放实例关联的本地文件路径 file_path = player.local_file_path if not file_path: return # 流式播放没有本地文件,直接跳过 # 小延时处理Windows平台下ffmpeg未释放文件句柄的问题 import time time.sleep(1) # 执行单文件删除,加异常捕获避免删失败导致进程崩溃 try: if os.path.isfile(file_path): os.unlink(file_path) print(f'Successfully deleted cached file: {file_path}') except Exception as e: print(f'Failed to delete cached file {file_path}, reason: {e}') ctx.voice_client.play(player, after=after_playback) await ctx.send("Started playing!")
常见避坑点
- 不要使用全局
player变量:多服务器同时使用时会出现实例串扰,后续做播放队列时要把播放状态存在Musiccog的实例属性中,按所属语音客户端做隔离 - 你现有配置的
outtmpl开头带斜杠,实际会被解析为系统根目录下的music_files文件夹,很容易因为权限不足无法写入,建议改成相对路径./music_files/%(id)s.mp3 - 做删除前一定要做场景判断:如果后续开启了
stream=True的流式播放模式,拿到的路径是流媒体地址而非本地文件,直接执行删除会触发无效路径报错 - 跨平台兼容:Windows系统下ffmpeg退出后可能仍持有文件句柄1-2秒,直接删除会触发权限错误,加1秒左右的短延时即可解决
内容的提问来源于stack exchange,提问作者EckigerLuca
相关产品推荐
相关产品推荐

