BuzzBuild-OnAir — 사용법

설치를 마친 플레이어를 위한 소스 기반 절차입니다. 게임 내 동작은 미검증입니다.

자신의 방송 연결하기

1. /방송연동으로 화면을 엽니다.
2. 치지직·SOOP·씨미·투네이션 중 연결할 플랫폼을 선택합니다.
3. 연결정보 설정을 열고 채널 ID·주소 또는 투네이션 알림창 정보를 입력합니다. 허용 형식은 설정을 확인하세요.
4. 저장 후 연결을 누릅니다. 저장만 선택했다면 설정 창이 닫힌 후 연결을 누릅니다.
5. 상태가 CONNECTED(연결됨)인지 확인하고 실제 수신 내역이 들어오는지 확인합니다. 저장 성공은 방송 연결 성공을 뜻하지 않습니다.

기존 등록값은 입력창에 다시 표시되지 않습니다. 투네이션 입력은 기본적으로 숨겨지며 보기 버튼으로 표시를 전환합니다. 붙여넣기는 입력창에 초점을 둔 뒤 Ctrl+V 또는 Shift+Insert를 사용합니다.

수신 내역 확인하기

1. 전체, 채팅, 후원 필터로 종류를 선택합니다.
2. 검색창에서 시청자 이름 또는 메시지 내용을 검색합니다.
3. 후원 금액·단위를 확인하고, SUCCESS가 아닌 후원은 추가 상태 표시도 확인합니다.

검색 대상은 보관된 최근 내역입니다. 서버는 플레이어별 채팅 20개와 후원 20개를 메모리에 보관합니다. 전송 크기 제한으로 화면에는 더 적게 전달될 수 있습니다. 화면용 이름은 최대 32 코드 포인트, 메시지는 240 코드 포인트로 줄입니다. 재접속이나 플러그인 비활성화 후 과거 내역을 복구하는 기능은 없습니다.

플랫폼 카드 선택은 연결 조작 대상을 바꿉니다. 수신 목록을 해당 플랫폼만으로 필터링하지는 않습니다. 상단의 연결됨 / 4 표시는 연결된 플랫폼 수이며 채널 수가 아닙니다. 복수 채널 수는 /방송연동 상태에서 확인합니다.

연결 바꾸기와 화면 닫기

1. 해당 플랫폼에서 연결 해제를 누르고 해제가 끝날 때까지 기다립니다.
2. 연결정보 설정에 새 값을 입력해 저장합니다.
3. 다시 연결합니다. 추가 입력이 있으면 같은 플랫폼의 추가 채널도 함께 연결됩니다.

닫기 버튼 또는 ESC로 화면을 닫습니다. 설정 창이 열려 있다면 ESC는 설정 창을 먼저 닫습니다. 입력 중이 아닐 때 E로도 대시보드를 닫을 수 있습니다.

화면을 닫아도 방송 연결은 유지됩니다. 수신을 멈추려면 연결 해제를 사용하세요. 로그아웃, 권한 회수, OnAir 리로드·비활성화 시 연결을 정리합니다. 화면을 계속 열어 둔 상태에서 30분 세션이 만료되어도 연결이 해제됩니다. 방송 종료·오류 후 자동 재접속은 비활성화되어 있으므로 상태를 확인하고 다시 연결합니다.

관리자 테스트

1. buzzbuild.onair.use와 buzzbuild.onair.admin이 있는 계정으로 화면을 엽니다.
2. 테스트 수신을 누릅니다.
3. 치지직 샘플 채팅과 투네이션 샘플 후원에 테스트 표시가 붙는지 확인합니다.

이 조작은 외부 방송 접속을 시험하지 않습니다. 보상을 지급하거나 OnAirDonationEvent를 발행하지 않으므로 실제 후원 통계 연동 확인을 대신할 수 없습니다.

자동 연결·추가 채널 운영

관리자는 서버 설정에서 플레이어별 additional-inputs와 auto-connect를 지정할 수 있습니다. 파일 변경을 적용한 후 연결 버튼으로 재연결하고 /방송연동 상태의 연결 수를 확인합니다. 다음 접속부터 auto-connect: true인 플랫폼에 연결을 시도합니다. 자세한 예시는 설정을 참고하세요.

후원 통계 연동

실제 후원 수신 시 소유 플레이어 UUID·플랫폼·단위·상태·금액을 담은 이벤트를 발행합니다. Insight에는 성공 상태의 양수 후원을 집계하는 수신 코드가 있습니다. OnAir 화면은 정산 장부가 아니며, Insight의 로드 순서와 실제 집계 결과는 별도 검증이 필요합니다.

확인 범위

2026-10-05 기준 서버 동작, 클라이언트 입력 전달, 웹 버튼·필터·검색과 이벤트 발행·수신 코드를 대조했습니다. 외부 플랫폼 수신과 화면 조작의 실제 성공 여부는 확인하지 않았습니다.