ヨンヒ ボットをはじめる
ヨンヒは Discord のボイスチャンネルで音楽を流すボットです。操作はスラッシュコマンドと、チャンネルに表示されるコントローラーカードのボタンで行います。 このページでは、ボットがすでにサーバーに入っている前提で、最初の曲を流すのに必要な最低限のことだけを説明します。
30秒で最初の曲を流す
- 先にボイスチャンネルに入ってください。 これを忘れると、再生・操作のコマンド（
/재생（再生）/검색（検索）/다음재생（次に再生）/들어와（参加）/나가（退出）/일시정지（一時停止）など）は すべて먼저 음성 채널에 들어가주세요（先にボイスチャンネルに入ってください）としか返しません。確認用のコマンド（/현재곡（再生中の曲）/대기열（キュー）/정보（情報）/음악노드_확인（音楽ノードの確認））はボイスチャンネルの外でも使えます。 - どのテキストチャンネルでもよいので
/재생を入力し、검색어（検索ワード）欄に曲名かリンクを入れます。 - ボットがボイスチャンネルに入って再生をはじめ、コマンドを使ったテキストチャンネルにコントローラーカードを1つ表示します。
- それ以降はコマンドを入力し直さなくても、カードのボタンで操作できます。
/재생 검색어: 아이유 밤편지
→ ✅ `밤편지 - IU`을(를) 대기열에 추가했어요（応答は「밤편지 - IU をキューに追加しました」という意味です。）
曲をもっと入れたいときは、続けて /재생 を使えば大丈夫です。すでに再生中ならキューの後ろに積まれます。 いまの曲のすぐ次に割り込ませたいときは /다음재생 を使ってください。
TIP
検索結果から自分で選んで入れたいときは、/재생 の代わりに /검색 を使ってみてください。最大10曲が選択メニューに表示され、 その中から1つ選ぶとキューに入ります。詳しくは 検索とソースの選び方 にあります。
コマンドはスラッシュでのみ使います
!재생 や y!play のようなプレフィックス付きのコマンドはありません。ヨンヒはチャット欄に書いた文字を読まず、 スラッシュコマンドとボタン・選択メニュー・入力欄だけで操作します。
そのため、コマンドを探す方法は1つです。チャット欄に / を入力してヨンヒのアイコンを選ぶと、使えるコマンドがすべて表示されます。
ボットの返事は自分にだけ見えます
コマンドへの応答はほぼすべて自分にだけ表示されるメッセージ（Discord が「これはあなただけに表示されています」と表示するもの）で届きます。 /재생 で曲を入れても、ほかの人の画面には何も表示されません。/현재곡 /대기열 /정보 のような確認用コマンドも同じです。
チャンネルに残ってみんなに見えるのは、次の2つです。
- コントローラーカード — サーバーごとに1つだけ保たれる再生カードです。曲が変わるとカードの内容が更新されます。
- 再生エラーの通知 — 曲の再生に失敗すると、
⚠️ (곡 이름) 재생 중 오류가 발생했어요（（曲名）の再生中にエラーが発生しました）がチャンネルに投稿されます。
NOTE
「曲を入れたのに、チャンネルに何の跡もない」のは正常です。キューにちゃんと入ったか確かめるには、/대기열 を使うか、 コントローラーカードの 📜 ボタンを押してみてください。
はじめて使うときによくつまずくこと
音が小さすぎます
新しく追加されたサーバーの最初の音量は 8% です。 故障ではなく初期値です。 /볼륨 값: 60（/볼륨 は音量、값 は値）のように上げて使ってください。値の範囲は 0 から 100 までで、一度変えた音量はそのサーバーに保存され、次回も保たれます。
音量の調整には、初期設定では DJ ロールが必要です。権限の初期値は スラッシュコマンド一覧 の権限の表にまとめています。
曲が長すぎると断られます
初期設定では、10分を超える曲は再生しません。 次のメッセージが出たら、この制限にかかっています。
❌ 이 곡은 너무 길어요. 최대 `10:00`까지 재생할 수 있어요（「この曲は長すぎます。最大 10:00 まで再生できます」という意味です。）
ただし、ライブ配信のように長さが決まっていないものはこの制限を受けません。
リンクを入れたのに断られます
どんなリンクでも使えるわけではありません。YouTube、Spotify、SoundCloud の公式アドレスだけを受け付けます。 それ以外のアドレスは YouTube, Spotify, SoundCloud 공식 링크만 사용할 수 있어요（YouTube、Spotify、SoundCloud の公式リンクのみ使えます）で止められます。 入れられるアドレスの一覧は 検索とソースの選び方 にあります。