음악

설명

사용자 가이드

음성 채널용 오디오 플레이어입니다. 봇이 여러분의 채널에 들어와 대기열의 트랙을 연달아 재생하고 현재 재생 중인 곡을 알려 줍니다. 모든 멤버가 사용할 수 있습니다.

기능

• 여러분이 있는 음성 채널에 들어와 재생을 시작합니다.
• 요청을 서버별 대기열에 차례로 쌓습니다.
• 명령어 하나로 플레이리스트 전체를 추가합니다.
• 요청이 이루어진 채널에 각 트랙 정보(제목, 작성자, 썸네일)를 알립니다.
• 건너뛰기, 일시정지, 다시 재생, 정지, 볼륨 조절을 지원합니다.
• 대기열이 비면 자동으로 음성 채널에서 나갑니다.

빠른 시작(관리자)

1. 별도의 구성은 필요하지 않습니다. 봇이 서버에 있으면 모듈이 바로 준비됩니다.
2. 봇이 해당 음성 채널에 연결하고 말하기를 할 수 있는지 확인하세요.
3. 음성 채널에 들어간 뒤 곡 제목이나 링크와 함께 /music play를 실행하세요.
4. 재생을 특정 멤버에게만 허용하려면 Discord의 서버 설정 → 연동에서 /music 명령어 사용을 제한하세요.

명령어

명령어	설명
/music play	트랙을 재생하거나 대기열에 추가(검색할 제목 또는 링크).
/music skip	다음 트랙으로 넘어감.
/music pause	재생 일시정지.
/music resume	재생 다시 시작.
/music stop	재생 정지, 대기열 비우기, 봇 연결 해제.
/music queue	대기열 표시.
/music volume	볼륨 조절(0~100).

대시보드 설정

이 모듈에는 대시보드 페이지가 없습니다. 위 명령어로만 조작합니다.

알아두면 좋은 점

• 이 모듈은 외부 오디오 서비스(Lavalink 서버)에 의존하며, 해당 서비스가 실행 중이고 봇이 접근할 수 있어야 합니다. 사용할 수 없는 경우 /music play는 「음악 서비스를 현재 이용할 수 없습니다」라고 응답하며, 다른 명령어는 모두 아무 동작도 하지 않습니다.
• /music play를 실행하려면 음성 채널에 들어가 있어야 합니다. 봇은 여러분이 있는 채널로 들어옵니다.
• 텍스트 검색은 SoundCloud를 조회합니다. 특정 출처를 원하면 링크를 직접 붙여넣으세요. 그러면 해당 링크가 그대로 처리됩니다.
• 플레이리스트 링크를 붙여넣으면 모든 트랙이 한 번에 대기열에 추가됩니다.
• 대기열은 서버 전체가 공유합니다. 대기열은 하나뿐이며, 볼륨도 각 청취자가 아니라 플레이어 전체에 적용됩니다.
• /music queue는 처음 10개 트랙만 표시하고, 그 뒤에 남은 곡 수를 알려 줍니다.
• 「재생 중」 알림은 마지막 /music play 명령어가 실행된 텍스트 채널로 전송됩니다.
• 검색 결과에 나타나더라도 재생할 수 없는 트랙이 있습니다(수익화 콘텐츠, 제한된 콘텐츠, 지역 차단). 봇이 이를 알리고 자동으로 다음 곡으로 넘어갑니다.
• 대기열이 비면 봇이 스스로 연결을 해제합니다. 다시 불러오려면 /music play를 다시 실행해야 합니다.
• 반복 재생, 무작위 재생, 특정 트랙만 대기열에서 제거하는 기능은 없습니다. /music skip 또는 /music stop을 사용하세요.