音乐

描述

用户指南

为您的语音频道提供的音频播放器：机器人加入您所在的频道，按播放队列依次播放曲目，并公布正在播放的内容。所有成员均可使用。

功能介绍

• 加入您所在的语音频道并开始播放。
• 将点播请求按服务器堆叠进播放队列。
• 用一条命令添加整个播放列表。
• 在发起请求的频道中公布每首曲目（标题、作者、缩略图）。
• 支持跳过、暂停、继续、停止和调节音量。
• 队列播完后自动退出语音频道。

快速开始（管理员）

1. 无需任何配置：机器人加入服务器后本模块即可使用。
2. 确认机器人能够在相关语音频道中连接和发言。
3. 加入某个语音频道，然后用曲名或链接执行 /music play。
4. 如果播放需要限定给特定成员，请在 Discord 的服务器设置 → 集成中限制 /music 命令。

命令

命令	描述
/music play	播放一首曲目或将其加入队列（可搜索曲名或提供链接）。
/music skip	跳到下一首。
/music pause	暂停播放。
/music resume	继续播放。
/music stop	停止播放，清空队列并断开机器人连接。
/music queue	显示播放队列。
/music volume	调节音量，范围 0 至 100。

在仪表板中设置

本模块在仪表板中没有页面：只能通过上述命令操作。

须知事项

• 本模块依赖一个外部音频服务（Lavalink 服务器），该服务必须已启动且机器人可以访问。若不可用，/music play 会回复"音乐服务当前不可用"；其他所有命令都不会有任何效果。
• 您必须身处某个语音频道才能执行 /music play：机器人会加入您所在的频道。
• 文字搜索会查询 SoundCloud。 如果您想指定来源，请直接粘贴链接：此时会按原样解析。
• 粘贴播放列表链接会一次性把其中所有曲目加入队列。
• 队列是全服务器共用的：只有一个队列，音量作用于整个播放器，而不是针对每位听众。
• /music queue 只显示前 10 首曲目，随后显示剩余曲目数量。
• "正在播放"的公告发送到最近一次 /music play 命令所在的文字频道。
• 有些曲目即使出现在搜索结果中也无法播放（已货币化、受限或有地区封锁的内容）。机器人会予以提示并自动跳到下一首。
• 队列播完后，机器人会自行断开连接；需要重新执行 /music play 才能让它回来。
• 不提供循环播放、随机播放，也不能从队列中移除某首指定曲目：请使用 /music skip 或 /music stop。