SR봇 ‐ 방송 음악 추천 플러그인 - auejin/vzzk-bot GitHub Wiki
SR봇(Song Request Bot)은 시청자가 방송 배경 음악을 신청할 수 있게 해주는 기능입니다. 시청자가 신청한 노래가 순서대로 재생됩니다.
기능 활성화하기
- VZZK에 네이버 로그인을 합니다.
- 콘솔 화면에서 SR봇 설정으로 이동합니다.
- SR봇 기능 활성화 토글을 켭니다.
[!NOTE] SR봇은 기본적으로 활성화되어 있습니다. 사용하지 않으시면 토글을 꺼두시면 됩니다.
플레이어 오버레이 (필수)
[!IMPORTANT] SR봇을 사용하려면 플레이어 오버레이를 반드시 OBS에 추가해야 합니다!
플레이어 오버레이가 노래를 실제로 재생하는 역할을 하기 때문에, OBS에 추가하지 않으면 음악이 재생되지 않습니다.
추가 방법
- SR봇 설정 페이지에서 SR 플레이어 오버레이 URL을 복사합니다.
- OBS에서 브라우저 소스를 추가합니다.
- 복사한 URL을 붙여넣습니다.
- 권장 크기: 너비 640px, 높이 360px (영상 표시 시)
[!TIP] 영상이 필요 없다면 크기를 작게 설정하고 화면 밖에 배치해도 됩니다. 음악 재생만 되면 OK!
정보 표시 오버레이 (선택)
시청자에게 현재 재생 중인 곡을 보여주고 싶다면 **SR 정보 오버레이(sr-info)**를 추가하세요. 이건 선택사항입니다.
설정
최대 노래 신청 횟수
한 사람이 대기 목록에 넣을 수 있는 노래 개수입니다.
0으로 설정하면 무제한입니다.- 관리자는 이 제한에 영향받지 않습니다.
최대 노래 길이 (분)
신청 가능한 최대 노래 길이를 분 단위로 설정합니다.
0으로 설정하면 무제한입니다.- 관리자는 이 제한에 영향받지 않습니다.
최소 신청 금액 (원)
0원: 채팅과 후원 모두로 노래 신청 가능1원 이상: 해당 금액 이상의 후원으로만 신청 가능- 관리자는 항상 채팅으로 신청 가능합니다.
볼륨
노래 재생 볼륨을 0~100 사이로 설정합니다. 설정한 볼륨은 자동 저장되어 VZZK을 다시 켜도 유지됩니다.
영상 표시
플레이어 오버레이에서 영상을 표시할지 여부를 설정합니다. 끄면 음성만 재생됩니다.
자동 재생 목록
아무도 음악을 신청하지 않았을 때 자동으로 재생할 음악 목록입니다. 여러 곡을 등록할 수 있습니다.
시청자 명령어
모든 시청자가 아래의 명령어를 사용할 수 있습니다.
| 명령어 | 설명 |
|---|---|
!cs |
현재 재생 중인 노래 정보 확인 |
!sr [URL 또는 검색어] |
노래 신청 (유튜브 URL 또는 검색어) |
!sr delete 또는 !sr remove |
자신이 신청한 가장 최근 노래 취소 |
!sr clear 또는 !sr purge |
자신이 신청한 모든 노래 취소 |
[!TIP]
!sr 아이유 밤편지처럼 검색어를 입력하면 유튜브에서 자동으로 검색하여 첫 번째 결과를 재생합니다.
관리자 전용 명령어
관리자로 등록된 계정만 사용할 수 있는 명령어입니다.
| 명령어 | 설명 |
|---|---|
!sr skip |
현재 노래 건너뛰기 |
!sr stop 또는 !sr pause |
일시정지 |
!sr play 또는 !sr resume |
재생 재개 |
!sr delete |
가장 최근 신청곡 삭제 (관리자는 모든 신청곡 삭제 가능) |
!sr clear |
대기열의 모든 신청곡 삭제 |
[!NOTE] 신청곡을 삭제하거나 스킵하면 채팅으로 알림이 가므로 신중하게 사용해주세요.
신청곡 관리
SR봇 설정 페이지의 대기열 탭에서 신청곡을 관리할 수 있습니다.
- 각 신청곡의 더보기 버튼을 눌러 순서 변경 또는 삭제 가능
- 신청곡을 드래그 앤 드롭으로 순서 변경 가능
- 수동으로 URL을 입력하여 곡 추가 가능
방송 오버레이
현재 재생 중인 신청곡을 시청자에게 보여주고 싶다면 **정보 오버레이(sr-info)**를 추가하세요.
오버레이의 가로 세로 비율에 따라 보이는 정보가 달라집니다:
- 너비 > 높이 × 2: 현재곡만 표시
- 높이 × 2 > 너비 > 높이: 현재곡 + 다음 곡 표시
- 너비 < 높이: 현재곡 + 전체 대기열 표시
OBS에서 방송 오버레이를 추가하는 방법은 방송 오버레이 문서를 참고하세요.