/재생 · /검색 · /다음재생
ヨンヒでいちばんよく使う3つのコマンド、/재생（再生）/검색（検索）/다음재생（次に再生）です。3つともやることは同じです — 曲を探してキューに入れること。 違いは2つだけです。候補を見せるかどうか、そしてキューのどこに入れるかです。
3つのコマンドとも 검색어（検索ワード）欄は必須で、소스（ソース）欄は空けておけます。
先にボイスチャンネルに入ってください
3つのコマンドとも、自分がボイスチャンネルに入っていないと動作しません。ボットがすでにチャンネルにいるかどうかに関係なく、 コマンドを使う人がボイスチャンネルの外にいると何もせず、この文言だけが返ってきます。
먼저 음성 채널에 들어가주세요（「先にボイスチャンネルに入ってください」という意味です。）
ボットを前もって呼んでおく必要はありません。ボイスチャンネルに入った状態で /재생 を使えば、ボットが自分からついて入ってきます。
3つのうちどれを使うか
| コマンド | 候補を見せるか | どこに入るか | こんなときに |
|---|---|---|---|
/재생 | いいえ | キューのいちばん後ろ | 曲名がはっきりしているときや、リンクがあるとき |
/검색 | はい（最大10曲） | キューのいちばん後ろ | 同じタイトルの曲がいくつもあって、目で見て選びたいとき |
/다음재생 | いいえ | キューのいちばん前 | いまの曲が終わったらすぐにこの曲を流したいとき |
いま何も再生していなければ、3つとも結果は同じです。入れた曲がすぐに再生されます。 違いが出るのは、すでにキューに曲が積まれているときです。
/재생
いちばん基本のコマンドです。候補を見せずに、いちばんよく合う結果をすぐにキューのいちばん後ろに入れます。
/재생 검색어: 아이유 밤편지
→ ✅ `밤편지 - IU`을(를) 대기열에 추가했어요（応答は「밤편지 - IU をキューに追加しました」という意味です。）
- いま再生中の曲がなければ入れた途端に再生がはじまり、コマンドを使ったテキストチャンネルにコントローラーカードが表示されます。
- すでに再生中なら、キューのいちばん後ろに積まれます。現在の曲は途切れません。
검색어欄には、曲名を書いてもアドレスを貼り付けてもかまいません。
再生リストのリンクを入れたとき
再生リストのアドレスを入れると、曲1つではなくリスト全体が入ります。応答の文言も変わります。
✅ `내 플레이리스트`에서 12곡을 대기열에 추가했어요（「내 플레이리스트（私のプレイリスト）から12曲をキューに追加しました」という意味です。）
何曲入ったかが数字で出るので、入れた曲数と違えば途中で抜けた曲があるということです。 抜ける理由と、一度に入る曲数の上限は 検索とソースの選び方 にまとめています。
/다음재생
使い方は /재생 とまったく同じで、入る位置だけが違います。キューのいちばん前に割り込ませます。 いま再生中の曲が終わると、次に流れる曲がこの曲になります。
/다음재생 검색어: 아이유 밤편지
→ ✅ `밤편지 - IU`을(를) 다음 곡으로 추가했어요（応答は「밤편지 - IU を次の曲として追加しました」という意味です。）
応答の文言が 대기열에 추가했어요（キューに追加しました）ではなく 다음 곡으로 추가했어요（次の曲として追加しました）と出れば、正しく入っています。
NOTE
いま再生中の曲には手を触れません。/다음재생 は、現在の曲を止めてすぐに流すコマンドではありません。 いますぐ聴きたいときは、/다음재생 で入れてから /스킵（スキップ）を使ってください。
CAUTION
/다음재생 を続けて何回も使うと、あとから入れた曲が前に行きます。 3曲を順番に入れた場合、 実際の再生順は入れた順の逆になります。複数の曲を好きな順に予約したいときは、最初の曲だけを /다음재생 で入れて、残りは /재생 で後ろにつなげるほうが確実です。
再生リストのアドレスを /다음재생 に入れると、リスト全体がいちばん前に入ります。曲数が多いと、 キューにもともとあった曲がかなり後ろに押し出されるので気をつけてください。
/검색
タイトルだけではどの音源かわかりにくいときに使うコマンドです。候補を一覧で見せ、自分が選んだものだけが入ります。
/검색 검색어: (곡 제목)（（曲名））を実行します。必要なら소스も一緒に選べます。(검색어) 검색 결과예요. 재생할 곡을 선택해주세요（（検索ワード）の検索結果です。再生する曲を選んでください）と一緒に選択メニューが表示されます。- メニューを開くと候補がずらりと並びます。各行にタイトル、その下に小さな文字でアーティストと長さが付きます。
- 1つ選ぶとその曲だけがキューに入り、メニューは消えて
✅ ...을(를) 대기열에 추가했어요（…をキューに追加しました）に変わります。
メニューに表示される案内の文言は 재생할 곡을 선택해요（再生する曲を選びます）です。
選択メニューのルール
| ルール | 内容 |
|---|---|
| 最大10曲 | 検索結果がどれだけ多くても、先頭から10曲までしか表示しません |
| 60秒 | メニューが表示されてから60秒たつと期限切れになります |
| 実行した人だけ | /검색 を使った本人だけが選べます |
| 1回だけ | 1つ選ぶとそのメニューは終わります。2曲入れたいときはもう一度検索してください |
| いちばん後ろへ | 選んだ曲はキューのいちばん後ろに入ります。いちばん前ではありません |
選ばずにそのままにすると
何も選ばずにおくと、60秒後にそのまま期限切れになります。わざわざ取り消す必要はありません。 メニューは画面に残りますが、期限切れのあとに押すと次の文言が出て、何も起こりません。
⚠️ 검색 선택 시간이 만료되었어요. 다시 검색해주세요（「検索の選択時間が切れました。もう一度検索してください」という意味です。）
ずっと前に表示させたメニューや、ボットが再起動する前に表示させたメニューも同じです。もう一度 /검색 を使えば大丈夫です。
NOTE
ほかの人が表示させた検索メニューは、押しても選べません。検索を実行した本人だけが使えるという案内が出ます。 自分で選びたいときは、/검색 を自分で実行してください。
WARNING
プレミアムのサーバーで、自分がいるボイスチャンネルに2台目のボットが入っていると、/검색 が 正しく動作しません 未対応。 そのチャンネルでは /재생 を使うか、アドレスを直接貼り付けてください。 どういう状況かは 複数のチャンネルで同時に聴く（プレミアム） にあります。
소스 オプション
3つのコマンドとも 소스 欄を1つずつ持っています。直接入力する欄ではなく、次の4つから選ぶ選択肢です。
YouTubeYouTube MusicSoundCloudSpotify
空けておくのが基本で、たいていは空けておくほうがよいです。 空けておくと自動で探してくれますし、 アドレスを貼り付けた場合は 소스 を選んでもアドレスが優先されるので、実際には意味がありません。
それぞれの選択肢が実際に何をするのか、なぜ Spotify を選ぶと別の曲が出ることがあるのかは、 検索とソースの選び方 — 対応リンク で詳しく説明しています。 貼り付けられるアドレスの一覧も同じページにあります。
入力の途中では候補が出ません
검색어 欄にはオートコンプリートがありません。 文字を入力している途中で曲の候補が出てくることはありません。 すべて入力して Enter を押すと、そこから曲を探しはじめます。候補を見たいときは /검색 を使ってください。
返事は自分にだけ見えます
3つのコマンドの応答は、すべて自分にだけ表示されるメッセージで届きます。曲を入れても、チャンネルには跡が残りません。 ほかの人に見えるのは、再生がはじまるときに表示されるコントローラーカードだけです。
何が入ったかを確かめるには、/대기열（キュー）を使うか、コントローラーカードの 📜 ボタンを押してください — キュー・リピート・シャッフル で説明しています。
うまくいかないとき
| 出る文言 | 意味と対処 |
|---|---|
먼저 음성 채널에 들어가주세요（先にボイスチャンネルに入ってください） | ボイスチャンネルに入ってから、もう一度実行してください |
❌ (검색어)에 맞는 곡을 찾지 못했어요（（検索ワード）に合う曲が見つかりませんでした） | 検索はできましたが、結果がありませんでした。アーティスト名を付けてもう一度試してください |
❌ 이 곡은 너무 길어요（この曲は長すぎます） | 初期設定では、10分を超える曲は再生しません |
YouTube, Spotify, SoundCloud 공식 링크만 사용할 수 있어요（YouTube、Spotify、SoundCloud の公式リンクのみ使えます） | 受け付けないアドレスです。入れられるアドレスはソースのページにあります |
結果が出ないときは、まず 소스 を選んでいないか確かめてください。特定のソースを指定すると、そのソースにない曲は まったく見つけられません。空けてもう一度実行すると見つかることが多いです。
誰が使えるか
/재생 /검색 /다음재생 は、ボイスチャンネルに入っている人なら誰でも使えます。 DJ ロールや管理者の権限は必要ありません。
曲を入れるのとは違い、停止・スキップ・音量のような操作は権限が分かれています。初期値は スラッシュコマンド一覧 の権限の表にまとめています。