테마
플레이어 컨트롤러 버튼 사용법
첫 곡을 틀면 명령을 쓴 텍스트 채널에 재생 카드가 하나 올라와요. 이걸 컨트롤러라고 부릅니다. 곡이 바뀌어도 새 메시지를 만들지 않고 같은 카드의 내용만 갈아 끼우기 때문에, 채널이 재생 알림으로 도배되지 않아요. 이 페이지는 카드에 적힌 내용과 버튼 여섯 개, 그리고 버튼이 눌리지 않을 때의 이유를 설명합니다.
카드에 무엇이 적혀 있나
| 자리 | 내용 |
|---|---|
| 맨 윗줄 | 지금 재생 중 또는 일시정지 |
| 제목 | 현재 곡 제목, 그 아래 작은 글씨로 아티스트 |
| 오른쪽 | 앨범 아트(있을 때만) |
| 다음 곡 | 대기열 첫 번째 곡. 없으면 대기열에 다음 곡이 없어요 |
| 재생 시간 | 경과 / 전체 와 12칸짜리 진행 막대 |
| 볼륨 | 현재 볼륨 퍼센트 |
| 요청자 | 이 곡을 넣은 사람 |
라이브 방송처럼 길이를 알 수 없는 항목은 전체 시간 자리에 라이브 가 들어가요. 이때 진행 막대는 위치를 표시하는 동그라미 없이 ━━━━━━━━━━━━ 한 줄로만 나옵니다. 막대가 끝까지 차 있는 것처럼 보여도 곡이 끝나간다는 뜻이 아니라 "표시할 위치가 없다"는 뜻이에요.
진행 막대는 재생 중에 계속 갱신되지만 몇 초 간격으로만 다시 그립니다. 초 단위로 딱딱 맞아떨어지지 않는 건 정상이에요.
버튼 여섯 개
윗줄에 다섯 개, 아랫줄에 하나가 있고 그 옆에 링크 버튼이 붙어요.
| 버튼 | 하는 일 | 필요한 권한(기본값) |
|---|---|---|
| ⏮️ | 직전에 재생했던 곡으로 되돌아갑니다 | 그 곡을 넣은 사람 또는 DJ |
| ⏸️ / ▶️ | 일시정지와 재생을 번갈아 합니다 | 누구나 |
| ⏹️ | 재생을 멈추고 대기열을 비웁니다 | DJ |
| ⏭️ | 다음 곡으로 넘어갑니다 | 그 곡을 넣은 사람 또는 DJ |
| 🔊 | 볼륨 입력창을 띄웁니다 | DJ |
| 📜 | 대기열을 나에게만 보이게 띄웁니다 | 제한 없음 |
- 재생 중일 때 두 번째 버튼은 회색 ⏸️, 일시정지 상태일 때는 초록색 ▶️ 로 바뀌어요. 지금 상태를 색으로 구분할 수 있습니다.
- ⏹️ 만 빨간색이에요. 누르면 대기열이 통째로 사라지니 주의하세요.
- 서버 관리자 권한이 있으면 위 권한 표와 관계없이 전부 누를 수 있어요.
- 권한이 없는 버튼을 누르면
이 조작을 사용할 권한이 없어요가 나에게만 보이게 뜹니다. 카드는 그대로예요.
맨 끝의 링크 버튼은 웹 대시보드로 가는 버튼입니다.
NOTE
이 버튼은 라벨이 한국어 대신 dashboard_button 이라는 영문으로 보여요. 눌렀을 때 대시보드로 이동하는 동작은 정상이니 라벨은 신경 쓰지 않아도 됩니다. 대시보드는 브라우저에 주소를 직접 입력해서 들어가도 같은 곳이에요 — 웹 대시보드 시작하기 참고.
버튼이 회색(비활성)일 때
눌리지 않는 버튼은 이유가 정해져 있어요.
| 상황 | 회색이 되는 버튼 |
|---|---|
| 재생 중인 곡이 없다 (정지했거나, 대기열이 끝났거나, 음성 연결이 끊겼다) | ⏮️ ⏸️ ⏹️ ⏭️ 🔊 |
| 이전에 재생한 곡이 하나도 없다 | ⏮️ 만 |
| 재생 중인 곡도 없고 대기열도 비었다 | 📜 까지 포함해 전부 |
즉 버튼 다섯 개가 한꺼번에 회색이면 지금 아무것도 재생하고 있지 않다는 뜻이에요. 곡을 넣으면 카드가 자동으로 살아납니다. 링크 버튼만은 항상 눌려요.
일시정지 중에는 버튼이 회색이 되지 않습니다. 일시정지도 "재생 중인 곡이 있는" 상태로 쳐요.
회색이 아닌데도 버튼이 안 먹을 때
카드는 남아 있는데 봇이 재시작됐거나 이미 채널에서 나간 경우가 있어요. 이때 버튼을 누르면 ❌ 지금 재생 중인 곡이 없어요 가 나옵니다. /재생 으로 다시 시작하면 카드도 새로 맞춰져요.
⏭️ 를 눌렀는데 대기열에 다음 곡이 없어요 가 뜨면 정말로 다음 곡이 없는 겁니다. ⏮️ 에서 ❌ 이전 곡이 없어요 도 마찬가지예요. 이전 곡 기록은 최대 25곡까지만 남습니다.
🔊 볼륨 입력창
🔊 를 누르면 볼륨 설정 이라는 작은 입력창이 떠요.
- 입력 칸 이름은
볼륨 (0-100)이고, 열릴 때 현재 볼륨이 미리 채워져 있습니다. - 세 자리까지만 입력할 수 있어요.
- 0에서 100 사이 정수가 아니면
❌ 0부터 100 사이의 값을 입력해주세요가 나오고 볼륨은 바뀌지 않습니다. - 성공하면
🔊 볼륨을 60%로 설정했어요처럼 나에게만 보이게 확인이 와요.
TIP
새로 추가된 서버의 시작 볼륨은 8% 입니다. "소리가 안 들린다"는 대부분 이것이니 처음 한 번은 올려 두세요. 바꾼 값은 서버에 저장돼 다음에도 유지됩니다.
같은 일을 명령으로도 할 수 있어요. /볼륨 값:60 이 이 입력창과 똑같이 동작합니다 — /볼륨 · /탐색 참고.
📜 대기열 버튼
누르면 대기열이 나에게만 보이는 메시지로 떠요. 채널에는 아무것도 남지 않으니 아무 때나 눌러도 됩니다. 내용은 /대기열 명령과 완전히 같아요. 앞 10곡까지만 나오는 등의 제약은 대기열 · 반복 · 섞기에서 설명합니다.
카드는 서버에 하나뿐이에요
컨트롤러는 서버당 한 개만 유지됩니다. 여러 채널에서 명령을 써도 카드가 여러 개 생기지 않아요.
- 같은 채널에 예전 컨트롤러가 남아 있으면 봇이 찾아서 지웁니다. 그래서 스크롤을 올려도 옛날 카드가 쌓여 있지 않아요.
- 카드가 있어야 할 채널이 바뀌면 새 채널에 카드를 만들고 원래 채널의 카드는 지웁니다. 카드가 "따라다니는" 것처럼 보이는 이유예요.
- 기본적으로 카드가 뜨는 곳은 봇을 처음 부른 텍스트 채널입니다. 서버 관리자가 특정 채널로 고정해 둔 경우에는 늘 그 채널에 떠요 (컨트롤러 메시지 채널 고정 · 통합).
NOTE
카드를 직접 지워도 괜찮아요. 다음 곡이 시작될 때 봇이 새로 만듭니다. 다만 지운 직후 잠깐은 조작할 카드가 없으니 그동안은 슬래시 명령을 쓰면 돼요.
빈 카드로 바뀌는 순간
아래 상황에서 카드는 곡 정보가 사라진 빈 카드(❌ 지금 재생 중인 곡이 없어요 + 대기열에 다음 곡이 없어요)로 바뀝니다.
- ⏹️ 를 누르거나
/정지를 썼을 때 - 대기열의 마지막 곡이 끝났을 때
- 봇이 음성 채널에서 나갔을 때
- 음성 연결이 끊겨 재생을 이어갈 수 없을 때
빈 카드가 됐다고 봇이 바로 나가는 건 아니에요. 나가는 조건은 봇이 저절로 멈추거나 나가는 경우에 정리돼 있습니다.
여러 봇이 붙어 있는 서버라면
프리미엄 서버에서는 음성 채널마다 다른 봇이 붙을 수 있어요. 이때 카드의 버튼은 그 카드를 띄운 봇의 재생을 조작합니다. 내가 있는 채널의 카드를 눌러야 의도한 대로 동작하고, 다른 채널의 카드를 누르면 그 채널의 재생이 바뀌니 주의하세요. 자세한 건 여러 채널에서 동시에 듣기(프리미엄)를 보세요.