SR봇 ‐ 방송 음악 추천 플러그인 - auejin/vzzk-bot GitHub Wiki
SR봇(Song Request Bot)은 시청자가 원하는 음악의 유튜브 URL이나 검색어를 채팅으로 신청하면, 방송 배경 음악으로 순서대로 자동 재생해 주는 기능입니다.
이렇게 활용해 보세요
- 시청자 참여형 라디오 방송: 시청자들이 자신이 좋아하는 곡을 신청하며 서로의 취향을 공유하고 소통할 수 있습니다.
- 스트리머의 오디오 스트레스 감소: 다음 브금(BGM)을 무엇을 틀지 직접 고민할 필요 없이 시청자들이 신청하는 곡으로 오디오를 꽉 채울 수 있습니다.
- 음악 신청 후원(치즈) 유도: VZZK Pro의 '최소 신청 금액' 기능을 설정하여 특정 금액(
1원 이상)의 치즈 후원을 했을 때만 곡을 신청받도록 하여, 스트리머의 주요 수익 모델로 활용할 수 있습니다.
시작하기 전에 (필수)
[!IMPORTANT] 플레이어 오버레이(sr-player)가 반드시 필요합니다! SR봇은 VZZK 앱 자체가 아니라 OBS에 띄워진 오버레이 화면(웹 브라우저)에서 음악을 실제로 재생합니다. 따라서 OBS에 '플레이어 오버레이'를 브라우저 소스로 추가하고 "OBS를 통해 오디오 제어" 옵션을 켜두지 않으면 음악이 재생되지 않습니다.
- 콘솔 화면에서 SR봇 설정으로 이동합니다.
- 설정 페이지 상단에 있는 SR 플레이어 오버레이 URL을 복사하여 OBS에 추가합니다. (음악만 틀 예정이라면 오버레이 크기를 아주 작게 하거나 화면 밖으로 밀어내도 됩니다)
- 시청자에게 현재 재생 중인 곡의 제목과 썸네일을 시각적으로 보여주고 싶다면 **SR 정보 오버레이(sr-info)**를 추가로 OBS에 띄웁니다.
시청자의 음악 신청 방법
시청자는 아래의 명령어만으로 손쉽게 곡을 신청하고 관리할 수 있습니다.
!sr또는!노래 [유튜브 링크 또는 노래 제목]: 곡 신청 (예:!노래 아이유 밤편지)!cs또는!노래: 현재 재생 중인 노래 정보 확인!sr delete: 자신이 신청한 곡 중 가장 최근 곡 1개 취소!sr clear: 자신이 신청한 모든 곡 취소
스트리머의 대기열 관리
SR봇 설정 화면의 대기열 탭에서 현재 재생 중인 곡과 앞으로 재생될 신청곡 목록을 시각적으로 관리할 수 있습니다.
- 곡 순서 변경: 화살표 버튼을 눌러 먼저 틀고 싶은 곡을 위로 올릴 수 있습니다.
- 자동 재생 목록(☆): 시청자의 신청이 없을 때 자동으로 셔플 재생될 예비 곡(브금 리스트)을 저장해 둘 수 있습니다. 마음에 드는 신청곡의 별(☆) 아이콘을 누르면 자동 재생 목록에 보관됩니다.
- 플레이어 조작: 재생/일시정지(▶/Ⅱ), 다음 곡 건너뛰기(⏭), 정지(■)를 클릭하여 직접 제어할 수 있습니다.
관리자용 제어 명령어
방송 도중 관리자(스트리머 및 매니저)는 채팅창에서 즉시 곡을 제어할 수 있습니다.
!sr skip: 현재 재생 중인 곡 건너뛰기!sr stop(또는!sr pause): 일시정지!sr play(또는!sr resume): 재생 재개!sr delete: 대기열의 가장 마지막 신청곡 1개 삭제!sr clear: 대기열 전체 초기화
노래책 (시청자와 함께 쓰는 노래 신청 대기열)
시청자가 직접 접속하여 대기열을 확인하고, 곡을 신청하거나 본인의 신청곡을 취소할 수 있는 웹 페이지를 제공합니다. 자세한 내용은 노래책 페이지를 참고해주세요.