(백업 경로) Firebase 콘솔 → Firestore → admins 컬렉션에 이 UID 로
문서를 만들어도 됩니다 — 절차는 HANDOFF 참조
반주의 박 위치(격자)가 어긋날 때만 — 노트 편집과 별개 층
클릭이 반주보다 먼저면 +, 늦으면 -
밀림 0박
자동 지도가 다 틀린 곡용 — 재생하며 매 박 F키 (첫 탭 = 덩)
3초 카운트 뒤 재생 — 치면 그 자리에 노트가 들어갑니다 (친 구간만 교체)
박자 맞추기 저장은 즉시 이 기기에 반영되고, 다른 기기는 다음 접속 때 반영됩니다.
우선순위: 관리자 저장(클라우드) → 파일(minyo_sync.json) → 내장값.
표시 ◈ = 박자 보정 적용 중 · ✎ = 노트 편집본 적용 중.
예비박 4똑 뒤 한 사이클을 실기기나 키보드(F=궁 J=따 스페이스=쿵, 동시 = 덩·열편덩)로 치면 타점이 됩니다 — 기존 타점은 지워지고 새로 채워집니다
저장 즉시 반영 (◈ = 클라우드 보정 적용 중) ·
빠르기는 나무 기준 — 새싹 70%·씨앗 50% 자동 (발주 2026-08-22 / 기준값 휘모리·세마치 80 / 굿거리 57 / 중모리 56)
🖱 정간보 조작법 — 장단 패턴 · 민요 반주 · 월드 리듬 공통· 빈 곳 클릭 = 선택한 구음 배치 (1/6박 스냅)· 칩 클릭 = 세기 순환 (기본 → 강 → 중 → 약 → 기본)· 칩 드래그 = 이동 (1/6박 스냅) · 🧽 지우개 선택 후 칩 클릭 = 삭제· 세기 기본값: 덩·열편덩 강 / 궁·쿵 중 / 따 약 · 구음은 덩/궁/따/쿵/열편덩 5종· 장단 패턴: 왼쪽→오른쪽 진행 · 가는 선 = 1/3박 · 점선 = 1/2박 · 같은 자리에 같은 손 타점은 겹칠 수 없음· 장단 패턴 [🥁 타격으로 입력] = 예비박 4똑 뒤 한 사이클을 실기기·키보드로 쳐서 타점 생성 (세기는 실기기만 · 1/6박 스냅 · 동시 타격 = 덩/열편덩)· 민요·월드: 왼쪽→오른쪽 흐름, 금색 세로선 = 현재 재생 위치 · 굵은 금색 박 선 = 덩(사이클 시작) · 위 줄 = 정박 / 아래 줄 = 잔가락· 민요·월드: 위쪽 박 번호 줄 클릭 = 재생 위치 이동 · 빈 곳 휠/드래그 = 곡 훑어보기· 민요·월드 [🥁 타격으로 입력] = 3초 카운트 뒤 그 자리에서 2초 되감아 재생하며 친 타격을 노트로 기록 (카운트·되감은 구간은 소리만) · 끝내면 친 구간의 기존 노트만 교체· 민요·월드: 정간보는 음원 시작(전주)부터 그려집니다 — 전주 구간은 흐린 격자이고 박 번호가 0보다 작습니다(0박 = 첫 박). 전주에도 노트를 넣을 수 있습니다· [🧹 비우고 새로 쓰기] = 지금 보고 있는 것(장단 패턴은 그 가락 / 민요·월드는 그 난이도)의 타점을 모두 지우고 빈 정간보에서 시작 — 저장 전이면 되돌리기로 복구됩니다· 💾 저장 버튼을 눌러야 전 기기에 반영됩니다
기기 정책 — 저장하면 전 기기에 즉시 반영선생님·관리자는 로그인하면 통과합니다.
박자 보정·타격으로 입력·사물놀이 모드·장단 메이커 녹음은 그대로 동작합니다.
⚠️ iOS(아이패드)는 웹 표준 미지원으로 전자장구를 연결할 수 없습니다 —
기기 필수 모드를 켜면 아이패드에서는 들어올 수 없습니다.
전자장구로 각 부위를 타격하면 해당 칸이 켜집니다.
기기 없이 화면만 확인하려면 칸을 클릭하세요.
궁
좌측 궁편 · G
따
우측 채편 · C
쿵
우측 열편 · K
덩
궁 + 따 (양손) · D
열편덩
쿵 + 따 (우측 양타) · Y
복합(덩/열편덩)이 안 켜지고 단타 두 칸만 켜지면 —
신형 펌웨어면 기기 분류 문제, 구형이면 두 신호의 간격이 90ms 를 넘는 것입니다.
채택하면 게임 모드 › 유저 장단 모드에 공개됩니다
해제 = 다시 대기 상태로(비공개) · 삭제 = 완전히 제거
승인하면 그 계정이 즉시 관리자가 됩니다 (승인자·시각이 기록됩니다)
해제하면 그 계정은 관리자 모드에 들어올 수 없게 됩니다 —
자기 자신은 해제할 수 없습니다 (실수로 아무도 못 들어가게 되는 것 방지)
🎧 음원 분석 — 빠르기·첫박 자동 측정
빠르기·첫박·길이는 엑셀에 적지 않습니다 — 앱이 직접 재서 여기에 저장하고,
모든 기기가 그 값을 읽어 씁니다 (배포 없이 즉시 반영).
엑셀에는 파일·제목·지역·장단만 적으면 됩니다.
① 음원과 엑셀을 넣고 배포하면 아래에 「아직 재지 않은 곡」이 뜹니다 →
[🎧 자동 분석] 한 번이면 전부 잽니다.
② [▶ 확인]으로 딱딱 소리와 함께 들어 보고, 어긋나면 다른 후보나
◀박 / ◀½ / − +, 그래도 안 맞으면 재생 중 [👆 박 맞추기]를 박에 맞춰 4번 이상.
③ [☁ 분석값 저장] 을 누르면 끝납니다.
저장하면 모든 기기에 바로 반영됩니다
(배포하지 않아도 됩니다)
음원 파일(mp3·wav)의 교체·추가는 무료 요금제에 파일 저장소가 없어
웹 화면에서는 불가능합니다 — 아래 절차로 PC에서 반영합니다.
① 파일을 public\sounds\bgm\ 등 해당 폴더에 넣는다
(기존 곡 교체는 같은 파일명으로 덮어쓰기)
· 장구 음원 세트: public\sounds\janggu\samulnori\ /
jangdan\ / byeolsingut\ 폴더에
gung_hard.wav · chae_hard.wav · kung_hard.wav 3개를 넣으면 메인 [⚙️ 설정] → [🥁 장구 음원]에서 선택 가능
· 곡·악기 목록에 등록:
public\sounds\음원목록.xlsx 를 엑셀로 열어
해당 시트(월드 리듬 / 창작 국악 / 민요 반주 / 장구 세트 / 악기)에 한 줄 적고 저장
· 적는 것은 파일·제목·지역·장단뿐입니다 —
빠르기·첫박·길이는 위의 [🎧 자동 분석]이 재서 저장합니다
· 회색 예시 줄은 맨 앞이 #(무시됨) — # 만 지우면 실제 항목이 됩니다.
· 폴더별 목록 파일(world_list.csv/.json 등)도 그대로 쓸 수 있습니다 —
앱이 모두 읽어 합칩니다.
② 인수 패키지의 배포_실행.bat 더블클릭
(처음 한 번만 Node.js 설치·Google 로그인)
③ 1~2분 뒤 사이트에 반영 (안 보이면 Ctrl+F5 새로고침)
· 싱크·패턴 보정은 이 관리자 모드에서 바로 저장되므로 배포가 필요 없습니다.
· 무료 전송 한도는 월 10GB — 새 곡을 처음 여는 기기 수에 비례해 소모됩니다.
· 상세 절차·용량 절약(Audacity 96kbps)·버전 보존 설정은 HANDOFF 문서 §3-1 참조.
학습 모드
SMART INSTRUMENT PORTAL
장단 패턴 모드
민요 반주 모드
사물놀이 모드
사물놀이 모드
FREE PLAY
악기를 고르고 자유롭게 쳐 보세요 — 노트·판정 없이 타격마다 소리가 납니다.
따(채편) 타격에만 소리가 나요.
좌측 궁편 · F
따 음을 대체합니다
우측 열편 · 스페이스
궁 + 따 (F+J 동시)
쿵 + 따 (스페이스+J 동시)
장단 패턴 모드
JANGDAN PATTERN
카드를 좌우로 밀거나 ◀ ▶ 로 장단을 고르고, 카드를 누르면 난이도를 선택합니다
▼ 가락 선택
▼ 난이도 선택
민요 반주 모드
MINYO ACCOMPANIMENT
실제 국악 반주에 맞춰 장단을 칩니다 — 기본 장단부터 익히고, 응용 장단(강약·잔가락)에 도전하세요
