ダッシュボードを使える人
ヨンヒのダッシュボードには、招待コードも別のアカウントもありません。Discord アカウントでログインすると、ボットが入っていて自分も入っているサーバーが自動で一覧に表示されます。そこから先は、何をしたいかによって条件が1つずつ増えていきます。
このドキュメントでは、その条件を順番に説明します。DJ ロールと操作の権限を決める方法そのものは、DJ ロールと操作ごとの権限 にあります。
4つの関門
| 段階 | 何を確かめるか | 通らないと |
|---|---|---|
| 1. ログイン | Discord アカウントでログインしたか | ログイン画面に戻ります |
| 2. サーバーへのアクセス | そのサーバーにボットと自分の両方がいるか | 一覧に表示されません |
| 3. 設定画面 | そのサーバーで管理者の権限があるか | 設定メニューが表示されません |
| 4. 再生の操作 | 権限レベル + ボイスチャンネルへの接続 + ボットと同じチャンネル | 操作が断られます |
画面でボタンが見えないのは便宜上のことにすぎず、実際の制限はサーバー側でもう一度かかります。
1段階目 — Discord のログイン
ログインボタンを押すと、Discord の認可画面に移ります。ここでヨンヒが求めるのは、プロフィールと自分が参加しているサーバーの一覧の2つだけです。メッセージの読み取り、メールアドレス、サーバーへの参加のような権限は求めません。
ログインは 7日間保たれます。7日たつとログインし直す必要があり、毎日アクセスしていても同じです。
ログアウトは、アバターを押すと出るユーザーメニューの下にある 로그아웃（ログアウト）ボタンです。
TIP
共用の PC で使った場合、ウィンドウを閉じるだけでは足りません。ブラウザを閉じて開き直しても、ログインはそのまま残っています。必ず 로그아웃 ボタンを押してください。ダッシュボードを開いているほかのタブがあれば、ログアウトする前に一緒に閉じてください。
NOTE
ログインボタンが 「OAuth 설정 필요」（OAuth の設定が必要）に変わって押せないときは、ボットの配備側の設定の問題です。サーバー管理者が直せる部分ではないので、ボットの運営チームにお問い合わせください。
2段階目 — 一覧に表示されるサーバー
サーバー一覧には、ボットが入っているサーバーのうち、自分がメンバーのサーバーだけが表示されます。基本的に、そのサーバーのメンバーでありさえすればダッシュボードを開けて、設定を変えることだけに管理者の権限が必要です。
NOTE
ボットをとても多くのサーバーに招待している場合、新しく招待したサーバーが最初の画面には見えず、何度か再読み込みすると表示されることがあります。正常な動作なので、少ししてからもう一度再読み込みしてください。
一覧が1つもないときは、「사용 가능한 서버가 없어요」（使えるサーバーがありません）の画面が表示されます。ボットを招待したばかりなら、ボットがまだサーバーにつながっていないのかもしれないので、少ししてから再読み込みしてみてください。
3段階目 — 設定画面は管理者だけ
設定画面は、そのサーバーで管理者（Administrator） の権限がないと開けません。サーバー管理（ManageGuild） の権限だけでは開けません。サーバーのオーナーは、権限の設定に関係なくいつでも開けます。
設定画面を開いたまま管理者ではないサーバーに切り替えると、画面は自動で「지금 재생」（再生中）に戻ります。
WARNING
サーバーで権限が変わっても、ダッシュボードに反映されるまで時間がかかります。 管理者の権限を付けたばかりの人にはまだ設定メニューが見えず、権限を外した人はしばらく設定画面を開き続けられます。すぐに反映させたいときは、その人にログアウトしてからログインし直すよう頼んでください。
NOTE
DJ ロールは例外です。DJ ロールを付けたり外したりしたことは、ログインし直さなくてもすぐに反映されます。ログインし直す必要があるのは、管理者の権限の変更だけです。
4段階目 — 再生の操作に付く条件
権限レベルを通っても、ダッシュボードで操作するにはさらに2つが必要です。
- そのサーバーのボイスチャンネルに入っている必要があります。 そうでなければ
이 서버의 음성 채널에 들어가 있어야 조작할 수 있어요.（このサーバーのボイスチャンネルに入っていないと操作できません） - ボットと同じボイスチャンネルにいる必要があります。 そうでなければ
봇과 같은 음성 채널에 있어야 조작할 수 있어요.（ボットと同じボイスチャンネルにいないと操作できません）
状態を見るだけなら、この2つの条件はかかりません。その代わり、ボットと別のチャンネルにいるとプレイヤーが空に見えるので、再生中なのに「대기 중」（待機中）と表示されます。
TIP
ユーザーメニューに表示される DJ 권한（DJ 権限）の表示は案内にすぎません。管理者にもオンで表示されます。実際にボタンを止めたり開いたりするのは、DJ ロールと操作ごとの権限 で決めた値です。接続が一時的に切れるとこの表示が消えることがありますが、権限がなくなったわけではありません。
症状ごとの対照表
| 症状 | 原因 | 対処 |
|---|---|---|
| ログインボタンが押せない | ボットの配備側の設定の問題 | ボットの運営チームに問い合わせる |
| 「사용 가능한 서버가 없어요」 | ボットがそのサーバーにいない | ボットの招待を確かめて再読み込みする |
| 招待したのに一覧に表示されない | 一覧の確認がまだ終わっていない | 数秒後にもう一度再読み込みする |
| 設定メニューがない | 管理者の権限がない | ロールを確かめてからログインし直す |
| 権限を付けたのに設定が見えない | 権限の変更がまだ反映されていない | ログアウトしてからログインし直す |
administrator permission is required | 管理者の権限なしで設定を保存しようとした | ログアウトしてからログインし直す |
permission is required | 操作の権限レベルに届いていない | DJ ロールを付けるか、レベルを調整する |
| ボタンは押せるのに何も起こらない | ボイスチャンネルの外にいるか、ボットと別のチャンネルにいる | ボットがいるチャンネルに移る |
| 急にログイン画面に戻る | ログインの7日間の期限切れ | もう一度ログインする |
NOTE
上の表の英語の文言は、画面にそのまま表示されるエラーメッセージです。問い合わせを受けたら、文言をそのまま尋ねて表で探すと、原因がすぐにわかります。