Erela.js 版本升级指南：从旧版本迁移到新版本

前言

Erela.js 是一个功能强大的 Discord 音乐机器人框架，随着版本迭代，v2 版本对 API 进行了多项重要改进。本文将为开发者详细解析从 v1 升级到 v2 版本的关键变化，帮助您顺利完成迁移。

核心类变更

从 ErelaClient 到 Manager

旧版本实现方式：

const { ErelaClient } = require("erela.js");
const client = new Client();
const nodes = [ /* 节点配置 */ ];
const options = {};
client.music = new ErelaClient(client, nodes, options);

新版本实现方式：

const { Manager } = require("erela.js");
const client = new Client();
const nodes = [ /* 节点配置 */ ];
client.music = new Manager({
  nodes,
  send: (id, payload) => {
    const guild = client.guilds.cache.get(id);
    if (guild) guild.shard.send(payload);
  }
});

主要变更点：

1. 类名从 ErelaClient 改为 Manager
2. 不再需要直接传递 Discord 客户端实例
3. 节点配置更加灵活，可以使用默认 Lavalink 配置
4. 必须提供 send 函数来处理语音数据传输

播放器管理变更

创建播放器

v1 版本需要通过 PlayerStore 的 spawn 方法创建播放器，v2 版本简化了这一过程：

// 方式一：通过 Manager 创建
const player = manager.create(options);

// 方式二：直接实例化 Player
const player = new Player(options);

销毁播放器

销毁播放器的方式也变得更加直观：

// 通过 Manager 销毁
manager.destroy("guildId");

// 或通过 Player 实例销毁
player.destroy();

音频处理变更

均衡器设置

均衡器设置语法更加简洁：

// 旧版本
player.setEQ([{ band: 0, gain: .25}, { band: 2, gain: .25}]);

// 新版本
player.setEQ({ band: 0, gain: .25}, { band: 1, gain: .25});

语音连接

v2 版本需要显式调用连接方法：

const player = new Player(options);
player.connect();  // 必须手动连接

队列系统改进

队列类的 current 属性替代了原先数组首元素的设计，使代码更加清晰：

// 旧版本
const currentTrack = player.queue[0];

// 新版本
const currentTrack = player.queue.current;

工具类移除

v2 版本移除了内置的 Utils 工具类，建议使用以下专业库替代：

时间格式化

推荐使用 humanize-duration 库

时间解析

推荐使用 timestring 库

升级建议

1. 逐步迁移：先更新核心功能，再处理边缘用例
2. 测试验证：确保所有音乐相关功能正常工作
3. 错误处理：新版本可能需要调整错误处理逻辑
4. 性能监控：观察新版本在负载下的表现

通过以上指南，您应该能够顺利将 Erela.js 项目从 v1 升级到 v2 版本。新版本的设计更加模块化和灵活，虽然需要一些适应，但长期来看将提高项目的可维护性和扩展性。