ウェブダッシュボードをはじめる

ヨンヒには、Discord のコマンドのほかに、ブラウザで使うウェブダッシュボードがあります。検索、キューの並べ替え、プレイリスト、歌詞のように、 Discord のチャット欄では扱いにくいことを画面で操作できるように作ったものです。 このページでは、ダッシュボードに入って最初の曲を入れるまでの最短の道筋だけを説明します。

ダッシュボードのドキュメントは4つです

ドキュメント	何があるか
ダッシュボード画面の見方	サイドバー・ヘッダー・本文・下部プレイヤーに何があり、どのボタンが実際に動作するか
ダッシュボードでキューを操作する	順番の入れ替え、曲の削除、元に戻せない操作
プレイリストと YouTube 再生リストの取り込み	自分のプレイリストを作る、YouTube の再生リストを取り込む
歌詞パネルと履歴画面	歌詞の表示と同期のずれの補正、最近聴いた曲

ログインはできるのにサーバーが一覧に表示されないときや、設定メニューが見えないときは、画面ではなく権限の問題です。 ダッシュボードを使える人 を見てください。

ダッシュボードに入る方法

アドレスは、サーバー管理者が教えてくれるダッシュボードのアドレス1つだけです。そのアドレスをブラウザに直接入力しても、 Discord の中でリンクを受け取ってもかまいません。

方法	どこで
アドレスを直接入力	ブラウザ（いちばん確実です）
コントローラーカードのリンクボタン	再生中のチャンネルにあるコントローラーカードの2行目
ダッシュボードのリンクのコマンド	Discord のコマンド入力欄

NOTE

ダッシュボードのリンクを表示するスラッシュコマンドは、/대시보드（ダッシュボード）では見つかりません。コマンド入力欄に /cmd_dashboard_name と 入力すると出てきます。応答の文言とボタンのラベルは英字で表示されますが、リンクは正常に動作するので押してかまいません。 コントローラーカードのリンクボタンも、同じところに行きます。

Discord アカウントでログインする

はじめて入ると、「음악봇을 웹에서 제어해요」（音楽ボットをウェブで操作します）と書かれたログイン画面が表示されます。ボタンは Discord로 로그인（Discord でログイン）の1つだけです。

1. Discord로 로그인 を押します。
2. Discord の認証画面に移ります。ヨンヒが求める権限は2つです。
   • アカウントの基本情報（名前・アバター）
   • 自分が参加しているサーバーの一覧
3. 同意するとダッシュボードに戻り、サーバーが1つ自動で選ばれた状態で画面が表示されます。

求める権限はこの2つだけです。ダッシュボードは Discord のメッセージを読むことも、代わりに投稿することもしません。 一度ログインすると 7日間保たれ、そのあとはもう一度ログインするよう求められます。

NOTE

ログインボタンが OAuth 설정 필요（OAuth の設定が必要）とグレーで表示されるときは、まだログインを使えない状態です。 自分のアカウントの問題ではないので、サーバー管理者に知らせてください。

「사용 가능한 서버가 없어요」と出るとき

ログインはできたのにこの画面（使えるサーバーがありません）が出るときは、ヨンヒが入っていて自分のアカウントも一緒にいるサーバーが1つもないということです。 ダッシュボードは、その条件を満たすサーバーだけを一覧に載せます。

• ボットをまだ招待していないなら、先にサーバーに招待する必要があります。
• 招待したばかりなら、다시 확인（もう一度確認）ボタンを押して一覧を取り直してください。
• 別のアカウントでログインしているのかもしれません。画面の下にいまログインしているアカウント名が表示されるので、確かめてみてください。

サーバーによっては、サーバー管理の権限がある人にだけ一覧に表示されるようにしている場合もあります。 ボットは確かにいるのにサーバーが見えないときは、サーバー管理者に尋ねてください。

いちばん大切なルール — 先にボイスチャンネルに入ってください

ダッシュボードで再生を操作するには、そのサーバーのボイスチャンネルに実際に入っている必要があります。 そして、ボットがすでにどこかのチャンネルで再生中なら、ボットと同じチャンネルにいる必要があります。

WARNING

ボットと別のボイスチャンネルに入っていると、再生中なのに「대기 중」（待機中）と表示されます。 曲のタイトルもキューも空で表示されます。 故障ではなく、自分のチャンネルの再生情報ではないので隠しているだけです。ボットがいるチャンネルに移れば、数秒で画面が埋まります。

逆に、どのボイスチャンネルにも入っていないときは、画面はそのまま見えます。 見えることと操作できることは別なので、 画面は問題ないのにボタンだけが断られるときは、ボイスチャンネルに入っていない場合です。先にボイスチャンネルに入ってください。

ボタンを押したときに出る案内の文言でも見分けられます。

画面に出る文言	意味
이 서버의 음성 채널에 들어가 있어야 조작할 수 있어요（このサーバーのボイスチャンネルに入っていないと操作できません）	ボイスチャンネルの外にいます
봇과 같은 음성 채널에 있어야 조작할 수 있어요（ボットと同じボイスチャンネルにいないと操作できません）	ボットと別のチャンネルにいます
먼저 Discord에서 음성 채널에 들어와 주세요（先に Discord でボイスチャンネルに入ってください）	曲を入れようとしたのに、入っているチャンネルがありません
봇이 다른 채널에서 이미 재생 중이에요（ボットはほかのチャンネルですでに再生中です）	ボットを連れてくるには、Discord で操作する必要があります

サーバーはどう選ばれるか

サイドバーの上のほうにある 연결된 음성 채널（接続中のボイスチャンネル）カードが、いま見ているサーバーです。カードを押すと、サーバーの一覧が開きます。

• はじめて入ると、自分がボイスチャンネルに入っているサーバーが優先して選ばれます。そういうサーバーがなければ、一覧の1つ目が選ばれます。
• 一覧から自分で選んだサーバーは、そのまま保たれます。再読み込みしても元に戻りません。
• 自分がほかのサーバーのボイスチャンネルに移ったときだけ、画面もそのサーバーについていきます。
• サーバーを切り替えると2〜3秒ほどかかり、そのあいだその行に「전환 중…」（切り替え中…）と表示されます。

サーバー一覧の各行には、そのサーバーで自分が入っているチャンネルと、そのサーバーでボイスチャンネルに入っているヨンヒのボットが一緒に表示されます。 プレミアムのサーバーなら、サブボットがどのチャンネルにいるかもここで見られます。

最初の曲を入れる

1. Discord で先にボイスチャンネルに入ります。
2. ダッシュボード上部の検索欄に曲名かリンクを入れて Enter を押します。（虫めがねを押しても同じです。）
3. 검색（検索）画面に移り、YouTube · Spotify · SoundCloud の3つのタブに結果が表示されます。
4. ほしい曲の行をクリックすると、キューに入ります。「대기열에 추가했어요」（キューに追加しました）という通知が少しのあいだ表示されます。
5. ボットがボイスチャンネルにいなかった場合は、このとき入ってきて再生をはじめます。

検索欄は曲をすぐに流す場所ではなく、検索画面に移るための入口です。Enter を押しても音は出ません。 結果の一覧から曲を選ぶと、キューに入ります。

TIP

何を検索すればよいかわからないときは、サイドバーの 탐색（探索）を押してみてください。タグ別のプレイリスト6つと地域別の人気リスト4つが カードで用意されていて、カードを開いて 전체 재생（すべて再生）を押すと、まるごとキューに入ります。

知っておくと便利なこと

• ダッシュボードと Discord は同じ再生を見ています。 ダッシュボードでスキップすると、チャンネルのコントローラーカードも一緒に変わり、 逆に Discord で /스킵（スキップ）を使っても、ダッシュボードの画面がすぐに更新されます。再読み込みする必要はありません。
• 新しいサーバーの最初の音量は 8% です。 ダッシュボードの音量スライダーがほとんど左端に寄っているのは正常です。 聞こえないときはスライダーを上げてください。最大は 100 です。
• 画面の状態はアドレスに残ります。 どの画面を見ていたか、どの検索ワードだったかがアドレスに記録されるので、 再読み込みしてもその場所に戻り、ブラウザの「戻る」も画面単位で動作します。
• 로그아웃（ログアウト）は、右上のアバターを押すと出るメニューのいちばん下にあります。

画面がおかしいときに最初に見ること

症状	確かめること
再生中なのに「대기 중」と表示される	ボットと別のボイスチャンネルに入っていないか
ボタンを押しても何も反応しない	ヘッダーにオレンジ色の警告バッジが出ていないか
ボタンのアイコンがすべて消えて四角だけが見える	会社・学校のネットワークでブロックされているのかもしれません。別のネットワークで開いてみてください
「요청이 너무 많아요」（リクエストが多すぎます）と出る	短い時間に押しすぎました。少し待ってからもう一度試してください
サーバーが一覧にない	ボットを招待したか、ログインしたアカウント、管理の権限が必要かどうか

ヘッダーのオレンジ色の警告バッジは、マウスを乗せると内容が開きます。何を意味するかは ダッシュボード画面の見方 にまとめています。

関連ドキュメント

• ダッシュボード画面の見方
• ダッシュボードでキューを操作する
• 歌詞パネルと履歴画面
• ダッシュボードを使える人
• ヨンヒ ボットをはじめる