YouTube上の動画音声をボイスチャンネルで再生するコマンドです。曲名検索またはURL指定に対応し、再生中の場合はキューに追加します。
使い方
| 項目 |
内容 |
| 形式 |
/play song_query:<検索語またはURL> pitch:<倍率> speed:<倍率> |
| 必須引数 |
song_query |
| 任意引数 |
pitch, speed |
| カテゴリー |
音楽・音声 |
引数
| 引数 |
説明 |
song_query |
必須。曲名、検索語、YouTube URLを指定します。検索語の場合はYouTube検索の先頭結果を使用します。 |
pitch |
任意。音の高さです。0.5から2.0の範囲で指定します。既定値は1.0です。 |
speed |
任意。再生速度です。0.5から2.0の範囲で指定します。既定値は1.0です。 |
応答・返り値
- すぐ再生する場合は
再生中: 曲名 (Pitch=..., Speed=...) を返します。
- 再生中または一時停止中の場合は
キューに追加: 曲名 ... を返します。
- 検索失敗、音声URL取得失敗、キュー上限などの場合はエラーメッセージを返します。
必要条件・権限
- サーバー内でのみ実行できます。
- 実行者が先にボイスチャンネルへ参加している必要があります。
- bot にはメッセージ送信、ボイス接続、ボイス発言の権限が必要です。
- 1ユーザーあたり10秒に1回のクールダウンがあります。
- キュー上限は20件です。
使用例
/play song_query:Never Gonna Give You Up
/play song_query:https://www.youtube.com/watch?v=... pitch:1.0 speed:1.25
/play song_query:作業用BGM pitch:0.9 speed:1.0
エラー・注意点
- botが未接続なら実行者のボイスチャンネルへ接続します。別チャンネルにいる場合は実行者のチャンネルへ移動します。
コメント