You need to enable JavaScript to run this app. Discord.js中如何暂停语音频道正在播放的MP3音频?
优惠活动
大模型
产品
解决方案
定价
更多

Discord.js中如何暂停语音频道正在播放的MP3音频?

Discord.js 实现本地MP3播放暂停功能的操作方案

前置准备

  • 首先调整你原有播放逻辑的实例存储方式:你之前调用VoiceConnection.play方法时,底层会自动创建关联的AudioPlayer实例来承载播放流程,不要把这个实例当成函数局部变量用完就丢,要把AudioPlayer、VoiceConnection实例改为全局可访问的缓存(比如挂载到客户端实例的自定义属性、以服务器ID为key的全局Map),避免暂停指令触发时无法定位到当前运行的播放器对象
  • 注意和原有“播放结束自动断开连接”的逻辑做兼容:缓存的实例仅在音频播放结束、连接报错、主动强制断开的节点从缓存中移除,暂停状态下的实例需保留在缓存中

核心实现逻辑

  1. 暂停指令触发时,先根据当前服务器ID从全局缓存中查询对应的AudioPlayer实例
  2. 做前置状态校验:
    • 若查询不到有效播放器实例,直接提示用户“当前服务器无正在运行的语音播放任务”
    • 若查询到的播放器当前状态不是playing,直接提示用户“当前音频未处于播放状态,无需执行暂停”
  3. 校验通过后,直接调用AudioPlayer内置的pause()方法即可完成暂停动作,不需要手动处理音频流的中断、切分逻辑
  4. 暂停执行完成后,按照你原有发送自定义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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.13 17:36:09