音乐 | Noxyr 文档

播放歌曲

加入语音频道，然后使用 /play 加上歌名或链接。输入歌名会在 YouTube 中搜索；输入 ytm: 可搜索 YouTube Music，输入 sc: 可搜索 SoundCloud；也可以直接粘贴 Apple Music、SoundCloud、YouTube 或 Spotify 链接：单曲，以及播放列表和专辑，它们会按顺序完整加载（Spotify 播放列表必须为公开）。输入时，自动补全会显示最匹配的结果。

机器人会在频道中发布一张播放器卡片，并持续更新：标题、艺人、进度条、点歌人、音量、循环以及下一首。如果服务器设置为 V2 布局，卡片会是一个 Components V2 容器，控制按钮位于其中。

⏮ ⏯ ⏭ ⏹ 🔀: 上一首、暂停或继续、跳过、停止并离开、随机播放。
🔁 🔉 🔊: 循环关闭 → 单曲 → 队列；音量以 10 为步长增减。
🎚: 使用下拉菜单切换音效滤镜预设：低音增强、Nightcore、Vaporwave、8D、卡拉 OK、变速、变调、重置。
📃 与下拉菜单: 显示队列，或直接跳转到队列中的某首歌曲。

谁可以控制播放器

当前曲目的点歌人、拥有“管理服务器”权限的成员，以及拥有 DJ 身份组的成员，都可以使用所有控制功能。如果未设置 DJ 身份组，语音频道中的所有人都视为 DJ。

其他人仍然可以按下跳过：这会变成一次投票，当语音频道中有一半人投票后，该曲目就会被跳过。

命令

/play, /pause, /resume, /skip, /stop, /seek, /volume, /join, /leave: 播放控制。
/queue, /playing, /loop, /shuffle, /move, /remove, /clearqueue: 播放队列。 /queue 还会显示最近播放过的曲目。
/lyrics: 当前曲目的歌词，如有可用则同步显示。
/filters, /autoplay, /music settings stay_247: 音效滤镜、队列结束后继续播放相关曲目、全天候留在频道中。
/playlist save | load | list | delete: 你自己的播放列表，保存在你的账号下而非服务器中，因此可在所有 Noxyr 所在的服务器中使用。
/music settings | view: DJ 身份组、点歌频道、自动离开时间、默认音量、自动播放默认值、音效滤镜开关、空频道中继续播放、24/7。

点歌频道与设置

选择一个点歌频道后，在该频道中发布的每条消息都会被视为 /play 并随后自动清理，无需任何命令。你可以在仪表盘的“自动化 → 音乐”中，或使用 /music settings，设置点歌频道、DJ 身份组、24/7、机器人离开前的空闲时间以及默认音量。

仪表盘的“音乐”页面还会显示实时播放器：正在播放的内容、带有删除和下一首播放功能的队列，以及与卡片相同的控制按钮。无论语音频道中的是 Noxyr 还是你的自定义机器人，它都可以正常工作。

注意事项

自定义机器人: 你的自定义机器人同样支持音乐功能，命令和设置也完全相同。
频道中只剩你一人时: 默认情况下，最后一个人离开时机器人会暂停，有人回来时再继续。达到自动离开时间后，机器人会离开，除非开启了 24/7。开启空频道中继续播放（/music settings play_when_empty 或控制面板）后，机器人会留下并继续播放。
赞助片段: YouTube 上的赞助、片头和片尾片段会被自动跳过。
免费: 所有音乐功能均已包含，无需投票，也无需付费套餐。
自动播放: 队列播完后会播放相关歌曲。开启后会关闭循环（循环会让队列永远播不完），队列为空时点跳过会直接进入下一首相关歌曲。