検索とソースの選び方 — 対応リンク
/재생（再生）、/검색（検索）、/다음재생（次に再生）の3つのコマンドは、どれも 검색어（検索ワード）欄1つで曲を受け取ります。 ここに曲名を書くか、アドレスを貼り付けるかで、ボットの動きがまったく変わります。 このページでは、その違いと、入れられるアドレス・ソースの選択肢をまとめます。
検索ワードを入れたときとリンクを入れたとき
ボットは、入力が http:// または https:// ではじまるかどうかだけを見ます。
httpではじまらなければ、すべて検索ワードです。スペース、ハングル、記号もすべてそのまま検索に使われます。httpではじまればリンクとみなし、入れられるサイトかどうかを先に確かめます。通らなければ検索には回さず、そのまま断ります。
❌ 거절: YouTube, Spotify, SoundCloud 공식 링크만 사용할 수 있어요.（「拒否: YouTube、Spotify、SoundCloud の公式リンクのみ使えます」という意味です。）
TIP
曲名にアドレスのような文字が入っていても、http ではじまらなければ検索ワードとして扱われます。 逆に、短縮 URL サービスを通したアドレスは、行き先が YouTube でも断られます。元のアドレスをそのまま貼り付けてください。
貼り付けられるアドレス
次のアドレスだけが通ります。これ以外のサイトはすべて止められます。
| サービス | 入れられるアドレス |
|---|---|
| YouTube | youtube.com, www.youtube.com, m.youtube.com, music.youtube.com, youtu.be |
| Spotify | open.spotify.com, spotify.link |
| SoundCloud | soundcloud.com, www.soundcloud.com, m.soundcloud.com, on.soundcloud.com, snd.sc |
アドレスの後ろに付くものは関係ありません。再生リストのアドレスも、タイムスタンプが付いたアドレスも、そのまま入れてかまいません。
4つのソース
소스（ソース）オプションは空けておけて、選ぶと次の4つのうちの1つです。
| ソース | 実際にすること |
|---|---|
| YouTube | YouTube で探して再生します |
| YouTube Music | YouTube を選んだときと結果が同じです |
| SoundCloud | SoundCloud で探して再生します |
| Spotify | Spotify で曲の情報だけを探し、実際の再生は YouTube で行います |
ソースを空けておくと、リンクでない限り YouTube の検索になります。ほとんどの場合、わざわざ選ばなくても大丈夫です。
YouTube Music を選んでも結果は同じです
選択肢には YouTube と YouTube Music が別々にありますが、2つの選択肢の結果は実際には区別されません。 「YouTube Music 側の音源で出るようにする」オプションではありません。
Spotify は再生ソースではなく検索ソースです
ここがいちばん誤解されやすいところです。
소스: Spotify を選ぶと、ボットは Spotify からタイトル・アーティスト・長さ・アルバムアートだけを取ってきます。 そのあと、その情報をもとに YouTube で同じ曲を探し直して再生します。Spotify の音声が流れるわけではありません。 カードに表示されるソース名だけが spotify として残ります。
WARNING
そのため、自分が入れたものとは別の曲が流れることがあります。 YouTube で同じ曲を探し直すときに、 ライブバージョン、カバー、リミックスが選ばれることがあります。カードに表示されたタイトルが違うときは、このケースです。 正確な音源がほしいときは、/검색 で候補を目で見て選ぶか、YouTube のリンクを直接貼り付けてください。
Spotify のリンクを貼り付けるのと、소스: Spotify を選ぶのとでは、動き方が違います。 どちらの場合も Spotify の音声がそのまま流れるわけではなく、2つの方法で別々の音源を持ってくることがあります。 結果が気に入らないときは、/검색 で候補を自分で見て選ぶほうが確実です。
再生リストのリンク
YouTube のアドレスに再生リストの情報（list=）が付いていると、ボットはリスト全体を取ってきます。
- 一度に取ってくる曲数は最大100曲です。
- リストにある曲でも、長さの制限（初期値10分）を超えると黙って外されます。そのため「100曲のリストを入れたのに87曲しか入らなかった」のが正常な場合もあります。
- 成功すると、
✅ (목록 이름)에서 87곡을 대기열에 추가했어요（（リスト名）から87曲をキューに追加しました）のように、何曲入ったかを知らせます。 - リストのすべての曲が長さの制限にかかると、1曲も入らず
❌ 이 곡은 너무 길어요（この曲は長すぎます）が出ます。
NOTE
非公開の再生リストは取ってこられません。公開または限定公開の状態である必要があります。 もっと大きなリストを扱いたいときや、リストを保存しておきたいときは、ウェブダッシュボードのプレイリスト機能を使ってください — プレイリストと YouTube 再生リストの取り込み。
/검색 で自分で選ぶ
/재생 は検索結果の1件目をそのまま入れます。ほしいものと違うことがあるなら、/검색 を使ってください。
/검색 검색어: (곡 제목)（（曲名））を実行します。必要なら소스も一緒に選べます。- 結果が最大10曲まで選択メニューで表示されます。各行にタイトル、アーティスト、長さが出ます。
- 1つ選ぶとキューに入り、メニューは消えます。
ここでかかる制約がいくつかあります。
| 制約 | 内容 |
|---|---|
| 60秒 | メニューを表示させてから60秒たつと期限切れになります |
| 本人だけ | /검색 を実行した人だけが選べます |
| 10曲 | 結果がどれだけ多くても、先頭の10曲だけを表示します |
| 1回だけ | 1つ選ぶとそのメニューは終わりです。もっと入れたいときはもう一度検索する必要があります |
期限切れのあとに押すと、⚠️ 검색 선택 시간이 만료되었어요. 다시 검색해주세요（検索の選択時間が切れました。もう一度検索してください）が出ます。 ボットが再起動したあと画面に残っていたメニューも同じです。もう一度検索すれば大丈夫です。
NOTE
ほかの人が実行した検索メニューを押すと、🚫 음악 명령어는 검색을 실행한 유저에서만 사용할 수 있어요（音楽コマンドは検索を実行したユーザーだけが使えます）が出ます。 検索を実行した本人だけが選べるという意味です。自分で選びたいときは、/검색 を自分で実行してください。
結果が出ないとき
❌ (검색어)에 맞는 곡을 찾지 못했어요（（検索ワード）に合う曲が見つかりませんでした）が出たら、検索は正常にできたものの結果がなかったということです。
- アーティスト名を付けてもう一度試してください。
밤편지より아이유 밤편지のほうが見つかりやすくなります。 - 記号や絵文字を外して検索してみてください。
- ソースを指定していたなら、空けてもう一度試してください。そのソースにだけない曲かもしれません。
プレミアムのサーバーで2台目のボットが入ったとき
プレミアムのサーバーでは、自分がいるボイスチャンネルに2台目のボット（サブボット）が割り当てられることがあります。
WARNING
サブボットが入ったチャンネルでは、/검색 には現在対応していません 未対応。 ソースを選んでもほしい結果が出ないので、このチャンネルでは /재생 を使うか、YouTube のリンクを直接貼り付けてください。 自分のチャンネルにサブボットが入っているかの見分け方は、複数のチャンネルで同時に聴く（プレミアム） にあります。