빠른 시작 가이드
시청자들이 유튜브에서 노래를 검색해서 신청할 수 있는 기능이에요! 신청곡 변수를 사용해서 나만의 신청곡 명령어를 만들 수 있어요.
신청곡 기능은 대시보드에서 활성화해야 사용할 수 있어요.
방송 중에만 가능
신청곡 관련 변수는 대부분 방송 중에만 동작해요.
방송 중이 아니면 방송중이 아닙니다. 조회는 방송 중에만 가능합니다.가 출력돼요.
신청곡 명령어 만들기
신청곡 기능을 사용하려면 $song-requests 변수를 사용해요.
!추가 [원하는명령어] $song-requests
명령어 이름은 자유롭게!
!sr, !노래신청, !신청 등 원하는 이름으로 만들 수 있어요!
예시:
!추가 !sr $song-requests→!sr 노래제목으로 신청!추가 !노래신청 $song-requests→!노래신청 노래제목으로 신청!추가 !신청 $song-requests→!신청 노래제목으로 신청
신청곡 변수
$song-requests - 신청곡 기능
$song-requests신청곡 기능을 활성화합니다. 시청자가 검색어나 URL로 노래를 신청할 수 있어요.
!추가 !sr $song-requests!sr 린 Overdose신청이 완료되었습니다: Overdose (なとり) / 아오쿠모 린 (Aokumo Rin) Cover$song-current - 현재 곡
$song-current현재 재생 중인 곡 제목을 출력합니다.
!추가 !지금 신청곡: $song-current!지금신청곡: 첫사랑 ( 백아 ) / 아라하시 타비 Cover$song-link - 현재 곡 링크
$song-link현재 재생 중인 곡의 유튜브 링크를 출력합니다.
!추가 !링크 $song-link!링크https://youtu.be/HBoqsgRoDw4$song-next - 다음 곡
$song-next다음에 재생될 곡 제목을 출력합니다.
!추가 !다음곡 다음곡: $song-next!다음곡다음곡: Overdose (なとり) / 아오쿠모 린 (Aokumo Rin) Cover$song-count - 남은 곡 수
$song-count대기열에 남은 곡 수를 출력합니다.
!추가 !대기 남은 곡: $song-count곡!대기남은 곡: 5곡예시: 종합 신청곡 정보
여러 변수를 조합해서 자세한 정보를 보여줄 수 있어요!
!추가 !노래 신청곡: $song-current ($song-link) / $song-count곡 남음.
결과: 신청곡: 첫사랑 ( 백아 ) / 아라하시 타비 Cover (https://youtu.be/HBoqsgRoDw4) / 2곡 남음.
신청곡 설정하기
대시보드 접속
뚜봇 대시보드에 로그인합니다.
노래 신청 메뉴 선택
좌측 메뉴에서 '노래 신청' 항목을 클릭합니다.
기능 활성화
'노래 신청 활성화' 토글을 켭니다.
옵션 설정
다음 옵션들을 설정할 수 있어요:
- 최대 대기열: 동시에 대기할 수 있는 최대 곡 수
- 최대 길이: 신청 가능한 노래의 최대 길이 (분)
- 중복 허용: 같은 노래를 여러 번 신청할 수 있는지 여부
- 1인당 제한: 한 시청자가 신청할 수 있는 최대 곡 수
저장
설정을 완료하면 '저장' 버튼을 클릭합니다.
관리용 변수
신청곡을 관리하기 위한 변수들이에요. 직접 명령어를 만들어서 사용하세요!
$song-skip - 곡 스킵
$song-skip현재 재생 중인 곡을 건너뜁니다.
!추가 !스킵 $song-skip마지막남은뚜또: !스킵'첫사랑 ( 백아 ) / 아라하시 타비 Cover' 노래를 스킵했습니다.$song-time - 현재 곡 길이
$song-time현재 재생 중인 곡의 길이를 출력합니다.
!추가 !곡길이 현재 곡 길이: $song-time마지막남은뚜또: !곡길이현재 곡 길이: 03:42$song-total-time - 전체 대기열 길이
$song-total-time대기열에 있는 모든 곡의 총 길이를 출력합니다.
!추가 !총길이 남은 신청곡 길이: $song-total-time마지막남은뚜또: !총길이남은 신청곡 길이: 15:30$song-remaining-limit-per-user - 개인 남은 신청 횟수
$song-remaining-limit-per-user내가 추가로 신청할 수 있는 곡 수를 출력합니다.
!추가 !남은신청 남은 신청 가능: $song-remaining-limit-per-user곡마지막남은뚜또: !남은신청남은 신청 가능: 2곡$song-remaining-limit-total - 전체 남은 신청 가능 수
$song-remaining-limit-total대기열에 추가로 들어갈 수 있는 곡 수를 출력합니다.
!추가 !대기열여유 대기열 여유: $song-remaining-limit-total곡마지막남은뚜또: !대기열여유대기열 여유: 15곡관리 명령어 예시
관리용 명령어를 직접 만들어서 사용하세요!
곡 스킵 명령어
!추가 !스킵 $song-skip
매니저가 !스킵을 입력하면 현재 곡이 건너뛰어져요.
신청곡 정보 명령어
!추가 !신청곡 🎵 $song-current | 다음: $song-next | 남은 곡: $song-count
현재 재생 중인 곡과 다음 곡, 남은 곡 수를 한 번에 확인할 수 있어요.
신청 가능 여부 확인
!추가 !신청가능 대기열 여유: $song-remaining-limit-total곡 / 내 남은 신청: $song-remaining-limit-per-user곡
에러 응답
| 상황 | 응답 |
|---|---|
| 방송 중이 아님 | 방송중이 아닙니다. 조회는 방송 중에만 가능합니다. |
| 신청곡 기능 비활성화 | 기능이 꺼져있습니다. |
| 대기열 가득 참 | 대기열이 가득 찼습니다. |
| 개인 신청 제한 초과 | 신청 제한을 초과했습니다. |
| 중복 신청 (중복 허용 안함) | 이미 신청된 곡입니다. |
| 곡 길이 초과 | 곡 길이가 너무 깁니다. |
| 검색 결과 없음 | 검색 결과가 없습니다. |
| 현재 곡 없음 | 현재 재생중인 곡이 없습니다. |
| 다음 곡 없음 | 다음 곡이 없습니다. |
오버레이 활용
신청곡 현황을 방송 화면에 표시하려면 오버레이를 활용하세요.
다음 단계
신청곡 설정이 완료되었다면, 시청자 참여 기능도 확인해보세요.