如何实现Discord音乐机器人在音乐停止播放后自动离开语音频道？

我之前开发Discord音乐机器人时也碰到过类似的情况，用事件监听没生效大概率是没抓对触发时机，或者没处理中途重新播放的取消逻辑。下面给你分场景提供具体的实现方案：

核心思路 #

音乐停止后启动定时器，5分钟后执行离开操作；如果中途有新音乐开始播放，必须取消之前的定时器，避免机器人误离开。

方案一：使用第三方音乐库（比如discord-player） #

大多数人开发音乐机器人会用这类封装好的库，事件监听更清晰：

1. 首先定义一个变量存储定时器ID，建议绑定到客户端或队列对象上，避免多服务器冲突：

// 在客户端初始化时添加
client.leaveTimeout = null;

2. 监听队列空事件（所有音乐都播放完时触发）：

player.events.on('queueEmpty', async (queue) => {
  // 启动5分钟的离开定时器
  queue.metadata.client.leaveTimeout = setTimeout(async () => {
    try {
      await queue.connection.disconnect();
      console.log(`已离开${queue.channel.name}频道（音乐播放完毕5分钟后自动退出）`);
    } catch (err) {
      console.error('自动离开频道失败：', err);
    }
  }, 300000); // 300000毫秒 = 5分钟
});

3. 监听新曲目开始播放事件，取消之前的定时器：

player.events.on('trackStart', async (queue) => {
  // 如果存在未触发的定时器，立即取消
  if (queue.metadata.client.leaveTimeout) {
    clearTimeout(queue.metadata.client.leaveTimeout);
    queue.metadata.client.leaveTimeout = null;
  }
});

方案二：原生Discord.js实现（无第三方库） #

如果是自己手动处理音频播放，需要监听VoiceConnection的状态变化：

1. 当建立语音连接后，监听状态变更：

const voiceConnection = await channel.join();

// 存储定时器到连接对象上
voiceConnection.leaveTimeout = null;

voiceConnection.on('stateChange', (oldState, newState) => {
  // 检测是否从播放状态切换到空闲状态（音乐停止）
  if (oldState.status === 'playing' && newState.status === 'idle') {
    // 启动离开定时器
    voiceConnection.leaveTimeout = setTimeout(async () => {
      try {
        await voiceConnection.disconnect();
        console.log('音乐停止5分钟后，已自动离开语音频道');
      } catch (err) {
        console.error('自动离开失败：', err);
      }
    }, 300000);
  }

  // 如果重新开始播放，取消定时器
  if (newState.status === 'playing' && voiceConnection.leaveTimeout) {
    clearTimeout(voiceConnection.leaveTimeout);
    voiceConnection.leaveTimeout = null;
  }
});

常见坑点提醒 #

• 多服务器冲突：一定要把定时器绑定到对应服务器的队列/连接对象上，不要用全局变量，否则A服务器的定时器会影响B服务器的机器人。
• 权限问题：确保机器人拥有CONNECT和SPEAK权限，否则离开频道时会报错。
• 测试时缩短时间：调试阶段可以把300000改成10000（10秒），快速验证逻辑是否生效。

内容的提问来源于stack exchange，提问作者user17763427