Discord.js中如何暂停语音频道正在播放的MP3音频?
Discord.js 实现本地MP3播放暂停功能的操作方案
前置准备
- 首先调整你原有播放逻辑的实例存储方式:你之前调用
VoiceConnection.play方法时,底层会自动创建关联的AudioPlayer实例来承载播放流程,不要把这个实例当成函数局部变量用完就丢,要把AudioPlayer、VoiceConnection实例改为全局可访问的缓存(比如挂载到客户端实例的自定义属性、以服务器ID为key的全局Map),避免暂停指令触发时无法定位到当前运行的播放器对象 - 注意和原有“播放结束自动断开连接”的逻辑做兼容:缓存的实例仅在音频播放结束、连接报错、主动强制断开的节点从缓存中移除,暂停状态下的实例需保留在缓存中
核心实现逻辑
- 暂停指令触发时,先根据当前服务器ID从全局缓存中查询对应的
AudioPlayer实例 - 做前置状态校验:
- 若查询不到有效播放器实例,直接提示用户“当前服务器无正在运行的语音播放任务”
- 若查询到的播放器当前状态不是
playing,直接提示用户“当前音频未处于播放状态,无需执行暂停”
- 校验通过后,直接调用
AudioPlayer内置的pause()方法即可完成暂停动作,不需要手动处理音频流的中断、切分逻辑 - 暂停执行完成后,按照你原有发送自定义
MessageEmbed的逻辑,给频道返回暂停成功的提示即可
参考代码片段
// 暂停指令交互触发后的处理逻辑 const cachedPlayer = client.guildAudioPlayers.get(interaction.guildId); // 无有效播放器的分支 if (!cachedPlayer) { return interaction.reply({ content: "当前没有正在播放的音频任务" }); } // 非播放状态的分支 if (cachedPlayer.state.status !== "playing") { return interaction.reply({ content: "当前音频处于非播放状态,无法暂停" }); } // 执行暂停 cachedPlayer.pause(); // 发送自定义Embed反馈 const pauseNotify = new MessageEmbed() .setDescription("已暂停当前播放的《1am.mp3》") .setColor("#7289da"); interaction.reply({ embeds: [pauseNotify] });
常见踩坑提示
- 暂停操作的调用对象是
@discordjs/voice模块提供的AudioPlayer实例,不要对VoiceConnection对象直接调用暂停方法,否则会报方法不存在的错误 - 调用
pause()方法不会中断当前的音频流、也不会触发播放结束的回调,只要不主动调用stop()方法或者断开语音连接,后续可以通过unpause()方法直接从暂停位置继续播放,不会从头开始加载音频 - 你原有逻辑中的“机器人已在频道时提示占用”的校验不需要修改,只要缓存的播放器实例存在,就说明机器人当前处于语音频道内,暂停操作不会改变机器人的频道归属状态
- 上述实现逻辑适配当前主流的Discord.js v14、@discordjs/voice v0.16+版本,低版本v12及更早的API结构不通用,需要根据对应版本的接口结构调整调用方式
内容的提问来源于stack exchange,提问作者JackF MediaGroup
相关产品推荐
相关产品推荐

