User Guide

해당 컨트롤 패널은 BJ/스트리머가 방송 송출 중에 OBS 화면에 노출되는 여러 위젯들을 원클릭으로 간편하게 통제할 수 있도록 만든 '튜버 마스터 컨트롤러' 위젯입니다.

각 버튼의 상세한 기능, 특징, 목적 및 세팅 방법은 다음과 같습니다.

1. 🟢 초록색 눈 버튼: 위젯 일괄 표시 (Show All)
기능 및 특징: 대시보드에 활성화되어 있는 모든 개별 위젯들을 한 번에 방송 화면(OBS 브라우저 소스)에 **강제로 노출(On)**시키는 버튼입니다.
사용 목적: 방송 시작 시 혹은 개별적으로 꺼져 있던 다수의 위젯을 한꺼번에 활성화하여 송출하고 싶을 때 원클릭으로 편리하게 제어하기 위해 사용합니다. (단, VS 게이지, 룰렛, 타이머, 슬롯머신은 화면을 가리지 않도록 일괄 켜기 대상에서 자동 제외됩니다.)
세팅 방법: 별도의 환경 설정 없이 대시보드에서 클릭하는 즉시 전체 위젯이 화면에 노출됩니다.
2. 🔴 빨간색 눈 가리기 버튼: 위젯 일괄 숨기기 (Hide All)
기능 및 특징: 방송 화면에 띄워진 모든 위젯을 한 번에 비노출(Off) 상태로 숨깁니다.
사용 목적: 방송 도중 긴급히 개인 정보를 다루거나 화면 전환이 필요할 때, 혹은 방종/대기 화면 등 깨끗한 캠 화면만 단독 송출해야 할 때 단 한 번의 클릭으로 화면을 깨끗하게 정리할 수 있습니다.
세팅 방법: 클릭 즉시 실시간으로 모든 위젯이 숨겨집니다.
3. 🌙 초승달 버튼: 대시보드 테마 변경 (Theme Toggle)
기능 및 특징: 관리자가 보는 대시보드의 눈부심을 제어하기 위한 테마 스위치로, 3단계 테마 순환 모드를 지원합니다.
테마 순환 구조: ☀️ Light (라이트) ➔ 🌙 Dark (다크) ➔ ☁️ Dream (드림 비주얼) ➔ ☀️ Light
사용 목적: 야간 방송 시 눈의 피로를 최소화하기 위해 다크 모드로 전환하거나, 감성적이고 세련된 대시보드 룩을 연출하고 싶을 때 사용합니다.
세팅 방법: 클릭할 때마다 실시간으로 대시보드 배경 컬러가 순환합니다. 사용자가 고른 마지막 테마는 브라우저 로컬 스토리지(dashboard-theme)에 자동 기록되어 새로고침 하거나 재접속해도 그대로 보존됩니다.
4. ⌨️ 키보드 버튼: 위젯 단축키 설정 (Shortcut Settings)
기능 및 특징: 대시보드에 손을 대지 않고 키보드 단축키를 눌러서 타이머 시작/멈춤, 리액션 사운드 재생, 룰렛 돌리기 등 핵심 위젯 기능을 즉각 실행할 수 있게 맵핑해 주는 환경설정 제어판입니다.
사용 목적: 실시간 리액션 방송 및 엑셀 방송 시 마우스 클릭을 낭비하지 않고, 키보드 단축키(예: F1, F2 등)만으로 리얼타임 인터랙티브 리액션 장치를 컨트롤하기 위해 사용됩니다.
세팅 방법:
키보드 버튼을 클릭하면 단축키 설정 모달 팝업이 열립니다.
원하는 행동(액션) 옆의 지정 란을 누르고 사용하고자 하는 키보드 단축키를 입력합니다.
하단의 **[저장]**을 클릭하면 해당 단축키 정보가 서버(api/shortcut_action.php) DB에 저장되며 즉시 활성화됩니다.
5. 🔒 자물쇠 버튼: 대시보드 편집 잠금/해제 (Lock Layout)
기능 및 특징: 위젯 카드들의 배치 순서 변경(드래그 앤 드롭 정렬) 및 새로운 위젯의 추가/삭제 권한을 락(Lock)하는 보안 제어 버튼입니다.
사용 목적: 방송 조작 중에 마우스를 서둘러 움직이다가 실수로 위젯 카드를 드래그하여 순서가 뒤틀리거나 레이아웃이 깨지는 사고를 철저하게 미연에 차단하기 위해 사용합니다.
세팅 방법:
자물쇠 열림(🔓) 상태: 대시보드 편집 모드가 활성화되어 마우스로 위젯들의 순서를 자유롭게 드래그해서 바꾸거나 새 위젯 슬롯을 추가할 수 있습니다.
자물쇠 닫힘(🔒) 상태: 편집이 종료되어 마우스 드래그를 해도 움직이지 않도록 단단히 고정됩니다. (일반 방송 시에는 닫힘 상태로 두는 것을 추천합니다.)
6. 🏪 파란색 [상품/주문 관리] 버튼 (Shop Manager)
기능 및 특징: 시청자들이 볼 수 있는 후원 및 스토어 상품(아이템) 목록을 관리하고, 주문/정산 현황을 실시간으로 확인하는 개인 온라인 상점 쇼룸(Show Room) 관리자 웹페이지로 직행하는 버튼입니다.
사용 목적: 후원용 시그니처 아이템, 엑셀판 상품을 빠르게 등록 및 수정하고, 시청자들의 실시간 주문 정보를 체크하여 리액션 및 정산 관리를 진행하기 위해 사용됩니다.
세팅 방법: 버튼을 클릭하면 새 탭으로 상품/주문 관리 어드민 페이지(../show/index.php)가 팝업 형태로 열리며, 가입된 아이디의 고유 쇼룸을 세부 커스터마이징할 수 있습니다.