테마
검색과 소스 고르기 — 지원 링크
/재생, /검색, /다음재생 세 명령은 모두 검색어 칸 하나로 곡을 받아요. 여기에 곡 제목을 쓰느냐 주소를 붙여 넣느냐에 따라 봇이 완전히 다르게 움직입니다. 이 페이지는 그 차이와, 넣을 수 있는 주소·소스 선택지를 정리해요.
검색어를 넣었을 때와 링크를 넣었을 때
봇은 입력이 http:// 또는 https:// 로 시작하는지만 봅니다.
http로 시작하지 않으면 전부 검색어예요. 띄어쓰기, 한글, 특수문자 전부 그대로 검색에 쓰입니다.http로 시작하면 링크로 보고, 넣을 수 있는 사이트인지 먼저 확인해요. 통과하지 못하면 검색으로 넘어가지 않고 그냥 거절합니다.
text
❌ 거절: YouTube, Spotify, SoundCloud 공식 링크만 사용할 수 있어요.TIP
곡 제목에 주소처럼 생긴 글자가 들어 있어도 http 로 시작하지만 않으면 검색어로 처리돼요. 반대로 단축 URL 서비스를 거친 주소는 목적지가 유튜브여도 거절됩니다. 원본 주소를 그대로 붙여 넣으세요.
붙여 넣을 수 있는 주소
아래 주소만 통과해요. 이 밖의 사이트는 전부 막힙니다.
| 서비스 | 넣을 수 있는 주소 |
|---|---|
| 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 |
주소 뒤에 붙는 것들은 상관없어요. 재생목록 주소, 타임스탬프가 붙은 주소 모두 그대로 넣어도 됩니다.
소스 네 가지
소스 옵션은 비워 둘 수 있고, 고르면 아래 넷 중 하나예요.
| 소스 | 실제로 하는 일 |
|---|---|
| YouTube | 유튜브에서 찾아 재생합니다 |
| YouTube Music | 유튜브를 골랐을 때와 결과가 같습니다 |
| SoundCloud | 사운드클라우드에서 찾아 재생합니다 |
| Spotify | 스포티파이에서 곡 정보만 찾고, 실제 재생은 유튜브에서 합니다 |
소스를 비워 두면 링크가 아닌 이상 유튜브 검색으로 갑니다. 대부분의 경우 굳이 고르지 않아도 돼요.
YouTube Music 을 골라도 결과가 같아요
선택지에는 YouTube 와 YouTube Music 이 따로 있지만, 두 선택지의 결과는 사실상 구분되지 않습니다. "유튜브 뮤직 쪽 음원으로 나오게 하는" 옵션이 아니에요.
Spotify 는 재생 소스가 아니라 검색 소스예요
이게 가장 오해가 잦은 부분입니다.
소스: Spotify 를 고르면 봇은 스포티파이에서 제목·아티스트·길이·앨범 아트만 가져와요. 그다음 그 정보를 가지고 유튜브에서 같은 곡을 다시 찾아 재생합니다. 스포티파이 오디오가 흘러나오는 게 아니에요. 카드에 표시되는 소스 이름만 spotify 로 남습니다.
WARNING
그래서 내가 넣은 것과 다른 곡이 나올 수 있어요. 유튜브에서 같은 곡을 다시 찾는 과정에서 라이브 버전, 커버, 리믹스가 걸릴 수 있습니다. 카드에 뜬 제목이 다르면 이 경우예요. 정확한 음원을 원하면 /검색 으로 후보를 눈으로 보고 고르거나, 유튜브 링크를 직접 붙여 넣으세요.
스포티파이 링크를 붙여 넣는 것과 소스: Spotify 를 고르는 것은 서로 다르게 동작해요. 어느 쪽이든 스포티파이 오디오가 그대로 나오는 건 아니고, 두 방법이 서로 다른 음원을 물어 올 수 있습니다. 결과가 마음에 들지 않으면 /검색 으로 후보를 직접 보고 고르는 편이 확실해요.
재생목록 링크
유튜브 주소에 재생목록 정보(list=)가 붙어 있으면 봇은 목록 전체를 가져옵니다.
- 한 번에 가져오는 곡 수는 최대 100곡이에요.
- 목록에 있는 곡이라도 길이 제한(기본 10분)을 넘으면 조용히 빠집니다. 그래서 "100곡짜리 목록을 넣었는데 87곡만 들어왔다" 가 정상일 수 있어요.
- 성공하면
✅ (목록 이름)에서 87곡을 대기열에 추가했어요처럼 몇 곡이 들어갔는지 알려줍니다. - 목록의 모든 곡이 길이 제한에 걸리면 곡이 하나도 안 들어가고
❌ 이 곡은 너무 길어요가 나와요.
NOTE
비공개 재생목록은 가져올 수 없어요. 공개 또는 일부 공개 상태여야 합니다. 훨씬 큰 목록을 다루거나 목록을 저장해 두고 싶다면 웹 대시보드의 플레이리스트 기능을 쓰세요 — 플레이리스트와 유튜브 재생목록 가져오기.
/검색 으로 직접 고르기
/재생 은 검색 결과 중 첫 번째를 그냥 넣어요. 원하는 게 아닐 때가 있으면 /검색 을 쓰세요.
/검색 검색어: (곡 제목)을 실행합니다. 원하면소스도 같이 고를 수 있어요.- 결과가 최대 10곡까지 선택 메뉴로 뜹니다. 각 줄에 제목, 아티스트, 길이가 나와요.
- 하나를 고르면 대기열에 들어가고 메뉴는 사라집니다.
여기서 걸리는 제약이 몇 가지 있어요.
| 제약 | 내용 |
|---|---|
| 60초 | 메뉴를 띄운 지 60초가 지나면 만료됩니다 |
| 본인만 | /검색 을 실행한 사람만 고를 수 있습니다 |
| 10곡 | 결과가 아무리 많아도 앞 10곡만 보여줍니다 |
| 한 번만 | 하나를 고르면 그 메뉴는 끝입니다. 더 넣으려면 다시 검색해야 합니다 |
만료된 뒤에 누르면 ⚠️ 검색 선택 시간이 만료되었어요. 다시 검색해주세요 가 나옵니다. 봇이 재시작된 뒤에 화면에 남아 있던 메뉴도 마찬가지예요. 그냥 다시 검색하면 됩니다.
NOTE
다른 사람이 실행한 검색 메뉴를 누르면 🚫 음악 명령어는 검색을 실행한 유저에서만 사용할 수 있어요 가 나와요. 검색을 실행한 본인만 고를 수 있다는 뜻입니다. 내가 고르고 싶으면 /검색 을 직접 실행하세요.
결과가 안 나올 때
❌ (검색어)에 맞는 곡을 찾지 못했어요 가 나오면 검색은 정상적으로 됐는데 결과가 없었던 거예요.
- 아티스트 이름을 붙여서 다시 시도해 보세요.
밤편지보다아이유 밤편지가 잘 걸립니다. - 특수문자나 이모지를 빼고 검색해 보세요.
- 소스를 지정했다면 비우고 다시 해 보세요. 그 소스에만 없는 곡일 수 있어요.
프리미엄 서버에서 두 번째 봇이 붙었을 때
프리미엄 서버에서는 내가 있는 음성 채널에 두 번째 봇(서브 봇)이 배정될 수 있어요.
WARNING
서브 봇이 붙은 채널에서는 /검색 을 현재 지원하지 않습니다 지원 안 함. 소스를 골라도 원하는 결과가 나오지 않으니, 이 채널에서는 /재생 을 쓰거나 유튜브 링크를 직접 붙여 넣어 주세요. 내 채널에 서브 봇이 붙었는지 구분하는 방법은 여러 채널에서 동시에 듣기(프리미엄)에 있어요.