音樂播放器
Mochi 使用伺服器共用播放器。跳歌、清空佇列與離開會影響同一伺服器的其他收聽者。
使用前確認
「使用前確認」章節Mochi 需要在語音頻道連線與播放音訊的權限。只有 /music queue 查看佇列不要求加入語音;其餘播放控制需與已連線的 Mochi 在同一頻道。
播放第一首歌
「播放第一首歌」章節- 加入語音:加入要一起收聽的語音頻道。Mochi 若已連線,請加入它所在的同一頻道。
- 搜尋歌曲:在伺服器選擇
/music play,在query輸入「鋼琴音樂」或想搜尋的歌名。 - 選擇歌曲:從僅自己可見的搜尋結果選一首歌;選單由發起搜尋的人操作。
播放結果:等待播放。已有歌曲時,新歌曲會加入待播佇列。
使用網址播放
「使用網址播放」章節query 也接受實際的 YouTube 歌曲或播放清單網址,網址會直接進入加入流程,不經關鍵字搜尋選單。其他網站的網址不受支援。
查看與安排佇列
「查看與安排佇列」章節- 查看序號:用
/music queue查看目前待播歌曲及序號。 - 移除待播歌曲:要移除待播歌曲,選擇
/music remove,將index填成畫面上該歌曲的序號。 - 跳過目前歌曲:要跳過正在播放的歌曲,使用
/music skip,而非 remove。
播放清單與數量限制
「播放清單與數量限制」章節待播佇列最多 100 首,單次播放清單最多解析前 100 個項目。無法使用的項目可能略過,剩餘空間不足時只加入可容納的部分。請閱讀加入結果,不要假定整份播放清單都已加入。
選擇播放模式
「選擇播放模式」章節洗牌一次
「洗牌一次」章節執行 /music shuffle,重新排列目前待播佇列。
持續隨機
「持續隨機」章節執行 /music shuffle-mode,在開啟與關閉之間切換,回覆會顯示新狀態。
循環播放
「循環播放」章節選擇 /music loop,在 mode 選「不循環」、「單曲循環」或「全部循環」。
隨機與循環是不同設定;一次洗牌不會開啟持續隨機。需要重複目前歌曲時,選單曲循環即可。
使用固定面板
「使用固定面板」章節管理者建立面板
「管理者建立面板」章節設定者需具備 Discord Administrator 或 Mochi 已授權管理角色,Mochi 需能在該頻道傳送面板。
- 到目標文字頻道執行
/music panel。 - 建立面板後,依「播放第一首歌」的步驟開始播放;建立面板不會自動加入語音或播放歌曲。
成員使用面板
「成員使用面板」章節面板提供上一首、暫停/恢復、下一首、佇列、播放模式、循環、倍速、停止與離開。成員使用面板控制仍需符合語音頻道條件。
倍速提供 0.25×、0.5×、0.75×、1×、1.25×、1.5×、1.75×、2×;切換有冷卻及音源限制。上一首與倍速是面板操作,請直接使用按鈕。
暫停、停止與離開有何不同?
「暫停、停止與離開有何不同?」章節/music pause暫停目前歌曲;用/music resume繼續。/music stop停止播放並清空待播佇列,不會立即斷開語音,resume 也不會恢復已清空的佇列。/music leave開啟確認介面,確認後停止、清除佇列與播放歷史,並離開語音頻道。
無歌可播而進入閒置時,播放器會安排約三分鐘後離開;要立即離開請用 leave。
常見問題
「常見問題」章節要求加入同一語音頻道
「要求加入同一語音頻道」章節移到 Mochi 所在頻道再操作。
搜尋無結果、無法解析或逾時
「搜尋無結果、無法解析或逾時」章節檢查 YouTube 網址是否可用,或改用另一個關鍵字;來源暫時失敗時稍後重試。
看得到舊面板卻無法操作
「看得到舊面板卻無法操作」章節使用目前有效的固定面板。管理者重新執行 panel 時,若無法確認既有面板,應先檢查原頻道的訊息存取權限。
暫停/恢復沒有改變
「暫停/恢復沒有改變」章節只有正在播放的音源可暫停、已暫停的音源可恢復;這兩個操作不會新增歌曲。
倍速切換失敗
「倍速切換失敗」章節等待冷卻結束;音源沒有可用時長或播放狀態已改變時,也可能無法切換。
音樂指令參考提供各指令參數與固定選項。