bibimbap/docs/changes/2026-10-14-webgl-display.md

3.9 KiB
Raw Blame History

kind title owner stability last_reviewed
changes 업로드 빌드별 WebGL 플레이 화면 bibimbap stable 2026-10-14

업로드 빌드별 WebGL 플레이 화면

기존 상세 실행 영역은 16:9와 최대 높이 520px로 고정되어 세로 게임을 좁은 가로 영역에 넣었다. 이제 업로드한 빌드마다 선언된 기준 폭·높이를 감지·저장하고, 상세 플레이어가 가용 폭·높이 양쪽에 비율을 유지하여 맞춘다. 특정 예시 게임에 따른 크기 상수는 없다.

등록·수정에 자동/직접 지정 크기 설정이 추가되었다. 미확인 빌드는 자동 등록을 계속 허용하며 16:9 fallback을 사용한다. 기존 null 메타 게임은 파일에서 읽기 전용 감지하고 수정 시 교정할 수 있다. 크게 보기와 전체화면은 기존 iframe을 유지해 게임 재시작을 피한다. 전체화면 실패는 크게 보기로 전환한다. Unity 내부 레이아웃 재배치는 빌드 개발자의 영역이다.

추가 DB 마이그레이션은 20261014-game-display-metadata.sql이다. 배포 전 nullable 세 컬럼과 CHECK를 적용한다. 기존 행 백필·원본 ZIP/HTML 수정·앱 자동 DDL은 없다. 정적 감지는 안전한 선언 신호만 사용하며 JS style 대입은 지원하지 않는다. 전체 계약은 화면 메타, 운영 절차는 등록·실행 가이드에 있다.

2026-10-14 격리 검증에서 Java 21을 명시한 bash scripts/verify-webgl-display.sh all은 성공했다. Java 377건은 실패·오류 0, 일반 실행에서 opt-in L2 1건 skip이었다. Node 11/11과 WAR package가 통과했고, disposable PostgreSQL에서 별도로 활성화한 실제 MyBatis L2는 1/1 통과하여 생략하지 않았다. 등록·상세·수정 JSP 경로 5개가 인증 후 HTTP 200이었다.

실제 390×844 ZIP과 별도 이름의 1280×720·800×800 빌드에 대해 320×844, 1440×900, 844×390, 640×300 viewport 12/12가 stage 경계와 1px 이내 비율 조건을 통과했다. 실제 Unity instance는 준비 상태였으며 CSS client 크기와 drawing buffer를 구분해 기록했다(데스크톱 일반 291×630/582×1260, 전체화면 388×840/776×1680, 모바일 emulation 273×591/273×591). Resize·크게 보기·전체화면/복귀·API 거절 fallback 동안 같은 iframe DOM/src와 Unity instance를 유지하고 추가 load는 0이었다. 원본 ZIP 및 저장·HTTP 제공 entry HTML의 SHA-256은 변하지 않았다. 브라우저 console error와 앱 stacktrace는 없었다.

최종 정적 UI detect에서 기존 소개 패널 accent border와 숨겨진 thumbnail preview만 지적되었다. 후자는 src를 먼저 설정한 뒤 표시하므로 broken-image 오탐이다. 변경된 플레이어·크기 설정에서 확인된 새 UI 결함은 없었다. 실제 HEAD 이전 JSP를 임시 복사본에 대입한 동일 SSR regression은 실패(exit 1), 현재 JSP는 통과(exit 0)했다. 이는 markup 회귀 증거이며 이전 브라우저 geometry 실행 증거는 아니다.

보완 검증에서는 CDP touch 이벤트의 pointerType=touch, isTrusted=true와 실제 Unity 메뉴 전환을 함께 확인했다. 세로 일반 화면의 Shop, 가로 확대·resize 후 Open Upgrades가 입력 좌표에 맞게 전환되었고 같은 iframe/Unity 상태를 유지했다. 실제 물리 터치 기기의 스모크는 별도 사용자 확인 항목이다. 보완 검증 보고서, 최초 검증 보고서, 최종 문서·UI 감사에 근거와 한계를 남겼다. 재현 절차는 등록·실행 가이드에 있다. 공유·운영 DB 적용과 배포는 검증 harness에 포함하지 않는다.