투표 - auejin/vzzk-bot GitHub Wiki

투표 기능은 시청자가 채팅으로 원하는 선택지에 투표할 수 있는 기능입니다. 스트리머(또는 매니저)가 채팅 명령어 또는 설정 화면에서 투표를 시작하고 관리할 수 있습니다.

기능 활성화하기

1. VZZK에 네이버 로그인을 합니다.
2. 콘솔 화면에서 투표 설정으로 이동합니다.
3. 투표 기능 활성화 토글을 켭니다.

[!NOTE] 투표 기능은 기본적으로 활성화되어 있습니다. 사용하지 않으시면 토글을 꺼두시면 됩니다.

투표 시작하기

투표는 설정 화면이나 채팅 명령어 두 가지 방법으로 시작할 수 있습니다.

설정 화면에서 시작하기

1. 콘솔 화면에서 투표 설정으로 이동합니다.
2. 투표 항목을 쉼표(,)로 구분하여 입력합니다. (예: 항목A, 항목B, 항목C)
3. 🗳️ 투표 시작 버튼을 클릭합니다.
4. 투표가 시작되면 투표 관리 다이얼로그가 자동으로 열립니다.

[!TIP] 설정 화면에서 투표를 시작하면 다이얼로그에서 실시간 현황을 바로 확인할 수 있어 편리합니다.

채팅으로 시작하기

채팅창에 아래 명령어를 입력하면 투표가 시작됩니다.

!투표시작 항목A, 항목B, 항목C

• 항목은 쉼표(,)로 구분합니다.
• 최대 9개까지 등록할 수 있습니다.
• 스트리머 또는 매니저만 투표를 시작할 수 있습니다.

투표가 시작되면 채팅에 "🗳️ 투표 시작! 번호를 입력해주세요!" 메시지가 표시됩니다.

투표 참여 방법

시청자는 투표 항목의 번호(1~9)를 채팅에 입력하면 해당 항목에 투표됩니다.

• 항목은 입력한 순서대로 1부터 번호가 부여됩니다.
• 이미 투표한 시청자가 다른 번호를 입력하면 투표가 변경됩니다.
• 투표는 시작 후 종료 전까지만 가능합니다.

투표 관리 다이얼로그

투표가 진행 중일 때 설정 화면에서 투표 관리 버튼을 클릭하면 다이얼로그가 열립니다.

투표 진행 중

• 참여자 수가 실시간으로 표시됩니다.
• 각 항목의 득표수와 비율이 막대 그래프로 표시되어 현황을 한눈에 볼 수 있습니다.
• 투표 종료 버튼을 클릭하면 투표가 종료됩니다.

투표 결과

• 투표가 종료되면 항목이 득표순으로 정렬되어 순위가 표시됩니다.
• 1등 항목은 🏆 아이콘으로 하이라이트됩니다.
• 다시 투표 버튼을 클릭하면 같은 항목으로 투표를 다시 시작할 수 있습니다.

투표 → 추첨 연계

[!TIP] 투표 결과에서 "1등 투표자 중 추첨" 버튼을 클릭하면, 1등 항목에 투표한 시청자 중 무작위로 1명을 추첨할 수 있습니다. 공동 1등이 있을 경우 "공동 1등 투표자 중 추첨"으로 표시됩니다.

이 기능은 예를 들어 **"이벤트 정답 맞추기"**처럼, 정답을 맞힌 시청자 중 당첨자를 뽑고 싶을 때 유용합니다.

투표 종료하기

채팅창에 아래 명령어를 입력하면 투표가 종료됩니다.

!투표끝

또는 !투표종료도 사용 가능합니다.

투표가 종료되면 채팅에 "🗳️ 투표 끝!" 메시지가 표시됩니다.

다시 투표하기

투표가 종료된 후, 같은 항목으로 다시 투표를 시작하고 싶다면 채팅 명령어를 사용할 수 있습니다.

!다시투표

또는 !재투표도 사용 가능합니다.

• 이전 투표와 동일한 항목으로 새 투표가 시작됩니다.
• 이전 투표 기록이 없으면 에러 메시지가 표시됩니다.
• 투표가 진행 중일 때는 사용할 수 없습니다.

명령어 정리

명령어	사용자	설명
!투표시작 옵션1, 옵션2, ...	스트리머/매니저	투표 시작
!투표끝 또는 !투표종료	스트리머/매니저	투표 종료
!다시투표 또는 !재투표	스트리머/매니저	같은 항목으로 투표 다시 시작
1 ~ 9	모든 시청자	해당 번호 항목에 투표

방송 오버레이

투표 현황과 결과를 방송 화면에 실시간으로 보여주고 싶다면 방송 오버레이를 사용하세요!

OBS에 오버레이를 추가하면:

• 시청자가 어떤 번호를 입력해야 하는지 알 수 있어요
• 실시간 투표 현황이 화면에 표시돼요
• 투표 종료 시 결과가 자동으로 나타나요

OBS에서 방송 오버레이를 추가하는 방법은 방송 오버레이 문서를 참고하세요.