プレイヤーのコントローラーボタンの使い方
最初の曲を流すと、コマンドを使ったテキストチャンネルに再生カードが1つ投稿されます。これをコントローラーと呼びます。 曲が変わっても新しいメッセージは作らず、同じカードの内容だけを入れ替えるので、チャンネルが再生の通知で埋まることはありません。 このページでは、カードに書かれている内容と6つのボタン、そしてボタンが押せないときの理由を説明します。
カードに何が書かれているか
| 位置 | 内容 |
|---|---|
| いちばん上の行 | 지금 재생 중（再生中）または 일시정지（一時停止） |
| タイトル | 現在の曲のタイトル、その下に小さな文字でアーティスト |
| 右側 | アルバムアート（あるときだけ） |
| 次の曲 | キューの1曲目。なければ 대기열에 다음 곡이 없어요（キューに次の曲がありません） |
| 再生時間 | 経過 / 全体 と12マスの進行バー |
| 音量 | 現在の音量（パーセント） |
| リクエストした人 | この曲を入れた人 |
ライブ配信のように長さがわからないものは、全体の時間のところに 라이브（ライブ）が入ります。 このとき進行バーは、位置を示す丸がなく ━━━━━━━━━━━━ の1本線だけで表示されます。バーが最後まで埋まっているように見えても、 曲が終わりかけているという意味ではなく、「表示する位置がない」という意味です。
進行バーは再生中ずっと更新されますが、数秒おきにしか描き直しません。秒単位でぴったり合わないのは正常です。
6つのボタン
上の行に5つ、下の行に1つあり、その横にリンクボタンが付きます。
| ボタン | できること | 必要な権限（初期値） |
|---|---|---|
| ⏮️ | 直前に再生した曲に戻ります | その曲を入れた人または DJ |
| ⏸️ / ▶️ | 一時停止と再生を切り替えます | 誰でも |
| ⏹️ | 再生を止めてキューを空にします | DJ |
| ⏭️ | 次の曲に進みます | その曲を入れた人または DJ |
| 🔊 | 音量の入力画面を表示します | DJ |
| 📜 | キューを自分にだけ見えるように表示します | 制限なし |
- 再生中は2つ目のボタンがグレーの ⏸️、一時停止中は緑色の ▶️ に変わります。いまの状態を色で見分けられます。
- ⏹️ だけが赤色です。押すとキューがまるごと消えるので気をつけてください。
- サーバー管理者の権限があれば、上の権限の表に関係なくすべて押せます。
- 権限のないボタンを押すと、
이 조작을 사용할 권한이 없어요（この操作を使う権限がありません）が自分にだけ見えるように表示されます。カードはそのままです。
いちばん最後のリンクボタンは、ウェブダッシュボードに行くボタンです。
NOTE
このボタンは、ラベルが韓国語ではなく dashboard_button という英字で表示されます。押したときにダッシュボードへ移動する動作は正常なので、 ラベルは気にしなくて大丈夫です。ダッシュボードには、ブラウザにアドレスを直接入力して入っても同じところに行けます — ウェブダッシュボードをはじめる を参照してください。
ボタンがグレー（無効）のとき
押せないボタンには、決まった理由があります。
| 状況 | グレーになるボタン |
|---|---|
| 再生中の曲がない（停止した、キューが終わった、音声の接続が切れた） | ⏮️ ⏸️ ⏹️ ⏭️ 🔊 |
| 前に再生した曲が1つもない | ⏮️ だけ |
| 再生中の曲もなく、キューも空 | 📜 も含めてすべて |
つまり、5つのボタンがまとめてグレーなら、いま何も再生していないということです。 曲を入れるとカードは自動で元に戻ります。リンクボタンだけはいつでも押せます。
一時停止中はボタンはグレーになりません。一時停止も「再生中の曲がある」状態として扱います。
グレーではないのにボタンが効かないとき
カードは残っているのに、ボットが再起動したか、すでにチャンネルから退出している場合があります。 このときボタンを押すと、❌ 지금 재생 중인 곡이 없어요（いま再生中の曲はありません）が出ます。/재생（再生）でまたはじめれば、カードも新しく合わせられます。
⏭️ を押して 대기열에 다음 곡이 없어요 と出たら、本当に次の曲がありません。 ⏮️ で ❌ 이전 곡이 없어요（前の曲はありません）と出るのも同じです。前の曲の履歴は最大25曲までしか残りません。
🔊 音量の入力画面
🔊 を押すと、볼륨 설정（音量設定）という小さな入力画面が表示されます。
- 入力欄の名前は
볼륨 (0-100)（音量 (0-100)）で、開いたときに現在の音量があらかじめ入っています。 - 3桁までしか入力できません。
- 0 から 100 までの整数でなければ、
❌ 0부터 100 사이의 값을 입력해주세요（0 から 100 までの値を入力してください）が出て、音量は変わりません。 - 成功すると、
🔊 볼륨을 60%로 설정했어요（音量を60%に設定しました）のように、自分にだけ見える確認が届きます。
TIP
新しく追加されたサーバーの最初の音量は 8% です。「音が聞こえない」の多くはこれが原因なので、最初に一度上げておいてください。 変えた値はサーバーに保存され、次回も保たれます。
同じことはコマンドでもできます。/볼륨 값:60（/볼륨 は音量、값 は値）は、この入力画面とまったく同じように動作します — /볼륨 · /탐색 を参照してください。
📜 キューのボタン
押すと、キューが自分にだけ表示されるメッセージで表示されます。チャンネルには何も残らないので、いつ押してもかまいません。 内容は /대기열（キュー）コマンドとまったく同じです。先頭の10曲までしか出ないなどの制約は、 キュー・リピート・シャッフル で説明しています。
カードはサーバーに1つだけです
コントローラーはサーバーごとに1つだけ保たれます。複数のチャンネルでコマンドを使っても、カードが複数できることはありません。
- 同じチャンネルに以前のコントローラーが残っていると、ボットが見つけて削除します。 そのため、スクロールを上げても古いカードが積み重なっていません。
- カードを置くべきチャンネルが変わると、新しいチャンネルにカードを作り、元のチャンネルのカードは削除します。カードが「ついてくる」ように見えるのはこのためです。
- 初期設定では、カードが表示されるのは最初にボットを呼んだテキストチャンネルです。サーバー管理者が特定のチャンネルに固定している場合は、いつもそのチャンネルに表示されます （コントローラーメッセージのチャンネル固定・統合）。
NOTE
カードを自分で削除してもかまいません。次の曲がはじまるときに、ボットが新しく作ります。 ただし、削除した直後の少しのあいだは操作するカードがないので、そのあいだはスラッシュコマンドを使ってください。
空のカードに変わるとき
次の状況では、カードは曲の情報が消えた空のカード（❌ 지금 재생 중인 곡이 없어요 + 대기열에 다음 곡이 없어요）に変わります。
- ⏹️ を押したとき、または
/정지（停止）を使ったとき - キューの最後の曲が終わったとき
- ボットがボイスチャンネルから退出したとき
- 音声の接続が切れて再生を続けられないとき
空のカードになったからといって、ボットがすぐに退出するわけではありません。退出する条件は ボットが自動で止まったり退出したりする場合 にまとめています。
複数のボットが入っているサーバーなら
プレミアムのサーバーでは、ボイスチャンネルごとに別のボットが入ることがあります。このとき、カードのボタンは、そのカードを表示したボットの再生を操作します。 自分がいるチャンネルのカードを押さないと思ったとおりに動作せず、ほかのチャンネルのカードを押すとそのチャンネルの再生が変わるので、気をつけてください。 詳しくは 複数のチャンネルで同時に聴く（プレミアム） を見てください。