음악
음악 기능은 서버의 음성 채널에서 함께 음악을 듣고 큐를 관리하는 기능이에요. 재생 명령, 공개 플레이어, DJ 권한, 음악 노드 상태를 함께 봐야 안정적으로 운영할 수 있어요.
무엇을 할 수 있나요?
| 기능 | 설명 |
|---|---|
| 재생 | 검색어나 링크로 음악을 재생해요 |
| 큐 | 다음 곡 목록을 보고 순서를 관리해요 |
| 제어 | 일시정지, 재개, 스킵, 정지 같은 동작을 처리해요 |
| DJ 권한 | 스킵이나 정지 같은 제어 권한을 역할로 나눠요 |
| 공개 플레이어 | 현재 곡과 큐, 제어 버튼을 채팅 채널에 보여요 |
| 가사 | 가능한 경우 현재 곡의 가사를 찾아 보여요 |
지원되는 소스와 재생 안정성은 서버의 음악 런타임과 외부 플랫폼 상태에 따라 달라질 수 있어요. 모든 음악 플랫폼의 재생을 보장한다고 쓰면 안 돼요.
처음 설정하는 순서
- 음악 모듈을 켜요.
- 음악 명령을 사용할 채팅 채널을 정해요.
- 음악을 들을 음성 채널과 봇 입장 권한을 확인해요.
- DJ 역할을 정하고 일반 멤버가 할 수 있는 제어 범위를 나눠요.
- 공개 플레이어를 둘 채널을 정해요.
- 짧은 곡으로 재생, 스킵, 정지, 큐 확인을 테스트해요.
DJ 권한을 나눠요
작은 서버에서는 모든 멤버가 기본 제어를 해도 괜찮아요. 하지만 사람이 많은 서버에서는 DJ 역할을 만들어 스킵, 정지, 반복, 큐 정리 같은 동작을 맡기는 편이 좋아요.
권한을 나누면 누군가가 실수로 재생을 멈추거나 큐를 지우는 일을 줄일 수 있어요.
공개 플레이어를 사용해요
공개 플레이어는 채팅 채널에서 현재 곡, 진행 상태, 큐, 제어 버튼을 보여 주는 메시지예요. 멤버가 명령어를 몰라도 버튼으로 기본 동작을 사용할 수 있어요.
플레이어 메시지를 수동으로 삭제하면 다시 게시해야 할 수 있어요. 버튼이 동작하지 않으면 DJ 권한, 메시지 컴포넌트 상태, 봇 권한을 함께 확인해 주세요.
음악 노드 상태를 확인해요
음악 명령은 정상인데 재생이 실패한다면 설정 문제가 아니라 음악 노드나 외부 소스 문제일 수 있어요.
확인할 항목은 이렇게 나눠요.
- 봇이 음성 채널에 들어갈 수 있는지
- 음악 노드가 연결되어 있는지
- 검색 소스가 응답하는지
- 현재 세션이 꼬이지 않았는지
- 서버 네트워크나 외부 플랫폼 제한이 있는지
가사와 함께 쓰기
가사 기능은 재생 중인 곡 정보를 기준으로 가사를 찾아요. 곡 제목과 아티스트 정보가 정확할수록 결과가 좋아져요.
라이브 버전, 리믹스, 커버곡은 가사나 타이밍이 맞지 않을 수 있어요. 가사가 없거나 틀리면 곡 정보를 더 정확히 입력하거나 나중에 다시 시도해 주세요.
잘 안 되나요?
| 이런가요 | 이렇게 해 보세요 |
|---|---|
| 봇이 음성 채널에 안 들어와요 | 음성 채널 보기, 연결, 말하기 권한을 확인해요 |
| 재생이 시작되지 않아요 | 음악 노드 상태와 외부 소스 응답을 확인해요 |
| 아무나 스킵해요 | DJ 역할과 제어 권한을 조정해요 |
| 플레이어 버튼이 안 돼요 | 공개 플레이어 메시지와 버튼 권한을 확인해요 |
| 가사가 안 나와요 | 곡 제목, 아티스트, 지원 여부를 확인해요 |
캡처 기준
| 캡처 | 보여 줄 내용 |
|---|---|
| 음악 설정 | 모듈 상태, 채널 제한, DJ 역할 |
| 공개 플레이어 | 현재 곡, 큐, 재생 제어 버튼 |
| 큐 화면 | 대기열과 요청자 정보 |
| 오류 상태 | 노드 연결 실패나 권한 경고 |